nanocode/README.md

nanocode

Minimal Claude Code alternative. Single Python file, zero dependencies, ~250 lines.

Built using Claude Code, then used to build itself.

Features

• Full agentic loop with tool use
• Tools: read, write, edit, glob, grep, bash
• Conversation history
• Colored terminal output

Usage

export ANTHROPIC_API_KEY="your-key"
python nanocode.py

OpenRouter

Use OpenRouter to access any model:

export OPENROUTER_API_KEY="your-key"
python nanocode.py

To use a different model:

export OPENROUTER_API_KEY="your-key"
export MODEL="openai/gpt-5.2"
python nanocode.py

Commands

• /c - Clear conversation
• /q or exit - Quit

Tools

Tool	Description
read	Read file with line numbers, offset/limit
write	Write content to file
edit	Replace string in file (must be unique)
glob	Find files by pattern, sorted by mtime
grep	Search files for regex
bash	Run shell command

Example

────────────────────────────────────────
❯ what files are here?
────────────────────────────────────────

⏺ Glob(**/*.py)
  ⎿  nanocode.py

⏺ There's one Python file: nanocode.py

License

MIT