Your terminal
just learned to code

pip install acorn-agent

18 tools that stay out of your way

From a persistent shell to MCP servers

Persistent Shell

cd, exports, and venv activation carry across commands — no re-chaining with &&

Web Search Built In

Searches the web and reads pages for current docs — no API key needed

MCP Support

Plug in any Model Context Protocol server and its tools become available

Smart Model Routing

Scores each request on size, scope, and intent to pick Flash or Pro

Colored Diffs

Every file change shown as a real diff with line numbers, not a wall of text

Real-time Streaming

Tokens appear as they're generated, formatted live — no waiting

Simple Setup

Just a Gemini API key to get started — or Vertex AI for enterprise

Surgical File Editing

Modifies specific lines, not entire files — precise and safe

Project Instructions

Drop a .acorn.md for persistent project context and conventions

Multi-file Refactoring

Reads and edits across your whole codebase in a single session

Image Analysis

Attach screenshots and images for the model to analyze

Auto-retry Recovery

Adapts when things fail — intelligent error handling

Session Persistence

Resume conversations where you left off

Undo Support

Revert the last file change instantly

Cost Tracking

See what you're spending per session in real-time

Project Config

Per-repo .acorn.toml for custom model and permission settings

Permission System

3-tier safety (safe/ask/deny) for secure operations

Git-aware

Understands your branch, status, and project structure

New in 2.3

Three additions that change how the agent works, not just what it knows

One shell, shared state

Commands run in a single long-lived session, so cd, environment variables, and an activated virtualenv all stay in effect. A command that times out is interrupted on its own — the session and its state survive.

~ python -m venv .venv

~ source .venv/bin/activate

~ pip install -r requirements.txt

~ pytest

still inside the venv

Looks things up itself

Acorn can search the web and read pages when it hits a library version, a changelog, or an error it doesn't recognise. No API key, no signup — it works on a fresh install with nothing configured.

> what changed in the latest fastapi?

~ Searching for 'fastapi release notes'

~ Fetching fastapi.tiangolo.com

Bring your own tools

Acorn speaks the Model Context Protocol, using the same config format other MCP clients do — so existing files work unchanged. Servers start in parallel, and one that fails never blocks startup.

~/.acorn/mcp.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@mcp/server-github"]
    }
  }
}

See Acorn in Action

Watch a quick demo of Acorn coding, refactoring, and debugging

Quick Start

Get up and running in seconds

1. Install from PyPI