@jacques-ai/cli

Navigate through many AI coding sessions and local worktrees.
Monitor Claude Code, Gemini CLI, Codex, and OpenCode — all from one tool.
Manage multiple sessions and repos.

Install it with a single command:

npx jacques

No global install needed. First run auto-detects missing setup and walks you through it.

Available for macOS, Windows, and Linux.

Features  •  Who Is This For  •  Commands  •  Architecture  •  Roadmap  •  Development

Installation

npx jacques

That's it. First run detects missing setup and launches the interactive wizard automatically. After setup, you go straight to the dashboard.

Need to reconfigure later? Run npx jacques setup anytime.

# Global install (faster startup after first run)
npm install -g @jacques-ai/cli
jacques

# pnpm
pnpm add -g @jacques-ai/cli
jacques

# bun
bunx jacques
bun add -g @jacques-ai/cli
jacques

Requirements: Node 20+, Python 3.8+, and at least one supported AI coding tool (Claude Code, Gemini CLI, Codex, or OpenCode).

Documentation map: docs/README.md

Problems That Jacques Solves

No more running blind between multiple opened terminals, tabs, worktrees and projects.

Everything available from inside a single app — monitor, focus, tile.

One-click to spawn new Claude Code instances and create new worktrees per task.

Never lose track of uncommitted changes on the 107th worktree you've created.

Who Is This For

Just starting with vibe coding — feeling overwhelmed with multiple terminal instances, having a hard time keeping good practices with your workflow. Jacques gives you one place to see everything.

Pre-AI era coders who fully embrace the shift — but feel the headache with these new dynamic, multi-context workflows and gitflows you have to apply now. Jacques keeps it organized.

Multiple screens, dozens of agents — working on different things across different repos. Jacques helps you keep track of all of it.

13-inch MacBook, single screen — a single CLI window will help you get the most out of limited space.

What You Get

Jacques stays simple but powerful. Inside there are a few modules and some additional resources. During the setup process you decide what to install.

CLI Dashboard

A terminal TUI that shows real-time context usage %, session status, and plan progress for every active AI coding session across Claude Code, Gemini CLI, Codex, and OpenCode. Keyboard-driven — focus sessions, tile terminal windows into a grid, spawn new sessions, and manage git worktrees without ever leaving the dashboard.

Web GUI

Full browser dashboard at localhost:4243. Browse session history, view extracted plans and subagent results, manage worktrees, launch sessions. Your entire Claude Code conversation archive — searchable.

StatusLine

[Opus] ctx:42% displayed right inside Claude Code. No window switching needed — context usage is always visible.

Archive & Search

Every session is auto-cataloged on exit — even if you Ctrl+C. Plans, subagent results, and session manifests are extracted and saved. Full-text search across all past conversations, filterable by project, date range, and technology.

Notifications

Native OS notifications for events that matter — context thresholds (50%, 70%), plan creation, and auto-compact. Works across macOS (with click-to-focus), Linux, and Windows. The web GUI adds in-app toasts and a notification center with read/unread tracking. Opt-in via Settings with per-category toggles.

The setup wizard lets you choose what to enable. Install just the lightweight CLI or add the web GUI for history browsing.

Roadmap

The first release was built for a vibeathon organized by BridgeMind.

It's early, and it needs improvements. This is a preview of what Jacques will eventually become — your next coding assistant.

More features on the way.

Commands

CLI

Search options: -p/--project, --from/--to, -t/--tech, -l/--limit, --json

npm scripts

Architecture

AI Coding Tools
  Claude Code · Gemini CLI · Codex · OpenCode
    │  IPC Socket (/tmp/jacques.sock)
    ▼
┌─────────────────────────────────┐
│  Jacques Server (Node.js/TS)    │
│  HTTP + WebSocket :4243         │
└─────────────────────────────────┘
    │              │
    ▼              ▼
 CLI TUI      Web GUI
(terminal)  (localhost:4243)

AI coding tools (Claude Code, Gemini CLI, Codex, OpenCode) report lifecycle events (start, tool use, idle, context updates) over an IPC socket via per-tool event adapters. The server aggregates state and broadcasts to connected clients. Running jacques starts the server, CLI, and web GUI in a single process.

Terminal I/O

Jacques spawns and manages terminal sessions through node-pty (prebuilt binaries for macOS, Linux, Windows — arm64 + x64). Two backends handle the actual I/O, selected automatically at startup:

                        ┌─────────────────────────────┐
                        │       Web GUI / CLI          │
                        │      (xterm.js viewer)       │
                        └──────────┬──────────────────┘
                                   │ binary WebSocket
                        ┌──────────▼──────────────────┐
                        │     PtyBridge (base class)   │
                        │  scrollback · batching · seq │
                        └──────┬───────────┬──────────┘
                               │           │
                ┌──────────────▼──┐  ┌─────▼───────────────┐
                │  TmuxPtyBridge  │  │   DirectPtyBridge    │
                │  pty.spawn(     │  │   pty.spawn(shell)   │
                │   tmux attach)  │  │                      │
                └────────┬────────┘  └──────────┬──────────┘
                         │                      │
                    tmux session            shell process
                   (survives restarts)     (dies with server)

tmux backend (macOS, Linux — when tmux is installed):

• Terminal sessions persist across server restarts and crashes
• Runner scripts keep running even if you restart Jacques
• "Open in Terminal" attaches to the live tmux session
• Server recovery re-discovers and re-bridges surviving sessions on startup

Direct PTY backend (Windows always, macOS/Linux without tmux):

• Terminal sessions are tied to the server process — stopping the server kills all terminals
• Runner scripts are lost on server restart
• "Open in Terminal" opens a new shell in the same directory (not the same session)
• No recovery — everything starts fresh

Platform Support

tmux is recommended on macOS and Linux (brew install tmux / sudo apt install tmux). Set JACQUES_FORCE_DIRECT_PTY=1 to use the direct backend even when tmux is available.

See docs/PLATFORM-SUPPORT.md for full cross-platform details.

Configuration

config.json stores preferences, UI settings, and source integration metadata (non-sensitive fields). secrets.json stores Jacques' own OAuth tokens and API keys (GitHub, Google Docs, Notion) with restrictive file permissions (0600 on Unix). Both files are managed by ConfigManager — see docs/STATE.md for details.

Environment variables (all optional):

See docs/PLATFORM-SUPPORT.md for Windows paths and cross-platform details.

Troubleshooting

npm run stop:server              # Kill zombie process
rm /tmp/jacques.sock             # Remove stale socket (macOS/Linux)
lsof -i :4243                    # Check port conflicts

For other issues, open a GitHub issue.

FAQ

Remote Access

Monitor your sessions from your phone or tablet using Tailscale:

npm run start:remote

One command starts the server with Tailscale Serve proxying HTTPS traffic from your Tailnet. Approve your device with a 6-digit PIN shown on the server terminal. No ports are exposed to the internet — all traffic stays within your private Tailnet.

See docs/REMOTE.md for setup details, architecture, and troubleshooting.

Development

git clone https://github.com/gregory-lime/jacques.git
cd jacques
npm run setup

Build order: core → server → cli → gui (each depends on the previous).

npm run dev:server      # Server with tsc --watch
npm run dev:gui         # GUI with Vite hot reload
npm run build:all       # Full rebuild

Tests

cd server && npm test       # Server tests
cd core && npm test         # Core tests
cd cli && npm test          # CLI tests

Agent repo guides:

• AGENTS.md for shared repository rules
• CLAUDE.md for the detailed development guide
• GEMINI.md for Gemini CLI entry instructions

Star History

License

MIT

Built for developers who run AI coding tools at scale.