Metadata-Version: 2.4
Name: nano-claude
Version: 0.1.0
Summary: A terminal-native IDE that embeds Claude Code alongside a code editor, file tree, and terminal
Project-URL: Homepage, https://github.com/yaroslavpankovych/nano-claude
Project-URL: Repository, https://github.com/yaroslavpankovych/nano-claude
Project-URL: Issues, https://github.com/yaroslavpankovych/nano-claude/issues
Author: Yaroslav Pankovych
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,editor,ide,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
Requires-Python: >=3.12
Requires-Dist: click<9,>=8.1
Requires-Dist: pyte>=0.8.2
Requires-Dist: textual[syntax]<9,>=8.1
Requires-Dist: tree-sitter-language-pack>=1.0.0
Requires-Dist: watchfiles>=1.1.1
Description-Content-Type: text/markdown

# nano-claude

A terminal-native IDE that embeds [Claude Code](https://docs.anthropic.com/en/docs/claude-code) as a first-class panel alongside a code editor, file tree, and terminal. One terminal window, everything in view.

![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)
![License: MIT](https://img.shields.io/badge/license-MIT-green)

## 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

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

# With pip
pip install nano-claude
```

### Prerequisites

- Python 3.12+
- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated

## Usage

```bash
# Open current directory
nano-claude

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

## Keyboard Shortcuts

### Navigation

| Key | Action |
|-----|--------|
| `Ctrl+b` | Focus file tree |
| `Ctrl+e` | Focus editor |
| `Ctrl+r` | Focus chat |
| `Tab` / `Shift+Tab` | Cycle panels |
| `Ctrl+=` / `Ctrl+-` | Grow / shrink panel |
| `Ctrl+\` | Toggle file tree |
| `Ctrl+h` | Toggle hidden files |

### Editing

| Key | Action |
|-----|--------|
| `Ctrl+s` | Save file |
| `Ctrl+f` | Find in file |
| `Ctrl+c` | Copy (when text selected) / Cancel (in terminal) |

### Claude Integration

| Key | Action |
|-----|--------|
| `Ctrl+l` | Send code selection to Claude |
| `Ctrl+p` | Pin/unpin ambient context |
| `Ctrl+Shift+r` | Restart Claude |

### Change Detection

| Key | Action |
|-----|--------|
| `Ctrl+j` | Jump to Claude's latest change |
| `Ctrl+d` | Toggle inline diff view |

### Terminal Panel

| Key | Action |
|-----|--------|
| `Ctrl+t` | Toggle terminal panel |
| `Ctrl+n` | New terminal tab |
| `Ctrl+w` | Close terminal tab |
| `Ctrl+Shift+Left/Right` | Switch tabs |
| Mouse wheel | Scroll through history |

### General

| Key | Action |
|-----|--------|
| `Ctrl+q` | Quit |

## 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

```bash
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
