Skip to content

Terminal IDE for AI coding workflows. Multi-terminal, git integration, plugin system, context preservation.

License

Notifications You must be signed in to change notification settings

nesdesignco/vibeconsole

Repository files navigation

VibeConsole

VibeConsole

The terminal IDE built for AI coding workflows.
Not a code editor — a project management framework for developers who ship with AI.

Release License Stars Issues PRs Last Commit

macOS Electron Node PRs Welcome

Why?FeaturesQuick StartShortcutsArchitectureFAQContributing


VibeConsole Source Control panel screenshot


💡 Why VibeConsole?

When developing with AI coding assistants, you don't need a traditional IDE — you need a terminal. But staying terminal-only means:

  • Projects get disorganized
  • Context gets lost between sessions
  • Decisions are forgotten

VibeConsole solves this by combining a multi-terminal workspace with project management tools that preserve context across sessions.

Works with Claude Code, Codex CLI, Gemini CLI, and any terminal-based AI tool. Your AI writes the code. VibeConsole keeps you organized.


✨ Features

🖥️ Multi-Terminal

Up to 9 independent terminals with tabs or grid view. Flexible layouts: 2×1 2×2 3×1 3×2 3×3

📁 Project Explorer

File tree with drag-drop to terminal, context menu, rename, delete, and a quick editor overlay for fast edits.

🔀 Git Integration

Built-in panel for staged/unstaged changes, branches, worktrees, and full inline diffs with syntax highlighting.

💾 Saved Prompts

Save and reuse your most common prompts across sessions. One-click paste to terminal.

🧩 Plugin System

Extend VibeConsole with JavaScript plugins. Official marketplace + local plugin support.

🧠 Context Preservation

AGENTS.md, STRUCTURE.json, and PROJECT_NOTES.md keep your architectural decisions and project context alive across sessions.

📊 Usage Tracking

Real-time Claude & Codex usage monitoring. Session utilization, weekly limits, and reset timers.

🤖 AI Tool Selector

Switch between Claude Code, Codex CLI, and Gemini CLI from the toolbar. Each terminal can run a different tool.

Also includes: Prompt history with timestamps • Auto-updater • Keyboard-driven workflow • Drag file → terminal pastes quoted path • macOS native menus


🚀 Quick Start

Install & Run

git clone https://github.com/nesdesignco/vibeconsole.git
cd vibeconsole
npm install
npm start

Development

npm run dev          # Watch mode + launch app
npm run build        # Bundle renderer + create macOS DMG
npm run lint         # Run ESLint
npm test             # Run tests

Build for Distribution

npm run dist:mac     # Create signed macOS DMG

Requirements: Node.js 18+ • macOS • Git


⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl+K Launch Claude Code in active terminal
Ctrl+Shift+T New terminal
Ctrl+Shift+W Close terminal
Ctrl+Tab / Ctrl+Shift+Tab Next / Previous terminal
Ctrl+19 Jump to terminal N
Ctrl+Shift+G Toggle grid view
Ctrl+B Toggle sidebar
Ctrl+Shift+H Toggle history panel
Ctrl+Shift+P Toggle saved prompts
Ctrl+Shift+B Toggle git branches

🏗️ Architecture

src/
├── main/           # Main process — PTY, file tree, git, plugins
├── renderer/       # Renderer process — terminal UI, panels, styles
└── shared/         # IPC channel constants, path validation

See STRUCTURE.json for the full module map.


🛠️ Tech Stack

Electron
Electron 28
Desktop framework
JavaScript
JavaScript
Language
Node.js
Node.js 18+
Runtime
esbuild
esbuild
Bundler

xterm.js 5.3
Terminal emulator

node-pty 1.0
PTY management
Git
Git
Version control
ESLint
ESLint
Code quality

❓ FAQ

Why not just use VS Code with a terminal?
VS Code is a code editor that happens to have a terminal. VibeConsole is a terminal that happens to have project management tools. When you're using AI to write code, you spend 90% of your time in the terminal — VibeConsole is designed for that workflow.
Does it work on Windows/Linux?
Currently macOS only. Windows and Linux support is on the roadmap. The codebase is cross-platform ready (node-pty and xterm.js support all platforms), but we haven't tested and polished the experience yet.
What shells are supported?
Any shell on your system — zsh, bash, fish, etc. VibeConsole uses your default $SHELL.

🤝 Contributing

We love contributions! Whether it's a bug fix, new feature, or documentation improvement.

  1. Fork the repository
  2. Create your branch (git checkout -b feat/amazing-feature)
  3. Make your changes and run npm run lint
  4. Commit (git commit -m 'Add amazing feature')
  5. Push (git push origin feat/amazing-feature)
  6. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Type Link
🐛 Bug Report Open an issue
💡 Feature Request Open an issue
📖 Docs CONTRIBUTING.md

Contributors

Thanks to everyone who has contributed to VibeConsole.

GitHub View contributors on GitHub

📄 License

MIT © 2026 nesdesignco

About

Terminal IDE for AI coding workflows. Multi-terminal, git integration, plugin system, context preservation.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors