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

git clone <repo-url>
cd clide
make setup
make run

Or install directly:

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:

{
  "theme": "summer-night",
  "compact_mode": false,
  "jira_enabled": false
}

Override with environment variables:

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

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 — How to use Clide
• UI/UX Specification — Design decisions
• Architecture — Technical overview
• Code Organization — Project structure

License

MIT