Synaptik

Synaptik is a multi-provider AI coding CLI built for real terminal workflows.

It is designed for code understanding, code changes, provider switching, and tool-driven development inside an active project workspace.

Availability

Synaptik is currently distributed as an npm package.

The package is published, but the source code is not currently released as a public open-source repository.

Install

Synaptik runs with Node.js 18+.

Install Synaptik globally:

npm install -g @neuraparse/synaptik

This installs the synaptik and syn commands globally.

If you install the package locally instead of globally, run it with:

npx @neuraparse/synaptik

What Synaptik Does

• Works across multiple AI providers in one coding workflow
• Lets you move between Claude and OpenAI-backed routes instead of being locked to one path
• Supports provider chains and fallbacks for continuity
• Understands project context before editing
• Uses search, read, edit, write, shell, LSP, and MCP-aware workflows
• Supports project and user skills through SKILL.md
• Focuses on minimal, reviewable file changes instead of noisy rewrites

Provider Support

Synaptik supports both account-backed and API-based provider modes.

• claude-code Uses the official claude CLI for account-backed Claude workflows
• codex-cli Uses the official codex CLI for account-backed OpenAI workflows
• anthropic Uses a direct Anthropic API configuration
• openai-compatible Uses OpenAI-style API endpoints and compatible deployments

You can keep a provider chain configured so work can continue through another provider path when needed.

Skills

Synaptik supports reusable skills for project-specific or user-specific workflow guidance.

• Project skills can live under .synaptik/skills/**/SKILL.md
• User skills can live under ~/.synaptik/skills/**/SKILL.md
• Built-in workflow skills help with investigation, editing, and verification
• Matching skills are injected into the turn context when relevant

Coding Workflow

Synaptik is built for code work, not just chat.

• Discover files across the workspace
• Search code with grep-style matching
• Read full files or targeted ranges
• Build context from the current workspace, file mentions, and active skills
• Apply minimal edits with explicit approval-aware write flow
• Use shell commands, LSP intelligence, and MCP integrations from the same runtime

Editing and Safety

• Workspace-aware context assembly
• Approval-aware editing flow
• Preview-driven file mutations
• Minimal edits instead of broad rewrites
• Provider and tool routing based on request type

Basic Usage

synaptik
synaptik doctor
synaptik auth status
synaptik auth login claude-code
synaptik auth login codex-cli
synaptik run "inspect the current codebase and summarize the main architecture"

Configuration

• Global config path: ~/.synaptik/config.json
• Project config path: .synaptik.json

Package

• npm package: @neuraparse/synaptik
• global commands: synaptik, syn