Newshot 
Timon
Your AI agent team, running on your own machine. They work through the CLI subscriptions you already pay for, ship code that has been reviewed, and ask you before anything that matters.
Download for Windows, macOS or Linux » Docs · Website · Discord · Changelog · Write a plugin
Your agents run on the CLI you already sign in to:
your subscription, never a token-billed API · any ACP agent · add your own as a provider plugin
👋 Meet your agent team
You tell Timon what you need, in plain words. The orchestrator splits the job into tasks and hands each one to the right agent: one codes, another reviews with a different model, a third merges. Every agent has a role, its own skills and a memory that follows it from mission to mission. You follow everything from one cockpit and step in whenever you want. They ask before they push, publish or delete anything.
The team every project starts with:
| Orchestrator Plans the job, dispatches the tasks, keeps track of what is blocked | Coder Works in its own git worktree, runs the checks, commits step by step | Reviewer Reads the diff with another model and sends it back when it is not right |
|---|---|---|
| Merger Runs the full test suite once, then lands the branch | Researcher Digs through the code and the web, and turns an idea into a brief | Ops Handles the chores: dependencies, clean-ups, release notes |
Roles are fields, not names: rename them, add your own, import agents you already have.
✨ Features
🧭 The orchestrator runs your team. Describe the job, out loud if you like. It breaks it down, lets you pick the models for each part on one screen, then dispatches and follows the work until it lands.
| 🔀 Code, review, merge Every task in its own worktree, reviewed by a second model before it lands | ✋ You stay in charge Questions with buttons, permission cards, secrets the agent never sees |
|---|---|
| 🌙 Work while you sleep Routines, cron and webhook triggers, overnight series paced to your quotas | 🧩 Make it yours Widgets, pages, themes, layouts: signed plugins installed without a restart |
And everything else a team of agents needs:
- 🧠 Memory that reaches the agent: a rule learned once is injected into the next mission
- 🔁 Missions that survive: every turn and tool call is kept, a dead mission is resumed
- 🪂 Quota fallbacks: when one subscription runs dry, the work moves to the next backend
- 🌐 A built-in browser: isolated per mission, with annotations and recordings
- 🎙️ Voice: dictate a request, hear the answer
- 📱 Reachable anywhere: desktop app, browser, phone, Telegram, CLI, remote API
- 🖥️ Three systems, one service: Windows, macOS and Linux, running in the background
🚀 Quick start
Windows 10+ (x64) · macOS 11+ (Apple silicon) · Linux x64, glibc 2.28+
You need one agent CLI already signed in: claude, codex, copilot, grok, opencode, pi or hermes-acp. The installer brings its own Node.js, and on Windows installs Git when it is missing.
Once it is running, check that everything is in place:
timon doctor # checks the service, the backends and the paths
timon backends # lists the agent CLIs Timon found
That's it: open Timon and say hi to your orchestrator. 🎉
On a server without a screen, install the background service from the terminal:
timon service install --dry-run # shows what will be installed
timon service install
The installation guide covers each system, remote access from your phone, updates and troubleshooting.
From source. Clone this repository and follow GETTING-STARTED.md: the daemon and the web app run on all three systems without the desktop app.
💳 Free or Pro?
Same app, same features. Pro adds what a team needs.
| 🧑 Free | 👥 Pro | |
|---|---|---|
| Agents, missions, Kanban, memory, routines | ✅ | ✅ |
| Every bundled module and every third-party plugin | ✅ | ✅ |
| Your CLI subscriptions, quota fallbacks | ✅ | ✅ |
| Desktop, browser, phone, Telegram, CLI | ✅ | ✅ |
| Several users, roles and groups, per-person permissions | ✅ | |
| Support | Community | ✅ |
| Price | Free | See plans |
A licence never replaces your CLI subscription, and Timon never calls a token-billed API on your behalf.
🧩 How it fits together
flowchart LR
you(["🧑 You"]) --> clients["<b>Clients</b><br/>Desktop · Browser · Phone<br/>CLI · Telegram"]
clients <--> daemon["<b>Daemon</b><br/>Cordis kernel<br/>~50 bundled plugins<br/>SQLite"]
daemon --> agents["🤖 Agent CLIs<br/>Claude Code, Codex, …"]
daemon --> worktrees["🌿 Git worktrees<br/>one per task"]
daemon <--> plugins["🧩 Plugins<br/>signed, hot-installed"]
agents <--> tools["🔌 MCP tools<br/>Timon + your servers"]
The daemon runs as a plain service on your machine (systemd, launchd or a Windows scheduled task) and holds all the state. The clients hold none: close the app and your agents keep working.
Built with TypeScript, Node.js 22, Cordis, SQLite, Next.js, React, Tailwind and Electron.
🔌 Write a plugin
Product surfaces and third-party plugins are written the same way: a widget, a page, a theme, a layout, a provider or a bundle of them. Start from a template, build against @timon-ai/sdk, publish on npm.
- Plugin quickstart
- One template per kind
- SDK reference
🤝 Community
Bug reports, translations and plugins are welcome.
- Want to change the code? Read CONTRIBUTING.md: how to run the checks, and the rules a review looks at. Your first pull request asks you to sign the CLA.
- Found a bug? Open an issue with your version and the output of timon doctor. An issue without them is closed with a link to the guide.
- Speak another language? The interface is translated by pull request, without touching any code: see CONTRIBUTING-TRANSLATIONS.md.
- Found a vulnerability? Report it privately, as SECURITY.md explains.
- Questions, plugins and show-and-tell go to Discord.
If Timon saves you a few hours, a ⭐ helps a lot.
📜 License
Timon is free software under the GNU AGPL v3, with an exception that leaves plugins free to use any licence: LICENSING.md explains what that means for you. The SDK and the plugin templates are under the MIT licence. The name, the logo and the mascot are not covered by these licences: see TRADEMARKS.md. Third-party components are credited in THIRD_PARTY_NOTICES.md.