Skip to content

Site radio · Foreman on your phone

Control Claude Code from your phone. Run the site from anywhere.

Foreman is a free, open-source desktop app for macOS and Windows that runs AI coding agents in parallel. Claude Code, Codex, Cursor and OpenCode each work in their own git worktree on their own branch, while you review diffs, answer questions and open pull requests from one window.

Pair a phone with a QR code and answer the crew from the couch, or from the train over your own Tailscale network. No Foreman relay. No account.

  • macOS & Windows
  • Apache-2.0
  • No account
  • No relay

Coming soon Native iOS and Android apps

Today: pair your phone with a QR code and add the phone view to your Home Screen.

Try it · Illustrative

Pair and answer

Pair a phone, choose what it may do, then answer the crew. Turn the dial to change where you are.

  1. 1Pair a phone from the computer
  2. 2Scan the QR, good for 2 minutes
  3. 3Same six-digit code on both screens
  4. 4Pick what it may do
  5. 5Answer from wherever you are
Foreman · atlasThis computer
iPhone · Operate

atlas

  • osakaNeeds you▲
  • lisbonWorking
  • kyotoWorking
osakafix-login-redirectClaude Code
the login page loops after sign-in
Found it: the session cookie was set after the redirect. Moved the redirect after setSession() and added a test. npm test: 214 passed.

▲ Needs you · Claude Code

Run this command?

git push origin fix-login-redirectPush 1 commit to origin▲ Leaves this computerCan’t be undone

Answer here with Yes or No, or on the phone with Allow or Deny.

Foreman

Same Wi-Fi
AllNeeds you · 1Working
  • osakaatlasnowWants to run git push origin fix-login-redirect1
  • lisbonatlas2mReading src/middleware
  • kyotoatlas4mfix-until-green · checks running

Phone alerts need private HTTPS access.

Your phone · the phone web app, today

CH 01 · DeskThis window

At the desk

The window itself

Answers
On the window or the phone. The other one updates at once.
Phone
Paired over same Wi-Fi or Tailscale, it works here too.
Push alerts
Not needed: you are looking at it.

CH 02 · CouchSame Wi-Fi

Same Wi-Fi, direct

http://192.168.1.24:47633

Security
Plain HTTP, for a network you trust. Requests from outside the subnet are refused.
Sign-in
Lasts a day.
Push alerts
No. Alerts need the private connection (HTTPS).

CH 03 · TrainTailscale

Anywhere, over your tailnet

https://studio.tail4a2b9.ts.net

Security
HTTPS through tailscale serve, private to your tailnet. Never Funnel.
Sign-in
Lasts a year.
Push alerts
Yes. On iPhone, from the Home Screen web app.

CH 04 · Another laptopBrowser /app

The whole app in a browser

https://studio.tail4a2b9.ts.net/app

Works
Everything the window does, within the access you approved. Full control lives here.
Not here
File pickers, Open in…, previews, dictation and updates.
Sign-in
The same link, code and access levels as a phone.

No Foreman relay · no account · Foreman must be running

Copy that

What can you do with Claude Code from your phone?

Answer what is waiting, steer the agent, comment on the diff and watch it work, live. The phone is a remote for Foreman on your computer: the agents, worktrees, git and terminals all stay there.

  • Answer what waits for you

    Tool approvals, plans and questions, plus flow gates (Continue, Send back, Stop) and picks.

    Needs you
  • Queue or steer

    A message waits for the turn to end, or goes into it now. Queued ones can be sent now or deleted.

    Steer
  • Comment on diff lines

    In Changes, tap a line to comment, removed lines included. Comments go with your next message.

    Changes
  • Read terminals

    The last 500 lines of each terminal and run script, live, as plain text.

    Read-only
  • See usage, resume after a limit

    Context, turns, agent time and cost. A chat paused at a usage limit offers Resume now or another account.

    Usage
  • Start and archive workspaces

    New workspace starts an agent in a fresh worktree. Archive keeps the branch.

    Workspaces

Negative. A phone can't:

  • Type into a terminal. The Terminal tab is read-only. Typing stays on the computer.
  • Answer an AI employee's held action. A held Slack post or Linear change waits for the window.
  • Change settings, keys or integrations. The phone page stops at Operate. Full control is for a browser.

Live, over a WebSocket

The inbox and the open chat change the moment something happens; a reply appears as the agent writes it. If the line drops, the page says Reconnecting… and catches up.

A Foreman workspace: the agent's chat in the middle and its changes on the right
Base station The window your phone talks to: the agent's chat in the middle, its changes on the right.

Frequencies

How does your phone reach Foreman away from home?

Through your own Tailscale network. On the same Wi-Fi the phone talks to your computer directly; anywhere else it goes through tailscale serve on your tailnet, as private HTTPS. There is no Foreman relay and no account, and both connections are off until you turn them on.

Channel A

Same Wi-Fi

Direct, for a network you trust.

Address
http://192.168.1.24:47633
Security
Plain HTTP. Listens on one private address and refuses requests from outside its subnet.
Sign-in
Lasts a day.
Push alerts
No. They need HTTPS.
foreman phone link --lan --qr

