Jinn

🧞 Jinn

Run your AI agents as a company.

  Jinn turns the agent CLIs you already use - Claude Code, Codex, Grok, Hermes - into a persistent AI company:
  named employees, a durable Todo ledger, and reusable Workflows,
  all operated from a chat and web dashboard.
  It doesn't replace your agents. It gives them an org to work in.
You bring the engines. Jinn runs the company.

Why Jinn?

Agent CLIs are powerful alone. Jinn gives them shared structure, ownership, and history.

- 🎼 Bus, not brain. Jinn conducts the agent CLIs on your PATH and adds no AI logic. Better engines make Jinn better automatically.
- 🏢 A real org. Define named employees, ranks, departments, and reporting lines in YAML. Your COO delegates through the hierarchy.
- 📋 Durable work. Todos preserve ownership and review beyond a session; the built-in MCP gives employees typed company tools.
- 🔁 Reusable automation. Workflows combine sequential, conditional, parallel, and switch paths with per-phase models, approvals, triggers, and run history.
- ⏰ Work with receipts. Cron, delegation, callbacks, and Workflows keep running and leave structured activity in Chat.
Jinn is beta. It works today and moves fast; read the upgrade notes when you bump versions.

Quickstart

Native install
Prerequisites: Node.js 22 or newer (the repository pins 24.13.0 in .nvmrc), and at least one agent CLI installed and signed in. Jinn orchestrates your engines and can't run a session without one.

Open http://localhost:7777 and send your first message.

Or install via Homebrew:
--version ≠ signed in. Jinn drives the official engine CLIs, so authenticate each one *before* jinn start (run claude → /login, run codex to sign in, and so on). Without this, sessions can't reach the models - the most common fresh-install…