Skip to content

README.md

Latest commit

 

History

History
181 lines (128 loc) · 5.21 KB

README.md

File metadata and controls

181 lines (128 loc) · 5.21 KB

🐜 Terminal-First IDE for AI Coding Agents

Fast. Elegant. Keyboard-driven.

npm version GitHub stars License Built with Bun OpenTUI

termide demo

✨ Why termide?

termide is a minimalist, terminal-native IDE built for developers who:

  • 🤖 Work with AI coding assistants (Claude Code, Aider, etc.)
  • ⌨️ Prefer keyboard-driven workflows over mouse clicks
  • ⚡ Want instant startup and minimal resource usage
  • 🎨 Love a clean, distraction-free interface

The name is a playful fusion of Terminal + IDE, with a nod to the industrious termite—building complex structures from the ground up, bit by bit.

🤖 Built for AI Coding Agents

Unlike traditional IDEs, termide is designed with AI-first workflows in mind:

Traditional IDEs termide
Heavy GUI, slow startup Instant launch, minimal footprint
Mouse-dependent workflows 100% keyboard-driven
AI tools run in separate terminal AI agent runs inside your IDE
Context switch between windows Everything in one view
Complex plugin systems Simple, focused, opinionated

Perfect for:

  • Claude Code — Full-screen terminal with file browser context
  • Gemini CLI — Google's Gemini in ACP mode
  • Aider — See git changes while AI codes
  • Custom agents — PTY access for any terminal-based AI

The insight: AI agents don't need syntax highlighting or autocomplete—they need a clean terminal with file context. That's exactly what termide provides.

🌀 AI Agent Panel

termide includes a dedicated Agent Panel that connects to AI coding agents using the Agent Client Protocol (ACP):

Agent Status
🤖 Claude Code ✅ Full support (requires claude-code-acp)
🌀 Claude (Antigravity) ✅ Free tokens via Antigravity proxy
✨ Gemini CLI ✅ Full support (gemini --experimental-acp)
⚙️ Custom ✅ Any ACP-compatible agent

To use Antigravity (free Claude/Gemini tokens):

  1. Install the proxy: npm install -g antigravity-claude-proxy
  2. Log in: antigravity-claude-proxy start (first time only)
  3. Select "🌀 Claude (Antigravity)" in termide's Agent Panel
  4. Choose your model and start coding!

Built With Modern Tech

  • Bun — Lightning-fast JavaScript runtime
  • React 19 — Declarative UI components
  • OpenTUI — Terminal UI framework with Yoga layout

🚀 Quick Start

Run it directly using Bun (no install needed):

# Open current directory
bunx termide

# Open a specific project
bunx termide ./my-project

📦 Installation

Global Install (Recommended)

bun install -g termide

Then use it anywhere:

termide .
termide ~/Projects/my-app

For Contributors

git clone https://github.com/Nachx639/termide.git
cd termide
bun install
bun run dev

⌨️ Keyboard Shortcuts

Navigate like a pro:

Key Action
Tab / Shift+Tab Cycle between panels
Ctrl + F Focus Mode — maximize current panel
Ctrl + P Quick open file (fuzzy finder)
Ctrl + K Command Palette
Ctrl + Shift + F Global search in files
Ctrl + B Help panel
Ctrl + G Toggle mascot 🐜
Ctrl + Q Quit

🎯 Features

  • 📁 File Explorer — Git-aware file tree with icons
  • 📝 Code Viewer — Syntax highlighting, line numbers
  • 💻 Embedded Terminal — Full PTY with scrollback
  • 🔍 Fuzzy Finder — Quick file navigation (Ctrl+P)
  • 🎨 Command Palette — VS Code-style commands (Ctrl+K)
  • 🔎 Global Search — Ripgrep-powered search
  • 🌿 Git Integration — Branch, status, commit graph
  • 🐜 Mascot — Because why not?

🛠 Roadmap

  • Multi-tab editing
  • Inline code editing (not just viewing)
  • Plugin system
  • Themes
  • LSP support

🤝 Contributing

Contributions welcome! Feel free to open issues or PRs.

📄 License

MIT © Nachx639

Built with ❤️ for terminal lovers

Tip: If termide is not found after global install, ensure your Bun bin directory is in your PATH:
export PATH="$HOME/.bun/bin:$PATH"