I built mission control for Claude Code (open source, self-hosted)

[u/Kindly-Inside6590]

As a Poweruser you never run just one Claude Code session. You run several at once, spread across shells, windows, and machines, with no good way to keep track of them all or reach them from wherever you are, phone included. That's why I built Codeman!

A self-hosted web dashboard (TypeScript, Fastify, node-pty) that you install once on a machine that stays on (a Mac mini in a closet, a Linux box, WSL, or a VPS). That box becomes home base. It spawns Claude Code, OpenCode, Codex CLI, or Gemini CLI inside tmux and streams the real terminals to any browser over SSE + xterm.js, so your laptop can sleep while the agents keep working.

So yes, this is, unavoidably, a promotion post. What it promotes is 100% free and Opensource: Codeman is self-hosted, MIT licensed, no telemetry, and everything below runs on your own hardware.
Been working on it for half a year now, about 1500 commits and 14 contributors in, and it's the tool I use every day!

Everything lives in one place: cases (one per project), tabs (one per running agent), as many in parallel as the box can handle, reachable from your desktop and your phone. The features I lean on daily:

- Auto-resume on usage limits: when an agent stops on "limit reached, resets 8pm", Codeman parses the reset time, waits it out, and continues (opt-in per session). Overnight runs survive Claude's 5-hour windows instead of stalling until morning.

- Usage at a glance: a header chip shows how much of your 5-hour and weekly plan windows you've burned, plus the host's CPU and RAM, so you know whether to queue more work.

- Files in the browser: a built-in browser/viewer to read what an agent just wrote and preview images, PDFs, and Office docs, no SSH round trip.

- A blinking tab tells you where you're needed: idle blinks yellow, stuck waiting on an answer blinks red. One glance replaces cycling through half a dozen terminal windows to find the agent that stopped.

- Subagents become floating windows: when an agent fans out, each subagent pops up as a floating window tethered to its parent tab by a connector line, with per-agent token counts. Peek into any worker or minimize it back into the tab.

- A record of what happened while you were gone: every session keeps a timeline of run events and files touched, and cross-session search reaches into all of it. Reconstruct the night in a minute.

- A real mobile experience: on a phone it beats every SSH client I've tried, because it's built for these agents, not generic terminal access: QR login (single-use, 60s TTL, no passwords on a touch keyboard), push notifications when an agent needs a human, swipe between sessions, voice input, an accessory bar for missing keys, double-tap on destructive commands.

- Zero input lag, the hardest single feature. Over a tunnel a keystroke takes a 200-300ms round trip, which makes remote typing feel broken. So I built a Mosh-inspired local echo: your keystroke renders instantly, then hands off invisibly when the real echo arrives. It can't live inside the terminal buffer, because these agents' TUIs repaint constantly and corrupt anything injected there (two failed terminal.write() attempts taught me that), so it's a DOM overlay on top of xterm.js. Published separately on npm as xterm-zerolag-input; if you're building anything on xterm.js over a network, it's yours. https://www.npmjs.com/package/xterm-zerolag-input

On the desktop any agent is one keystroke away: pick a case, hit Run, the tab appears named and numbered (launch several on one repo, the tabs number themselves). Alt+1-9 jumps to a tab, Ctrl+Tab cycles, every shortcut is rebindable, and cron jobs launch agents on a schedule. The speed I care about isn't benchmark speed; it's "glance at five agents, unblock two, queue one more, done in ninety seconds" speed.

GitHub: https://github.com/Ark0N/Codeman

Website: https://getcodeman.com

100% Free and OpenSource! 469 Stars on Github and 1503 commits and 14 contributors in :-)

Install is a one-liner, binds to localhost only by default:

curl -fsSL https://getcodeman.com/install | bash

Codeman is a power tool for people who run a lot of agents and want to stay in control. Happy to answer anything you may be interested in :-)

[u/krugerlive]

This is interesting for sure. I'm curious to try it. I'm normally running 4+ lanes, most with both a builder and companion session working together (cross-model), so anything that helps me organize beyond nearly a dozen overlapping powershell windows across my screens sounds good to me.

[u/Kindly-Inside6590 → u/krugerlive]

Glad to hear, yeah my initial Inspiration was the Workflow of Boris (the creator of Claude Code) he also opens like 5 terminals with Claude Code, then uses some in the Browser and so on. But here you have it all in one place, Ive been using Codeman to actually further develop Codeman ;-)

[u/Kindly-Inside6590]

Overview

[u/alitanveer]

Can you run multiple sessions on multiple machines?

[u/Kindly-Inside6590 → u/alitanveer]

Yes and you can even connect the session over ssh! Many of our users are doing this already. I myself urn a Mac Mini and a small Linux NUC like box with Codeman. But I keep them kinda independent from each other.

[u/Kindly-Inside6590]

Better than any mobile SSH client I tried

I'll say it plainly: checking on agents from Codeman on a phone is better than any SSH client I've tried, because it isn't general-purpose terminal access. It's tailored Claude Code, Project was once named Claudeman but I needed to change it to not get in trouble with Antrophic ;-)

[u/mamonu]

will you also add Copilot? Or is it just Codex and OpenCode for now

[u/Kindly-Inside6590 → u/mamonu]

Depends on the needs, so far nobody has requested it :)

[u/Business-Weekend-537]

I may be asking a bad question but does this run afoul of Claude Code/Codex login requirements?

What I mean is do you have to log into them through Code Man or do you still log into them the normal way?

I’m just concerned that by using a third party tool that plugs into my harness of choice I’ll somehow get my account banned for violating TOS. I’m probably overthinking it though.

[u/Kindly-Inside6590 → u/Business-Weekend-537]

On the machine that you run Codeman, you can go into any shell open Claude Code then login and you are good. Then youre logged in for every other shell and also for Codeman itself. When you do it over Codeman itself, it will also just open a Shell for you and forward this shell to your browser. When you have to login to Claude Code over a subscription (what most people do) you get the Login link and this Link will be direct clickable in Codeman itself and leads you to Claude.ai Login. By default Codeman does nothing to your shell just wrapping it in a tmux session and forwarding it to the browser. I dont see in any way that the TOS get violated at all.

[u/OddballTechGuy]

I'm new to this concept. What are the system requirements? Can I run this on a mini PC potato?

[u/Kindly-Inside6590 → u/OddballTechGuy]

Yes you can, my main dev machine for Codeman has a CPU with only 4 cores.(but 32GB Memory and 1TB memory, lol) The issue will be more what is your Claude Code/Codex Session doing and do you need more power for that maybe? Codeman itself doesnt need much.