Nexus

A local web console for managing multiple CLI AI Agent instances in parallel from a single browser interface.

Features

🖥️ Multi-Agent Parallel Management

• Supports multiple agents: Claude Code, OpenCode, Aider, Codex, Gemini
• Each agent runs in its own collapsible terminal pane
• Create, close, and restart agent processes
• Real-time status indicators (running / waiting / idle / stopped / error)
• Floating bottom shell terminal, always accessible

🔀 Git Worktree Isolation

• Each agent can work in its own isolated Git worktree
• Parallel development on independent branches without conflicts
• Branch name and file change count displayed in pane headers

📊 Agent Metadata Monitoring

• Automatically parses Claude Code statusline for runtime info
• Live display of model name, context usage %, cumulative cost, session ID
• All agent states written to .nexus/agents.yaml for cross-agent awareness

📁 File & Code Viewing

• Live file tree with automatic change detection (chokidar)
• Built-in code viewer with Shiki syntax highlighting
• Git diff panel for repo-level change inspection

⌨️ Shortcuts & Command Palette

• Cmd/Ctrl+K — Open command palette
• Cmd/Ctrl+N — New agent pane
• Cmd/Ctrl+1-9 — Switch between panes
• Cmd/Ctrl+G — Open Git diff
• Theme switching via command palette

🎨 Themes & Layout

• Resizable four-column layout: Sidebar / Agent Panes / Editor / File Tree
• 7 built-in themes: Dark IDE, GitHub Dark, Dracula, Tokyo Night, Catppuccin, Nord, Light IDE
• Responsive scaling for large screens

📝 Configuration

• YAML-driven config at global (~/.nexus/config.yaml) and project level
• Per-agent working directory and task description
• Session restore modes: continue (--continue) / restart / manual

Installation & Usage

# Install globally
npm install -g nexus-console

# Start in the current directory
nexus

# Start with a specific project path
nexus ~/projects/my-app

# Initialize project config
nexus init ~/projects/my-app

# Check workspace status
nexus status

# Stop the server
nexus stop

# Custom port
NEXUS_PORT=8080 nexus

Development

# Install dependencies
pnpm install

# Dev mode (build frontend, then start server with watch)
pnpm dev

# Full dev mode (frontend + backend hot reload in parallel)
pnpm dev:full

# Production build
pnpm build

# Start production server
pnpm start

Tech Stack

Backend

• Node.js 22+, TypeScript, Fastify 5, @fastify/websocket
• node-pty (terminal process management)
• chokidar (file watching), simple-git (Git operations)

Frontend

• React 18, TypeScript, Vite 6
• Tailwind CSS v4, xterm.js, Zustand
• Shiki (syntax highlighting), react-diff-view, cmdk

Architecture

Browser (React + WebSocket)
    ↕
Node.js Server (Fastify)
    ↕
CLI Agent Processes (node-pty)

License

MIT