nano-claude

A terminal-native IDE that embeds Claude Code as a first-class panel alongside a code editor, file tree, and terminal. One terminal window, everything in view.

Why

Claude Code is powerful, but using it means constantly switching between your terminal and editor to review changes. nano-claude puts them side by side: see Claude's edits the moment they happen, and let Claude see what you're looking at.

Install

# With pipx (recommended — isolated install)
pipx install nano-claude

# With pip
pip install nano-claude

Prerequisites

• Python 3.12+
• Claude Code CLI installed and authenticated

Usage

# Open current directory
nano-claude

# Open a specific project
nano-claude ~/projects/my-app

Keyboard Shortcuts

Navigation

Editing

Claude Integration

Change Detection

Terminal Panel

General

Features

• Three-panel layout — file tree, syntax-highlighted editor, and Claude Code chat side by side
• Embedded Claude Code — full PTY integration with streaming output, status indicators, and token tracking
• Auto-jump to changes — when Claude edits a file, the editor jumps to the change with highlights
• Inline diff view — toggle unified diff to see exactly what changed
• Send code to Claude — select code and send it with Ctrl+l, or pin context with Ctrl+p
• Multi-tab terminal — integrated shell terminal with tab management
• Scrollback history — smooth scroll through terminal and Claude output history
• File watching — tree auto-updates when files change on disk
• Responsive layout — panels adapt to terminal size, collapse gracefully

Development

git clone https://github.com/yaroslavpankovych/nano-claude.git
cd nano-claude
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Run
nano-claude

# Test
pytest

License

MIT