jpmschweitzerandClaude Opus 4.7
a355751437
Clide is being rebuilt as a Flutter desktop app. The Python Textual implementation moves wholesale into legacy/ rather than being deleted: its pane model, panel set, git skills, and panel communication design are real thought that should remain readable next to the new code while the rebuild finds its shape. Git's rename tracking preserves history, so `git log -- legacy/` still works. The Flutter rebuild lives at the repo root alongside a Go sidecar (the architecture claudian was heading toward, which folds into clide as a core component rather than a separate plugin project). Bootstrap of the new shape lands in subsequent commits. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
169 lines
5.1 KiB
Markdown
169 lines
5.1 KiB
Markdown
# Clide
|
|
|
|
A terminal-based IDE that wraps Claude Code CLI, putting AI-assisted development at the center of your workflow.
|
|
|
|
## Why Clide?
|
|
|
|
Claude Code is powerful, but switching between terminal, editor, and project tools breaks your flow. Clide brings everything into one interface:
|
|
|
|
- **Claude stays visible** — Claude Code runs in the center panel, always accessible
|
|
- **Context at a glance** — File tree, git status, problems, and TODOs in dedicated panels
|
|
- **Panels appear when needed** — Editor, diff viewer, and terminal stay hidden until you need them
|
|
- **Git integration** — Commit, stash, pull, and push via Claude with built-in skills
|
|
- **22 themes** — From summer-night to dracula, with custom theme support
|
|
|
|
## Screenshot
|
|
|
|
```
|
|
┌─────────────────┬─────────────────────────┬──────────────────┐
|
|
│ Sidebar │ Workspace │ Context │
|
|
│ │ [Editor][Diff][Terminal]│ │
|
|
│ [Files][Git] │ (appears when needed) │ [Jira][TODOs] │
|
|
│ [Tree] ├─────────────────────────┤ [Problems] │
|
|
│ │ │ │
|
|
│ │ Claude │ │
|
|
│ │ (always visible) │ │
|
|
│ │ │ │
|
|
├─────────────────┤ ├──────────────────┤
|
|
│ ⎇ main ▾ │ │ │
|
|
│ staged: 2 │ │ │
|
|
└─────────────────┴─────────────────────────┴──────────────────┘
|
|
```
|
|
|
|
## Features
|
|
|
|
### Left Sidebar
|
|
- **Files** — Project file tree with syntax-aware icons
|
|
- **Git** — Staged/unstaged changes with action buttons
|
|
- **Tree** — Visual branch graph
|
|
- **Branch status** — Current branch with quick switcher
|
|
|
|
### Center
|
|
- **Claude Code** — Full PTY terminal integration, always visible
|
|
- **Editor** — Syntax highlighting via tree-sitter
|
|
- **Diff** — Side-by-side diff viewer
|
|
- **Terminal** — Command execution
|
|
|
|
### Right Context
|
|
- **Jira** — Issue display via CLI integration
|
|
- **TODOs** — Code comments and TODO.md items
|
|
- **Problems** — Linter errors and warnings
|
|
|
|
### Git Operations
|
|
|
|
Click buttons in the Git panel to delegate operations to Claude:
|
|
|
|
| Button | Skill | What Claude Does |
|
|
|--------|-------|------------------|
|
|
| Commit | `/commit` | Reviews changes, writes commit message |
|
|
| Stash | `/stash` | Stashes working changes |
|
|
| Pull | `/pull` | Pulls with rebase, helps resolve conflicts |
|
|
| Push | `/push` | Pushes to remote, sets upstream if needed |
|
|
|
|
Skills are installed automatically to your project's `.claude/skills/` directory.
|
|
|
|
## Installation
|
|
|
|
### Requirements
|
|
|
|
- Python 3.12+
|
|
- Git
|
|
- Claude Code CLI (installed and authenticated)
|
|
|
|
### Setup
|
|
|
|
```bash
|
|
git clone <repo-url>
|
|
cd clide
|
|
make setup
|
|
make run
|
|
```
|
|
|
|
Or install directly:
|
|
|
|
```bash
|
|
pip install -e .
|
|
clide
|
|
```
|
|
|
|
## Keybindings
|
|
|
|
All shortcuts use `Alt` to avoid conflicts with Claude Code input.
|
|
|
|
| Action | Binding |
|
|
|--------|---------|
|
|
| Toggle left sidebar | `Alt+B` |
|
|
| Toggle right sidebar | `Alt+Shift+B` |
|
|
| Toggle terminal | `` Alt+` `` |
|
|
| Focus Claude | `Alt+1` |
|
|
| Focus Editor | `Alt+2` |
|
|
| Focus Terminal | `Alt+3` |
|
|
| Toggle compact mode | `Alt+C` |
|
|
| Select theme | `Alt+T` |
|
|
| Quit | `Alt+Q` |
|
|
|
|
## Themes
|
|
|
|
22 built-in themes. Press `Alt+T` to switch.
|
|
|
|
| Category | Themes |
|
|
|----------|--------|
|
|
| Core | summer-night (default), summer-day |
|
|
| Popular | one-dark, one-dark-pro, one-light, dracula, nord, gruvbox-dark, gruvbox-light |
|
|
| Seasonal | winter-is-coming, monokai-winter, fall, dark-autumn |
|
|
| Special | all-hallows-eve, halloween, christmas, santa-baby |
|
|
| Hacker | pro-hacker, hacker-style |
|
|
|
|
Create custom themes in `~/.clide/themes/` as TOML files.
|
|
|
|
## Configuration
|
|
|
|
Settings stored in `~/.clide/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"theme": "summer-night",
|
|
"compact_mode": false,
|
|
"jira_enabled": false
|
|
}
|
|
```
|
|
|
|
Override with environment variables:
|
|
|
|
```bash
|
|
CLIDE_THEME=dracula clide
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
| Component | Library |
|
|
|-----------|---------|
|
|
| Runtime | Python 3.12+ |
|
|
| TUI Framework | Textual |
|
|
| CLI | Typer |
|
|
| Data Validation | Pydantic v2 |
|
|
| Extensions | Pluggy |
|
|
| Syntax Highlighting | tree-sitter |
|
|
|
|
## Development
|
|
|
|
```bash
|
|
make setup # Create venv, install deps
|
|
make run # Run application
|
|
make test # Run all tests
|
|
make typecheck # Run mypy
|
|
make lint # Run ruff
|
|
make format # Format code
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- [User Manual](docs/user-manual.md) — How to use Clide
|
|
- [UI/UX Specification](docs/tui-ide-spec.md) — Design decisions
|
|
- [Architecture](docs/ARCHITECTURE.md) — Technical overview
|
|
- [Code Organization](docs/code-organization.md) — Project structure
|
|
|
|
## License
|
|
|
|
MIT
|