Your coding agent, right in the terminal.
Tell icōd what you want — it reads your code, plans the changes, edits the files, and runs the commands to get it done.
$ pip install icodOne command to get started
Once installed, icod downloads the native binary automatically and guides you through first-time provider and model setup.
- Conversational agent session with full context of your project.
- Hybrid code search — semantic embeddings plus BM25 — backed by a built-in ripgrep.
- Attach screenshots, mockups, or diagrams via
@path, drag-and-drop, or clipboard paste. - Multi-provider — Anthropic, OpenAI, Google Gemini, Groq, Mistral, OpenRouter, DeepSeek, xAI, Cohere.
Built for the whole workflow.
Plan, write, refactor and debug your code with an agent that understands your entire project.
Agent Session
A conversational session with full project context. The agent remembers what it did — just keep talking until the task is done.
$ icodHybrid Search
Semantic embeddings plus BM25 lexical matching, backed by a built-in ripgrep, so the agent finds the right file fast even in large repos.
$ /add src/**/*.tsMulti-Provider
Switch between Anthropic, OpenAI, Google Gemini, Groq, Mistral, OpenRouter, DeepSeek, xAI, and Cohere. Live model catalog with per-token pricing in the picker.
$ icod providerRevert Changes
Every agent turn is checkpointed. Roll back files, conversation, or both with /revert — snapshots never touch your git history.
$ /revertEvery command, on one page.
Ship the change, not the busywork.
Do everything manually
- Read through the codebase to find the right files
- Figure out what to change and where
- Write the code changes across multiple files
- Write tests for the new functionality
- Run the tests and debug any failures
- Review everything before committing
One prompt, same result
Common questions.
Windows x64 is fully supported. macOS and Linux support is planned. You need Python 3.8+ for the pip launcher; the agent itself is a self-contained native binary.$ pip install icod$ icod
Run icod and the first-run wizard walks you through picking a provider and pasting in a key. You can add more later with icod auth, or switch which one is active per session with /provider.
Yes. Type /model to open a picker, or /model gpt-4o to jump straight to one. The rest of the conversation carries over.
Each session remembers what it has read, written, and discussed until you start a new one. Close your terminal and come back — icod picks the conversation back up where you left it.
Every turn is a checkpoint. Run /revert to step back one turn, or /revert 3 to undo the last three. You can revert just the files, just the conversation, or both. Git is optional, but having it installed enables the full checkpoint system.
Yes — three ways. Type @path/to/image.png inline, drag a file into the terminal, or paste straight from your clipboard with Alt+V. The agent sees the image alongside your instruction, useful for matching a design or debugging something visual.
Ready to code faster?
Install the CLI, pick your provider, and start building. Works with every major LLM.