Show HN: Timon, an open-source AI workstation for coordinating agents

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}

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.}

🧭 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

_{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.

Same app, same features. Pro adds what a team needs.

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

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.

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.

Bug reports, translations and plugins are welcome.

• Want to change the code? ReadCONTRIBUTING.md : how to run the checks, and the rules a review looks at. Your first pull request asks you to sign theCLA .
• Found a bug?Open an issue with your version and the output oftimon 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: seeCONTRIBUTING-TRANSLATIONS.md .
• Found a vulnerability? Report it privately, asSECURITY.md explains.
• Questions, plugins and show-and-tell go to Discord .

If Timon saves you a few hours, a ⭐ helps a lot.

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.