Repository navigation
v2.3.0
Foreman 2.3.0 runs your agents like a company, and keeps guarding them when no terminal is open.
Run your agents like a company
- Several roles on one agent. You can run Claude Code or Codex as several teammates:
foreman agent add backend --type codex.- Each teammate has its own identity, role and audit trail.
- They talk to each other through Foreman.
- Ready-made roles, or your own.
foreman org roleslists the ready-made roles: manager, developer, code reviewer, researcher, writer, analyst, support and assistant.- Add one with
foreman org add-role reviewer --preset code-reviewer --runs-on claude-code. - Or describe your own:
--describe "…".
- Add one with
- Permissions per role.
--can read,write,shell,networklimits what a role's agent may do. A reviewer that may only read can't edit a file, whateverpolicy.yamlsays, and the agent is told why. - Set up the team in the setup wizard. A new optional last step, Your team.
- A Team page in the TUI (
t). See the org chart, then pressnto add a role.
Approvals from anywhere
- No terminal needed.
foreman service installnow runs the whole gateway: approvals reach Telegram, Slack or Discord with no terminal open.foreman startattaches to the running service. - One Telegram bot is enough. It carries notifications, approval buttons and
/foreman. Plain messages such asreport meare read-only questions. - Chat with Foreman in the TUI (
c).
Safer
- Catastrophic commands are refused outright.
rm -rf /(and~,/usr…),mkfsorddonto a disk, and fork bombs no longer ask; they are denied. - Claude Code's hook fails closed when Foreman can't run. After upgrading, run
foreman agent hook install claude-codeonce. foreman agent addno longer prints the agent's private key.
A clearer TUI
- Every page fits in the tab bar.
- Policy says what each rule does in plain words.
- Services shows each chat app's mode.
- Providers shows how each provider is connected.
- Rows stay on one line, with long paths shortened.
- Repeated crash notices are grouped.
- Home shows your team and the next steps.
Upgrade
npm install -g foreman-agent@2.3.0
foreman agent hook install claude-code
foreman service installThe CHANGELOG has the full list.