Channel B

Anywhere, over Tailscale

Private HTTPS on your own tailnet.

Address
https://studio.tail4a2b9.ts.net
Security
HTTPS through Tailscale Serve. Never Funnel, which would make it public. Foreman listens only on 127.0.0.1:47632.
Sign-in
Lasts a year.
Push alerts
Yes, over this private connection. On iPhone they need the Home Screen web app.
tailscale serve --bg 47632

How does pairing work?

With a QR code or a link, good for two minutes. The phone and the computer then show the same six-digit code; you check it, choose what the phone may do, and approve. To change a device's access, revoke it and pair it again.

  • Watch

    See workspaces, chats, diffs and checks. Change nothing.

    Requests show, with no buttons.

  • Operate

    Also send messages, answer approvals, run checks and archive.

    The default.

  • Full control

    Also change settings, repositories, keys and integrations.

    For a browser. The phone page offers nothing beyond Operate.

The rest of the kit

Can I use Foreman from another computer?

Yes. A browser on another computer opens the whole app at /app, with the same sign-in and access levels, and one Foreman window can drive another paired computer's Foreman on the same network.

  • Browser

    The whole app at /app

    A browser on another computer opens the full window at /app on the same address, with the same sign-in and access levels.

    foreman phone link --browser

  • Headless

    No window, still on air

    Foreman can run without a window, so agents, schedules, phones and browsers keep working. Install it once and it starts from login.

    foreman service install

  • Another computer

    Drive a paired computer

    One window can show and drive another computer’s Foreman, Mac or Windows, on the same network. Or hand a workspace off to it.

    Settings → Data & devices

  • Revoke

    Sign a device out at once

    The phone dialog lists every phone and browser with its access, connection and when it was last seen. Revoke signs one out instantly.

    foreman phone revoke iPhone

On the way

Is there an iOS or Android app for Foreman?

Native iOS and Android apps are coming soon. Today the phone view is a web app that Foreman serves from your computer: pair it, add it to your Home Screen, and turn on alerts over the private connection.

To hear first, watch the repository on GitHub: Watch → Custom → Releases.

Channel guide

What else is on the site?

The same Foreman runs the rest of the job: schedules and auto-fix, flows, integrations, AI employees and remote sandboxes, all on top of one git worktree per agent.

  1. CH 05

    One worktree per agent

    Every workspace is its own git worktree on its own branch. Agents never step on each other, and your main checkout stays clean.

    The core
  2. CH 06

    Automations and schedules

    Save prompts as templates and run them on demand or on a schedule: hourly, daily, weekly or monthly, in your time zone. Run Foreman without a window, or at login, and schedules keep going.

    Runs on Claude Code
  3. CH 07

    Auto-fix CI and auto-review

    Opt in and Foreman sends a failing CI log to your agent within a budget you set, and a read-only reviewer reads each finished diff. Checks can run after every turn, and a chat that hits a usage limit resumes by itself.

    Opt-in · within a budget
  4. CH 08

    Flows that loop until green

    Write a way of working down once as a graph of agent steps: loops that run until the checks pass or a review comes back clean, and gates where you decide.

    11 built in · experimental
  5. CH 09

    GitHub, GitLab, Linear, Slack, Langfuse

    Open, merge and auto-merge pull requests, watch CI and reviews, start work from a Linear issue, send Slack notifications and read Langfuse traces. Each connection gets the agent access you choose: nothing, read, or read and write.

    Each with its own access
  6. CH 10

    AI employees

    Give an organization employees with a role in plain words, a hard hat and access you approve. They work in fresh workspaces, remember through a git memory repository and hand work to each other.

    15 job templates
  7. CH 11

    Remote sandboxes: E2B, Daytona, Vercel, Docker

    Run a workspace's worktree and agent in a sandbox on your own E2B, Daytona, Vercel Sandbox or Docker account. Provider keys never enter the sandbox, and turns keep going after you close the app. Experimental.

    Experimental
  8. CH 12

    Agents that use Foreman too

    Every workspace agent gets a foreman-app MCP server to check its status, run checks and, if you allow it, hand tasks to other agents. A Claude Code or Codex session you run yourself can sign in to Foreman over MCP.

    foreman-app MCP server

Other stations

How is Foreman different from Conductor and T3 Code?

Foreman is open source under Apache-2.0 and runs on Windows as well as macOS, while Conductor is a closed-source Mac app. Next to T3 Code, Foreman adds flows that loop until checks pass, AI employees and a CLI where every command takes --json.

A dash means not listed on their site

Foreman compared with Conductor and T3 Code
FeatureForemanConductorT3 Code
Open sourceApache-2.0NoMIT
macOSYesYesYes
WindowsYesMac onlyYes
One git worktree per agentYesYesYes
AgentsClaude Code, Codex, Cursor, OpenCode, any ACP agentClaude Code, Codex, CursorClaude Code, Codex and more
Flows that loop until checks pass, with human gatesYes——
AI employees with git-backed memoryYes——
Scheduled automations and auto-fix CIYes——
Your own cloud sandboxes (E2B, Daytona, Vercel, Docker)Experimental——
Scriptable CLI, --json on every commandYes——
Approve from your phoneYes—Yes
No account, no telemetry uploadYes——
From each project's own site as of November 2026. “—” means it isn't listed there, not that it's missing. Spot a mistake? Tell us.

