An animated walkthrough of the app in five chapters: add a repository, start a workspace and see its worktree, run several and ship one, make an organization, hire AI employees. The stage directions live inhow-it-works/script.ts.
Defaults <HowItWorks id="hw-default" />
Watch it work
How Foreman works
Five short scenes, from an empty window to a team of AI employees. Pick any step to jump to it.
Open a folder on your computer, clone one from GitHub or start a new project. Foreman remembers where it lives and writes nothing into it.
Every task gets a workspace: a new branch in its own git worktree, with its own ports and terminal, so agents never collide.
Start as many workspaces as you like with Claude Code, Codex, Cursor or OpenCode, then read each change as a diff and open the pull request.
An organization is a space with its own repositories, AI employees and memory. Personal stays as it is.
An AI employee is a standing member of an organization: a name, a role, a hard hat, instructions, memory and the access you approve.
Foreman
Foreman
Get started
Sign in to an agent
Add a project
Start a workspace
See what needs you
Try Tiles
What a workspace is
Your repository~/foreman/repos/atlasmainUntouched
git worktree add
Workspace tesla~/foreman/workspaces/atlas/teslaalex/teslaalex/fix-login-redirectIts own branch and terminal
Ports 50150–50159 FOREMAN_PORT=50150
Setup copies .env, runs your setup script
Ready creating → setting up → ready
teslaalex/fix-login-redirectOpus 5.5
Fix the login redirect loop
Editsrc/login.ts+2 −2
Editsrc/redirect.ts+4
Runnpm testPassed
The form never passed the page you came from. Now it does, and the redirect stays on this site. Completed · 1m 24s
Ask Claude Code to make changes, @mention files, run /commands
ReviewCommit and pushCreate PR
Changes
login.ts+2 −2
redirect.ts+4
session.ts+1 −1
Review: no issues found
Committed
PR #42
Checks 3/3
Team · AcmeEmployees · 1Employees · 2
+ New employee
PriyaProgram manager · plans projects and proposes who you need
QuinnStaff QA engineer · Claude Code · Opus 5.5
acme-memory 3f2a9c1 Quinn: the checkout tests need a seeded cart Foreman-Employee: quinn
▲ Needs youQuinn · Slack post
Post the test report to #releases
Review…
New employee · Acme
Pick a jobWrite your own
Software engineer Ravi
QA engineer Quinn
Security engineer Omar
UX designer Uma
Technical writer Theo
Support engineer Jonah
Who you get
Quinn · Staff QA engineer Reviews what others build and says what breaks.
Adding approves Quinn at once: Write on atlas. Quinn pushes and opens pull requests without waiting for you.
Add
Clone GitHub repo
Repository URL
Location~/foreman/repos
Cloning…Clone repo
New workspace atlas
New worktreeExisting worktreeRepository folder
Start frommain
BranchNew branch
ModelClaude Code · Opus 5.5
First message (optional)
Create workspace
New organization
Its own repositories, AI employees and memory. Personal stays as it is.
Name
Bring in☑ atlas
Your team · 2 membersYou · person · decides at every gatePriya · program manager · plans projects and proposes who you need
Makes acme-memory beside your repositories, private to this computer.
Create
Open a folder on your computer, clone one from GitHub or start a new project. Foreman remembers where it lives and writes nothing into it.
No heading, framed, waits for Play heading=false · autoPlay=false
Open a folder on your computer, clone one from GitHub or start a new project. Foreman remembers where it lives and writes nothing into it.
Every task gets a workspace: a new branch in its own git worktree, with its own ports and terminal, so agents never collide.
Start as many workspaces as you like with Claude Code, Codex, Cursor or OpenCode, then read each change as a diff and open the pull request.
An organization is a space with its own repositories, AI employees and memory. Personal stays as it is.
An AI employee is a standing member of an organization: a name, a role, a hard hat, instructions, memory and the access you approve.
Foreman
Foreman
Get started
Sign in to an agent
Add a project
Start a workspace
See what needs you
Try Tiles
What a workspace is
Your repository~/foreman/repos/atlasmainUntouched
git worktree add
Workspace tesla~/foreman/workspaces/atlas/teslaalex/teslaalex/fix-login-redirectIts own branch and terminal
Ports 50150–50159 FOREMAN_PORT=50150
Setup copies .env, runs your setup script
Ready creating → setting up → ready
teslaalex/fix-login-redirectOpus 5.5
Fix the login redirect loop
Editsrc/login.ts+2 −2
Editsrc/redirect.ts+4
Runnpm testPassed
The form never passed the page you came from. Now it does, and the redirect stays on this site. Completed · 1m 24s
Ask Claude Code to make changes, @mention files, run /commands
ReviewCommit and pushCreate PR
Changes
login.ts+2 −2
redirect.ts+4
session.ts+1 −1
Review: no issues found
Committed
PR #42
Checks 3/3
Team · AcmeEmployees · 1Employees · 2
+ New employee
PriyaProgram manager · plans projects and proposes who you need
QuinnStaff QA engineer · Claude Code · Opus 5.5
acme-memory 3f2a9c1 Quinn: the checkout tests need a seeded cart Foreman-Employee: quinn
▲ Needs youQuinn · Slack post
Post the test report to #releases
Review…
New employee · Acme
Pick a jobWrite your own
Software engineer Ravi
QA engineer Quinn
Security engineer Omar
UX designer Uma
Technical writer Theo
Support engineer Jonah
Who you get
Quinn · Staff QA engineer Reviews what others build and says what breaks.
Adding approves Quinn at once: Write on atlas. Quinn pushes and opens pull requests without waiting for you.
Add
Clone GitHub repo
Repository URL
Location~/foreman/repos
Cloning…Clone repo
New workspace atlas
New worktreeExisting worktreeRepository folder
Start frommain
BranchNew branch
ModelClaude Code · Opus 5.5
First message (optional)
Create workspace
New organization
Its own repositories, AI employees and memory. Personal stays as it is.
Name
Bring in☑ atlas
Your team · 2 membersYou · person · decides at every gatePriya · program manager · plans projects and proposes who you need
Makes acme-memory beside your repositories, private to this computer.
Create
Open a folder on your computer, clone one from GitHub or start a new project. Foreman remembers where it lives and writes nothing into it.