The foreman works best with a crew.
Say hi, claim an issue, or just lurk and learn. Everyone's welcome on the site.
Foreman is open source and MIT-licensed. Jump into the chat, send a pull request, or build something on top — the foreman works best with a crew.
Real-time chat with the crew. Ask questions, share policy packs, get help wiring up agents, and follow release chatter.
Join DiscordPrefer Telegram? The group mirrors Discord for announcements and quick questions — handy since Foreman ships a Telegram notifier too.
Open TelegramLonger-form Q&A, RFCs, and feature proposals live on GitHub — the durable record the whole project searches.
Browse DiscussionsForeman is TypeScript, Node 20+, and a single repo. If you can run it, you can hack on it. Here's the whole loop.
Fork on GitHub, then clone your fork and install dependencies.
Create a feature branch and run the dev gateway with hot reload.
Run the suite, push, and open a pull request against main.
# 1 · fork + clone + install $ gh repo fork tuzlu07x/foreman --clone $ cd foreman && npm install # 2 · branch + run dev gateway $ git checkout -b feat/my-change $ npm run dev # 3 · test + push + open PR $ npm test $ git push origin feat/my-change
New risk rules, transports, agent adapters, or TUI polish. Pick an issue or pitch an RFC.
Clarify a command, add a recipe, fix a typo. Docs live in the same repo as the code.
Hit something odd? File a reproducible issue with foreman doctor --json output.
Wrap a new agent or notifier and publish it for the registry. See the ecosystem below.
Everything routes through MCP and a small set of registries — so the surface area you'd build against is small and documented.
Add your agent to the registry so anyone can foreman agent add it with auto-install.
Discord, Telegram, and Slack ship today. Add a notifier and approvals reach your team anywhere.
Bundle battle-tested risk rules as a policy pack the community can drop into policy.yaml.
Say hi, claim an issue, or just lurk and learn. Everyone's welcome on the site.