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 TelegramJoin r/foreman for show-and-tells, threaded discussion, and long-lived Q&A the whole web can find and search.
Open RedditLonger-form Q&A, RFCs, and feature proposals live on GitHub — the durable record the whole project searches.
Browse DiscussionsForeman is strict TypeScript on Node 22.12+, in a single repo. Read CONTRIBUTING.md and AGENTS.md first. Here's the whole loop.
Fork on GitHub, then clone your fork and install dependencies.
Create a branch, build, and try it against an isolated FOREMAN_HOME, never your real one.
Run lint and tests, push, and open a pull request against main with a linked issue.
# 1 · fork + clone + install $ gh repo fork tuzlu07x/foreman --clone $ cd foreman && npm ci # 2 · branch + try it in an isolated home $ git checkout -b fix/my-change $ npm run build $ FOREMAN_HOME=./.foreman-dev node dist/cli/index.js start # 3 · check + push + open PR $ npm run lint && npm test $ git push origin fix/my-change
Risk rules, integrations, agent adapters or TUI polish. Pick a scoped issue; for anything bigger than a small fix, discuss the plan in the issue first.
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. Security issues go to a private advisory, not a public issue.
Add an agent, an MCP catalog server or an integration to the bundled 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.
Telegram, Slack and Discord (tap-to-approve), email, ntfy, signed webhooks and OS notifications ship today. Add another channel.
Post the policy.yaml rules that work for you in Discussions so others can copy them into their own.
Say hi, claim an issue, or just lurk and learn. Everyone's welcome on the site.