HaseebKhalid1507/SynapsCLI

Run a crew of AI agents in your terminal, on any model, from one ~32 MB binary.
## Install
Linux, macOS and Windows 10/11 (x64).
bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/HaseebKhalid1507/SynapsCLI/releases/latest/download/synaps-installer.sh | sh
# or
brew install HaseebKhalid1507/tap/synaps
synaps --version # check it worked
On Windows:
powershell
powershell -ExecutionPolicy Bypass -c "irm https://github.com/HaseebKhalid1507/SynapsCLI/releases/latest/download/synaps-installer.ps1 | iex"
This installs synaps.exe in %USERPROFILE%\.cargo\bin (%CARGOHOME%\bin if set). On Windows the agent also gets a built-in powershell tool, and the default system prompt tells it to prefer it. The bash tool uses Git Bash, or WSL's bash.exe, when it finds one; with neither, bash calls fail with a not-found error, so install Git for Windows if you want bash.
Other ways: cargo, AUR, .deb, .zip, source
bash
cargo install synaps # crates.io, needs Rust 1.88+
yay -S synaps # Arch / EndeavourOS
# Debian/Ubuntu: a .deb is attached to every release
# Windows: so is synaps-x8664-pc-windows-msvc.zip
# https://github.com/HaseebKhalid1507/SynapsCLI/releases/latest
git clone https://github.com/HaseebKhalid1507/SynapsCLI && cd SynapsCLI
cargo build --release && ./target/release/synaps
## Quick start
bash
synaps login # pick a provider: your subscription, an API key, cloud, or local
synaps # start the TUI
Sign in with what you already pay for, or use no account at all:
bash
synaps login --provider claude # Claude subscription (also openai-codex, xai-auth, github-copilot)
synaps login --provider kimi # an API key
ollama serve # or a local model: run synaps, then /model local/llama3.2
All providers, cloud identity and local endpoints
bash
# Subscription OAuth
synaps login --provider claude
synaps login --provider openai-codex
synaps login --provider xai-auth
synaps login --provider github-copilot
synaps login --provider google-gemini # requires a Synaps-owned Google Desktop OAuth client registration
# Static API key
synaps login --provider kimi # Moonshot AI (MOONSHOTAPIKEY / KIMIAPIKEY)
# Cloud identity; credentials stay in the broker
synaps login --provider azure-openai
synaps login --provider aws-bedrock
synaps login --provider google-vertex
Models are provider-qualified: /model / . Cloud routes (Azure OpenAI, Amazon Bedrock, Google Vertex AI) are text-only for now and say so in model listings; a mode that needs tools fails before any credential is used. Availability depends on each upstream account, region and quota.
Local models: Synaps targets Ollama's default http://localhost:11434/v1. LM Studio, vLLM and llama.cpp work too; point at them with provider.local.url or LOCALENDPOINT. Several accounts per provider: docs/providers/multi-account-broker.md.
## What it does
Sessions outlive the window. A background daemon owns every session. /sessions lists them, and pinned ones come back after a restart. More
Every terminal is you. Attach several clients to one session; any of them can type, steer, or take over.
Run a crew. Named subagents work in parallel. Open any one in its own view and steer it mid-flight. More
Any model. Claude, Codex, Grok, Copilot, Gemini, Kimi, Meta Muse, Azure, Bedrock, Vertex, any OpenAI-compatible endpoint, or Ollama.