a production-ready, blazing-fast multi-agent terminal code assistant in typescript.
- multi-agent architecture: specialized agents for reading, writing, explaining, debugging, testing, and more.
- sub-100ms dispatch: fast intent classification and routing.
- streaming first: real-time streaming of responses using ink.
- real tools: file system access, shell execution, ripgrep search.
- robustness: retry logic, valid json generation, and error handling.
-
clone the repository.
-
install dependencies:
npm install
-
configure environment variables:
- copy
.env.exampleto.env - add your
anthropic_api_key
cp .env.example .env
- copy
start the terminal assistant:
npm run dev- explain code: "explain src/main.ts"
- edit code: "add a comment to src/config/config.ts"
- run shell: "run ls -la"
- search: "search for 'todo' in src"
- debug: "analyze the logs"
-
orchestrator: routes user intent to agents.
-
agents:
codereader: reads and lists files.codewriter: writes files.explainer: explains code/concepts.shell: runs shell commands.search: searches code (ripgrep).debug: analyzes logs.test: runs tests.context: manages context.
-
ui: built with ink (react for cli).
- typescript
- node.js
- ink
- anthropic sdk
- rxjs / p-queue
- zod
- winston
mit