https://github.com/nesdesignco/vibeconsole
Terminal IDE for AI coding workflows. Multi-terminal, git integration, plugin system, context preservation.
https://github.com/nesdesignco/vibeconsole
ai claude-code developer-tools electron ide macos node-pty terminal vibeconsole xterm
Last synced: about 15 hours ago
JSON representation
Terminal IDE for AI coding workflows. Multi-terminal, git integration, plugin system, context preservation.
- Host: GitHub
- URL: https://github.com/nesdesignco/vibeconsole
- Owner: nesdesignco
- License: mit
- Created: 2026-02-12T09:55:46.000Z (4 days ago)
- Default Branch: main
- Last Pushed: 2026-02-15T00:38:39.000Z (1 day ago)
- Last Synced: 2026-02-15T07:43:55.619Z (1 day ago)
- Topics: ai, claude-code, developer-tools, electron, ide, macos, node-pty, terminal, vibeconsole, xterm
- Language: JavaScript
- Homepage: https://vibeconsole.dev
- Size: 3.06 MB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
VibeConsole
The terminal IDE built for AI coding workflows.
Not a code editor — a project management framework for developers who ship with AI.
Why? •
Features •
Quick Start •
Shortcuts •
Architecture •
FAQ •
Contributing
---
## 💡 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
```bash
git clone https://github.com/nesdesignco/vibeconsole.git
cd vibeconsole
npm install
npm start
```
### Development
```bash
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
```bash
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+1 – 9 | 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`](STRUCTURE.json) for the full module map.
---
## 🛠️ Tech Stack
Electron 28
Desktop framework
JavaScript
Language
Node.js 18+
Runtime
esbuild
Bundler
xterm.js 5.3
Terminal emulator
node-pty 1.0
PTY management
Git
Version control
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**](CONTRIBUTING.md) for detailed guidelines.
| Type | Link |
|------|------|
| 🐛 Bug Report | [Open an issue](https://github.com/nesdesignco/vibeconsole/issues/new?template=bug_report.md) |
| 💡 Feature Request | [Open an issue](https://github.com/nesdesignco/vibeconsole/issues/new?template=feature_request.md) |
| 📖 Docs | [CONTRIBUTING.md](CONTRIBUTING.md) |
---
## Contributors
Thanks to everyone who has contributed to VibeConsole.
## 📄 License
[MIT](LICENSE) © 2026 [nesdesignco](https://github.com/nesdesignco)
