cliide logo

The AI-Native Terminal IDE
Code with AI agents, not against them

Stars Forks License PyPI Python

Features • Quick Start • Why cliide? • Docs • Contributing

cliide demo

cliide (CLI IDE) is a terminal-based AI-first development environment that runs entirely in your terminal. Unlike traditional IDEs with AI bolted on, cliide is built from the ground up with AI agents at its core.

┌─────────────────────────────────────────────────────────────────────────┐
│ 📁 Files │ 📝 Editor │ 💬 AI Chat │
│ │ │ │
│ ▼ src/ │ def calculate_tax(income): │ You: Optimize this │
│ main.py │ if income < 50000: │ function for large │
│ utils.py │ return income * 0.1 │ datasets │
│ config.py │ else: │ │
│ │ return income * 0.2 │ AI: I'll refactor this │
│ ▼ tests/ │ │ to use numpy vectorized │
│ test_m... │ [Proposed changes - Y/N] │ operations... │
│ │ │ │
│ ─────────── │ │ 🔧 write_file(utils.py) │
│ 📋 Tasks │ │ ⏳ Executing... │
│ ▶ Step 1... │ │ │
│ ○しろまる Step 2... │ │ │
└─────────────────────────────────────────────────────────────────────────┘

Your code never leaves your machine. cliide connects to local VLLM/Ollama instances, meaning:

• No API keys required
• No cloud processing
• No data retention concerns
• Works completely offline

• Terminal-native: No Electron, no browser, no bloat
• Instant startup: Ready in milliseconds
• Low memory: Runs on modest hardware
• SSH-ready: Full functionality over remote connections

• Inline code changes: AI proposes edits directly in the editor with diff highlighting
• Accept/Reject flow: Review changes with Y/N keys before applying
• Multi-step planning: AI breaks down complex tasks and shows progress
• Tool execution: AI can read files, run commands, and make changes

• Syntax highlighting for 30+ languages
• LSP integration: Completions, diagnostics, go-to-definition
• Multiple buffers: Work on several files simultaneously
• Vim-style keybindings: Feel right at home

• Resizable panels: Drag to resize file tree, editor, and chat
• Task panel: See AI planning steps and tool executions
• Approval queue: Review AI actions before they execute
• Rich markdown: AI responses render beautifully

• Command palette: Quick access to all commands (Ctrl+P)
• File tree: Navigate projects with ease
• Find & replace: Search across files
• Git integration: Status indicators in file tree

• Python 3.10+
• A local LLM server (VLLM, Ollama, or OpenAI-compatible)

pip install cliide

# Open current directory
cliide
# Open a specific project
cliide ~/projects/my-app

# Using Ollama (easiest)
ollama serve
ollama run deepseek-coder:33b
# Using VLLM
python -m vllm.entrypoints.openai.api_server \
 --model deepseek-ai/deepseek-coder-33b-instruct

Configure in ~/.config/cliide/config.toml:

[vllm]
base_url = "http://localhost:11434/v1" # Ollama
# base_url = "http://localhost:8000/v1" # VLLM
model = "deepseek-coder:33b"

Chat naturally or use shortcuts:

/explain - Explain selected code
/refactor - Suggest improvements
/fix - Find and fix bugs
/test - Generate unit tests
/doc - Generate documentation

cliide/
├── ai/ # AI agents, prompts, event bus
├── core/ # App core, config, session management
├── ui/ # Textual widgets (editor, chat, panels)
├── lsp/ # Language Server Protocol client
└── editor/ # Buffer management, syntax highlighting

We love contributions! Whether it's:

• 🐛 Bug reports
• 💡 Feature suggestions
• 📖 Documentation improvements
• 🔧 Code contributions

See CONTRIBUTING.md for guidelines.

# Development setup
git clone https://github.com/mtecnic/cliide.git
cd cliide
pip install -e ".[dev]"
# Run tests
pytest
# Run with live reload
textual run --dev cliide/core/app.py

MIT License - see LICENSE for details.

Star History Chart

Built with amazing open source projects:

• Textual - TUI framework
• Rich - Beautiful terminal formatting
• VLLM - Fast LLM inference
• Ollama - Easy local LLMs

If cliide helps you code faster, give it a ⭐!

GitHub • Issues • Discussions