The Companion

Web UI for Claude Code and Codex sessions. Run multiple agents, inspect every tool call, and gate risky actions with explicit approvals.

Quick start

**Requirements:** [Bun](https://bun.sh) + [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and/or [Codex](https://github.com/openai/codex) CLI.

Try it instantly

bunx the-companion

Open [http://localhost:3456](http://localhost:3456).

Install globally

bun install -g the-companion

# Register as a background service (launchd on macOS, systemd on Linux)
the-companion install

# Start the service
the-companion start

Open [http://localhost:3456](http://localhost:3456). The server runs in the background and survives reboots.

CLI commands

Command	Description
the-companion	Start server in foreground (default)
the-companion serve	Start server in foreground (explicit)
the-companion install	Register as a background service (launchd/systemd)
the-companion start	Start the background service
the-companion stop	Stop the background service
the-companion restart	Restart the background service
the-companion uninstall	Remove the background service
the-companion status	Show service status
the-companion logs	Tail service log files

**Options:** `--port ` overrides the default port (3456).

Why this is useful

• Parallel sessions: work on multiple tasks without juggling terminals.
• Full visibility: see streaming output, tool calls, and tool results in one timeline.
• Permission control: approve/deny sensitive operations from the UI.
• Session recovery: restore work after process/server restarts.
• Dual-engine support: designed for both Claude Code and Codex-backed flows.

...