Radio check

Get started in a minute

Download the app, add a repository, start the crew. Then pair your phone from the button at the top of the sidebar.

  1. Download Foreman

    Free for macOS (Apple Silicon) and Windows. You need Git on your PATH.

    Download Foreman
  2. Add a repo, sign in an agent

    Pick any git repository. Sign in Claude Code, Codex, Cursor or OpenCode in Settings → Agents with your own login or key.

  3. Create workspaces, then pair

    One workspace per task, each a fresh worktree on its own branch. Then press the phone button, Show QR code, and scan.

From a terminal: start a job, then see what waits for you.
foreman run fix-a-bug "the login page loops after sign-in" --repo atlas --wait
# Start a workspace from a template and wait for the turn
foreman approvals
# See what is waiting for you
foreman phone link --lan --qr
# A one-time pairing link, good for two minutes, drawn as a QR code

CLI reference · every command takes --json

Open channel

Questions developers ask

Something missing? Open an issue or read the guide.

What is Foreman?

Foreman is a free, open-source desktop app for macOS and Windows that runs AI coding agents in parallel. Claude Code, Codex, Cursor and OpenCode each work in their own git worktree on their own branch, while you review diffs, answer questions and open pull requests from one window.

Is Foreman free and open source?

Yes. Foreman is free and licensed under Apache-2.0, with the full source on GitHub at github.com/elite-build/foreman. There is no paid tier, no account and no Foreman cloud service.

Which coding agents does Foreman support?

Foreman runs Claude Code, Codex, Cursor and OpenCode, plus any agent that speaks the Agent Client Protocol (ACP). Each agent signs in with your own subscription or API key, set in Settings → Agents.

How do I run multiple Claude Code agents in parallel?

Add a git repository to Foreman and create one workspace per task. Each workspace is a separate git worktree on its own branch, so several Claude Code sessions edit the same repository at once without conflicts. Tiles shows them side by side.

Why does each agent need its own git worktree?

A git worktree is a second checkout of the same repository on a different branch. Giving each agent its own worktree means agents never overwrite each other's files, every change lands on a reviewable branch, and your main checkout stays untouched.

Does my code leave my computer?

Only through the agents you choose. Foreman runs locally with no account and no telemetry upload; your agents talk to their own model providers. In your own workspaces, an approval marks any command that leaves your computer before it runs, and AI employees hold Slack posts and Linear changes for you.

Do coding agents need my approval for every command?

Only if you want them to. Approvals are a setting: with Claude Code tool approvals on (Settings → Account), each command is spelled out part by part before it runs, anything that leaves your computer is marked, and Always allow shows exactly what it adds. Every agent still works in its own worktree, and checkpoints rewind any turn.

Which operating systems does Foreman run on?

Foreman runs on macOS (Apple Silicon, signed and notarized) and Windows. You need Git on your PATH and a login or API key for at least one agent.

Can Foreman run coding agents on a schedule?

Yes. Any saved prompt template can run hourly, daily, weekly or monthly in your time zone, and opt-in auto-fix sends failing CI logs to your agent. Scheduled runs use Claude Code and happen while Foreman is running, which can be without a window or from login.

Can I control Foreman from my phone?

Yes. Pair a phone with a QR code to answer approvals, steer agents, comment on diffs and read terminals, live. On the same Wi-Fi it connects directly, and anywhere else through your own Tailscale network. Native iOS and Android apps are coming soon.

Can coding agents run in a cloud sandbox like E2B?

Yes, as an experiment. A workspace's worktree and agent can run in a sandbox on your own E2B, Daytona, Vercel Sandbox or Docker account, for Claude Code, Codex and OpenCode. Provider keys stay on your computer and never go into the sandbox.

Which integrations does Foreman have?

GitHub (pull requests, merges, CI and reviews), GitLab, Linear, Slack and Langfuse, plus MCP. Each connection has a default per service, each repository can pick its own, and you choose what agents may do with it: nothing, read, or read and write.

How is Foreman different from Conductor?

Foreman is open source under Apache-2.0 and runs on Windows as well as macOS, while Conductor is a closed-source Mac app. Foreman also drives OpenCode and any ACP agent, and adds flows that loop until checks pass, AI employees and a scriptable command line.

How is Foreman different from T3 Code?

Both are open-source GUIs for coding agents. Foreman adds flows (agent graphs that loop until tests pass, with human gates), AI employees with a git-backed memory, a foreman CLI where every command takes --json, phone approvals and remote sandboxes.

Can I script Foreman or use it in CI?

Yes. The foreman command starts workspaces, sends messages, answers approvals, opens and merges pull requests and runs flows. Every command takes --json and exit codes are the same for every command.

Over to you.

Foreman is three weeks old: 31 releases since 1.0.0 on 27 October, built in the open under Apache-2.0. Star it so you hear about the next one and the native apps, fork it, or pick up a good first issue and join the crew.