Home
Codeman runs your coding agents on your own machine and puts them behind one dashboard you can open from any device. It spawns Claude Code, OpenCode, Codex, Antigravity, Gemini, or Pi inside persistent tmux sessions, streams the real terminal to the browser, and keeps working while you are away from the keyboard: it re-prompts idle agents, resumes when a subscription limit resets, runs jobs on a schedule, and shows every background subagent live.
This wiki is the manual. The README is the overview,
and the deep internals live in
docs/.
curl -fsSL https://getcodeman.com/install | bash
codeman web # then open http://localhost:3000New to Codeman
- Installation - requirements, the installer, npm and git clone routes, updating.
- Quick Start - from a running server to a working agent in five minutes.
- Core Concepts - cases, sessions, run modes, and what survives a restart.
- The Dashboard - reading the tab strip, the status dots, and the alerts.
Already running it
- Agent CLIs - the seven run modes, their setup, and which features are Claude-only.
- Mobile Guide - phone and tablet use, QR login, the touch keyboard bar.
- Remote Access - Tailscale, Cloudflare tunnel, LAN plus password, QR login.
- Keeping Agents Running - idle detection, respawn cycling, auto-resume on usage limits.
- Troubleshooting - symptom-first index of things that actually break.
Driving it from code
- Driving Codeman From An Agent - the bundled skill, worker sessions, wait primitives.
- HTTP API - the envelope, auth, the endpoint map, SSE events.
- Hooks And Integrations - events flowing back into Codeman.
| Page | What it answers |
|---|---|
| Installation | How do I install it, update it, and remove it? |
| Quick Start | How do I get one agent working right now? |
| Core Concepts | What is a case, a session, a run mode? |
| Page | What it answers |
|---|---|
| The Dashboard | What is the UI telling me? |
| Agent CLIs | Which agent should this session run, and how do I set it up? |
| Working With Files | How do I read, edit, and attach files? |
| Input And Voice | How do I talk to an agent, including by voice? |
| Mobile Guide | How well does this work on a phone? |
| Keyboard Shortcuts | What can I drive from the keyboard? |
| Settings Reference | What does this setting do, and why did it not follow me to my phone? |
| Page | What it answers |
|---|---|
| Keeping Agents Running | How does it run unattended overnight? |
| Notifications And Approvals | How do I know an agent needs me, and answer from my phone? |
| Cron Jobs | How do I run an agent on a schedule? |
| Autonomous Loops | What are the Ralph and Orchestrator loops for? |
| Watching Agents Work | How do I see what the subagents are doing? |
| Page | What it answers |
|---|---|
| Docker Cases | How do I sandbox a project in a container? |
| Remote SSH Sessions | How do I run the agent on another machine? |
| Web Tabs | Can my Grafana live in here too? |
| Multi-User Mode | Can several people share one Codeman? |
| Page | What it answers |
|---|---|
| Remote Access | How do I reach it from outside this machine, safely? |
| Security | What is exposed, what protects it, what do I have to do? |
| Page | What it answers |
|---|---|
| Driving Codeman From An Agent | How does an agent spawn and drive workers? |
| HTTP API | What can I call, and what comes back? |
| Hooks And Integrations | How do I wire Codeman into something else? |
| Page | What it answers |
|---|---|
| Running As A Service | How do I keep it up across reboots, and update it? |
| Troubleshooting | Why is it doing that? |
| FAQ | The questions that keep coming up. |
| Contributing | How do I send a fix? |
| Versioning | What does the version number promise? |
| Thing | Needed |
|---|---|
| OS | macOS or Linux. Windows works through WSL2. |
| Node.js | 22 or newer. |
| tmux | Required. Sessions live in tmux, which is what makes them survive restarts. |
| An agent CLI | At least one of Claude Code, OpenCode, Codex, Gemini, Antigravity, Pi. Plain shell sessions need none. |
| Network | Binds to 127.0.0.1 by default. Reaching it from another device is a deliberate step: see Remote Access. |
Codeman is MIT licensed, self-hosted, and sends no telemetry. Everything runs on your machine.
- Questions and setup help: Discussions, especially Q&A.
- Bugs: Issues. Include your OS, install method, browser, and which CLI the session was running.
- Ideas and roadmap: Ideas.
- Security: never a public issue. See SECURITY.md.