@avasis-ai/synthcode weekly downloads statistics

<div align="center"> <pre> $$$$$$$\ $$\ $$\ $$$$$$\ $$\ $$ __$$\ $$ | $$ | $$ __$$\ $$ | $$ / \__|$$\ $$\ $$$$$$$\ $$$$$$\ $$$$$$$\ $$ / \__| $$$$$$\ $$$$$$$ | $$$$$$\ \$$$$$$\ $$ | $$ |$$ __$$\\_$$ _| $$ __$$\ $$ | $$ __$$\ $$ __$$ |$$ __$$\ \____$$\ $$ | $$ |$$ | $$ | $$ | $$ | $$ |$$ | $$ / $$ |$$ / $$ |$$$$$$$$ | $$\ $$ |$$ | $$ |$$ | $$ | $$ |$$\ $$ | $$ |$$ | $$\ $$ | $$ |$$ | $$ |$$ ____| \$$$$$$ |\$$$$$$$ |$$ | $$ | \$$$$ |$$ | $$ |\$$$$$$ |\$$$$$$ |\$$$$$$$ |\$$$$$$$\ \______/ \____$$ |\__| \__| \____/ \__| \__| \______/ \______/ \_______| \_______| $$\ $$ | \$$$$$$ | \______/ </pre> <br/> <h3>Neural Intuition x Symbolic Precision</h3> <p> <img src="https://img.shields.io/npm/v/@avasis-ai/synthcode-tui?color=%237c5cfc&label=TUI&style=for-the-badge" /> <img src="https://img.shields.io/npm/v/@avasis-ai/synthcode?color=%239b7dff&label=Framework&style=for-the-badge" /> <img src="https://img.shields.io/github/license/avasis-ai/synthcode?color=%23455a70&style=for-the-badge" /> <img src="https://img.shields.io/badge/tests-269_passing-%231D9E75?style=for-the-badge" /> </p> <p> A neurosymbolic coding platform. Six symbolic gates verify every LLM output in ~3-8ms.<br/> The terminal is the correct interface. </p> <br/> <img src="tui/assets/demo.gif" width="700" alt="SynthCode Demo" /> </div>

---

Install

# TUI -- the full experience
npx @avasis-ai/synthcode-tui@latest

# Framework -- programmatic API
bun add @avasis-ai/synthcode

Screenshots

<div align="center"> <table><tr> <td><img src="tui/assets/chat.svg" width="420" alt="Chat Mode" /></td> <td><img src="tui/assets/gate-trace.svg" width="420" alt="Gate Trace" /></td> </tr><tr> <td><img src="tui/assets/world-model.svg" width="420" alt="World Model" /></td> <td><img src="tui/assets/architecture.svg" width="420" alt="Architecture" /></td> </tr></table> </div>

The Six Gates

Gate	Verifies	Latency
Structure	AST well-formedness, syntax validity	~1ms
Scope	Variable bindings, lexical resolution	~2ms
Type	Type consistency, inference chains	~3ms
Safety	Side-effect boundaries, mutation control	~2ms
Control Flow	Reachability, termination guarantees	~3ms
Semantic	Logical coherence, intent alignment	~5ms

Features

• Dual-path verification -- neural output passes six symbolic gates before touching your codebase
• Zero-dependency framework -- 10KB gzipped, no runtime deps
• Agentic chat -- up to 15 autonomous rounds with inline gate feedback
• Six screen modes -- chat, gates, code view, world model, trust boundary, playground
• Provider-agnostic -- Gemini, Groq, OpenRouter, OpenAI, Ollama
• 269 tests -- 300+ consecutive CI runs, zero failures
• OpenTUI engine -- built on Zig+TS for native terminal performance

Quick Start

TUI:

npx @avasis-ai/synthcode-tui@latest

Framework:

import { Agent, BashTool, DualPathVerifier } from "@avasis-ai/synthcode";
import { OllamaProvider } from "@avasis-ai/synthcode/llm";

const agent = new Agent({
  model: new OllamaProvider({ model: "qwen3:32b" }),
  tools: [BashTool],
  dualPathVerifier: new DualPathVerifier(),
});

for await (const event of agent.run("List all TypeScript files in src/")) {
  if (event.type === "text") process.stdout.write(event.text);
}

Architecture

<div align="center"> <img src="tui/assets/hero.svg" width="700" alt="Architecture Overview" /> </div>

  LLM Output
      |
      v
 +----------+   +-------+   +------+   +--------+   +------------+   +----------+
 | Structure|-->| Scope |--->| Type |--->| Safety |--->| ControlFlow|--->| Semantic |
 +----------+   +-------+   +------+   +--------+   +------------+   +----------|
      |                                                               |
      v                                                               v
   REJECT                                                          ACCEPT

Framework API

import {
  Agent, BashTool, FileReadTool, FileWriteTool,
  DualPathVerifier, WorldModel, CostTracker, CircuitBreaker,
  AnthropicProvider, OpenAIProvider, OllamaProvider,
} from "@avasis-ai/synthcode";

const agent = new Agent({
  model: new AnthropicProvider({ model: "claude-sonnet-4-20250514" }),
  tools: [BashTool, FileReadTool, FileWriteTool],
  dualPathVerifier: new DualPathVerifier(),
  costTracker: new CostTracker(),
});

npx @avasis-ai/synthcode "Explain this codebase"              # auto-detect
npx @avasis-ai/synthcode "Refactor this" --ollama qwen3:32b   # local
npx @avasis-ai/synthcode adapt catalog                         # 30+ models

Agent Patterns

SynthCode is designed for autonomous agents that run 24/7. Here are common patterns:

Error Handling & Resilience

Autonomous agents must handle failures gracefully:

import { createResilientTool, ErrorLogger, CircuitBreaker } from "@avasis-ai/synthcode";

// Wrap tools with retry logic and circuit breaking
const bashTool = createResilientTool(
  new BashTool(),
  new ErrorLogger(),
  new CircuitBreaker(),
  { maxRetries: 3 }
);

// The agent continues even when tools fail temporarily

See examples/error-handling.ts for a complete implementation with:

• Automatic retry with exponential backoff
• Circuit breaker pattern for failing tools
• Structured error logging for debugging
• Graceful degradation when tools are unavailable

Continuous Monitoring…