Synara

AI-powered coding assistant. Cloud brain, local hands.

Part of the Synapse autonomous AI agent platform.

Install

npm install -g synara

Quick Start

synara login     # Authenticate
synara           # Start coding session in current directory

How It Works

You ←→ Synara CLI (local)  ←—WebSocket—→  Cloud Engine (Cloudflare)
       • Display output                    • LLM reasoning (Kimi K2.5)
       • Execute tools locally             • System prompt & guardrails
       • Permission control                • Context management

The CLI is a thin client — all intelligence lives on the cloud. Your code stays local; only tool requests and results travel over the wire.

Commands

synara login     # Login with username/password
synara logout    # Remove stored credentials
synara --help    # Show help

Session Commands

| Command | Description | |------------|-------------| | /compact | Compress conversation (LLM summarization, never truncation) | | /context | Show token usage and compaction stats | | /save | Save session locally | | /load | Restore a saved session | | /sessions| List saved sessions | | /quit | End session |

Tools

| Tool | Description | |------|-------------| | read_file | Read file contents | | write_file | Create or overwrite files | | edit_file | Precise string replacement | | grep | Regex search across files | | glob | Find files by pattern | | list_dir | List directory contents | | bash | Execute shell commands |

Permission Model

| Scope | Behavior | |-------|----------| | Read in project dir | Auto-approved | | Read outside project | Requires approval | | Write / Edit | Requires approval (trustable via t) | | Bash | Requires approval every time (never trustable) | | Destructive commands (rm -rf /, mkfs, etc.) | Blocked |

Prompt responses: y approve · n deny · t trust for session

Project Config

Drop a SYNAPSE.md in your project root — it's automatically sent to the cloud as project-specific instructions.

License

MIT · Built by Bowen Liu