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:

Claude Code Codex GitHub Copilot Grok opencode Kimi Ollama Cloud Hermes

_{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: ```bash 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: ```bash timon service install --dry-run # shows what will be installed timon service install ``` The [installation guide](https://docs.timon-ai.com/installation/overview) covers each system, remote access from your phone, updates and troubleshooting. **From source.** Clone this repository and follow [GETTING-STARTED.md](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](https://timon-ai.com/pricing) |

_{A licence never replaces your CLI subscription, and Timon never calls a token-billed API on your behalf.}

## 🧩 How it fits together ```mermaid flowchart LR you(["🧑 You"]) --> clients["Clients
Desktop · Browser · Phone
CLI · Telegram"] clients <--> daemon["Daemon
Cordis kernel
~50 bundled plugins
SQLite"] daemon --> agents["🤖 Agent CLIs
Claude Code, Codex, …"] daemon --> worktrees["🌿 Git worktrees
one per task"] daemon <--> plugins["🧩 Plugins
signed, hot-installed"] agents <--> tools["🔌 MCP tools
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](https://github.com/deepseek-ai), 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`](https://www.npmjs.com/package/@timon-ai/sdk), publish on npm. - [Plugin quickstart](https://docs.timon-ai.com/plugins/quickstart) - [One template per kind](https://docs.timon-ai.com/plugins/examples) - [SDK reference](https://docs.timon-ai.com/plugins/api-reference) ## 🤝 Community Bug reports, translations and plugins are welcome. - **Want to change the code?** Read [CONTRIBUTING.md](CONTRIBUTING.md): how to run the checks, and the rules a review looks at. Your first pull request asks you to sign the [CLA](CLA.md). - **Found a bug?** [Open an issue](https://github.com/ai-timon/timon/issues/new/choose) 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](CONTRIBUTING-TRANSLATIONS.md). - **Found a vulnerability?** Report it privately, as [SECURITY.md](SECURITY.md) explains. - Questions, plugins and show-and-tell go to [Discord](https://discord.gg/ZQGARNcpZ3). If Timon saves you a few hours, a ⭐ helps a lot.

## 📜 License Timon is free software under the [GNU AGPL v3](LICENSE), with an exception that leaves plugins free to use any licence: [LICENSING.md](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](TRADEMARKS.md). Third-party components are credited in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).