Ricochet
Open-source AI coding agent for VS Code-compatible editors and the terminal.
Plan changes, inspect code, run tools, review edits, and keep control of what lands in your workspace.
Install ·
Quick Start ·
Account and Models ·
Safety ·
Development
Ricochet is a local-first coding agent. The editor UI stays focused on the conversation, task timeline, pending file changes, approvals, and checkpoints. A native Go core handles planning, tool execution, provider routing, sessions, and terminal/TUI workflows.
Use Ricochet with a Grik Account for hosted subscription models, or bring your own provider key for supported BYOK providers.
Features
| Feature |
What it does |
| Agent chat |
Ask Ricochet to inspect, plan, edit, run commands, and summarize work. |
| Reviewable edits |
AI-generated file changes are surfaced for review before they are applied. |
| Task timeline |
Reads, searches, commands, edits, approvals, artifacts, and errors appear as structured progress. |
| Checkpoints |
Restore or compare task-level workspace snapshots. |
| Model choice |
Use Grik hosted models or configure BYOK providers such as OpenRouter, OpenAI-compatible APIs, Anthropic, OpenAI, Mistral, DeepSeek, Z.AI, xAI, and MiniMax. |
| MCP and skills |
Connect external tools through MCP and add project-specific instructions. |
| CLI/TUI |
Run Ricochet from the terminal when you do not want to work inside the editor. |
| Live Mode |
Optional Telegram or Discord control for receiving updates and responding while away from the IDE. |
Install
Install from the VS Code Marketplace:
ext install grik.ricochet
Or use the installer for VS Code-compatible editors:
INSTALLER="$(mktemp)" && curl -fsSL https://grik.io/ricochet/install -o "$INSTALLER" && sh "$INSTALLER"
Package-manager entrypoints run the same installer:
npx @grik-ai/ricochet-installer
pnpm dlx @grik-ai/ricochet-installer
bunx @grik-ai/ricochet-installer
brew install grik-ai/tap/ricochet && ricochet-install
Target a specific editor:
INSTALLER="$(mktemp)" && curl -fsSL https://grik.io/ricochet/install -o "$INSTALLER" && sh "$INSTALLER" --editor cursor
Quick Start
- Open the Ricochet sidebar in VS Code, Cursor, or Windsurf.
- Sign in with Grik, or open Provider Access and add a BYOK provider key.
- Choose a model from the model picker.
- Ask Ricochet to inspect, plan, implement, or verify a task.
- Review pending changes before applying them to your workspace.
Account And Models
Ricochet supports two model access paths:
- Grik Account: sign in to use hosted subscription models. Provider credentials and billing limits are managed by Grik services, not by this repository.
- BYOK providers: store your own provider keys locally and send requests directly to that provider.
The public provider catalog lives in core/config/providers.yaml. It contains model metadata and environment-variable placeholders only. It must not contain real API keys, billing credentials, private Grik gateway secrets, or user tokens.
For details, see docs/providers.md.
Safety
Ricochet can read files, propose edits, and run commands in your workspace. Treat it like a local development tool with access to the project you open.
- Review file edits before applying them.
- Keep provider keys in local user settings or environment variables.
- Do not commit
.env, .keys, .local, logs, binaries, or workspace-private agent files.
- Use permissions and checkpoints to keep high-impact changes visible.
For threat model and disclosure details, see SECURITY.md.
Development
Build everything:
./scripts/build-all.sh
Run focused checks:
cd core && go test ./...
cd ../webview && npm test -- --run && npm run build
cd ../extension-vscode && npm test -- --run && npm run build
cd .. && bash scripts/check-public-hygiene.sh
Development setup and contribution guidance are in CONTRIBUTING.md.
Star History
License
Apache 2.0. See LICENSE.
