Repolode
Submit
ai-timon

ai-timon/timon

A self-hosted AI agent team that runs on your machine, using the agent CLI subscriptions you already have to plan, code, review and merge tasks.

View on GitHub
Stars
180
Forks
18
Open issues
1
Last commit
1 hour ago

What is it?

Timon is a desktop and background-service app for running a team of AI agents on your own machine. You describe a job in plain language, and an orchestrator splits it into tasks and hands each one to a role such as coder, reviewer, merger, researcher or ops. Each coding task runs in its own git worktree, and a second model reviews the diff before it lands. Agents ask for confirmation before pushing, publishing or deleting anything.

Agents run through the agent CLIs you are already signed in to, such as Claude Code, Codex, GitHub Copilot CLI, opencode and Pi, rather than token-billed APIs. Missions keep their turns and tool calls, can be resumed after a failure, and can fall back to another backend when a subscription runs out of quota. Memory from earlier missions is injected into later ones.

The daemon holds all state and runs as a systemd, launchd or Windows scheduled-task service, while the desktop app, browser, phone, Telegram, CLI and remote API act as clients. Plugins for widgets, pages, themes, layouts and providers are built with the @timon-ai/sdk package and can be installed without a restart.

Key features

  • 01Orchestrator breaks a job into tasks and dispatches them to role-based agents
  • 02Each coding task runs in its own git worktree and is reviewed by a second model
  • 03Runs through existing agent CLI subscriptions such as Claude Code and Codex
  • 04Quota fallbacks move work to another backend when one subscription runs out
  • 05Background daemon with desktop, browser, phone, Telegram and CLI clients
  • 06Plugin system with signed plugins that install without a restart

Use cases

  • Letting agents implement and review code changes overnight on a personal machine
  • Running scheduled or webhook-triggered routines against a local repository
  • Coordinating several coding agents on one project without sending work to token-billed APIs
  • Controlling long-running agent missions from a phone or Telegram

Quick start

  1. 1

    Download the installer for your system from the releases page

  2. 2

    Make sure one agent CLI (such as claude or codex) is already signed in

  3. 3

    Check that the service, backends and paths are working

    timon doctor
  4. 4

    List the agent CLIs Timon found

    timon backends

Things to know

  • Requires an existing signed-in agent CLI subscription such as Claude Code or Codex.
  • Pro features like multiple users and permissions require a paid plan.
  • Licensed under AGPL-3.0, a copyleft license that applies to modified versions you distribute or host.

In collections

Tools for running coding agents in parallelClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agents

Topics

#ai-agents#coding-agent#orchestration#claude-code#codex#git-worktree#typescript#electron

FAQ

What is timon?
A self-hosted AI agent team that runs on your machine, using the agent CLI subscriptions you already have to plan, code, review and merge tasks. Timon is a desktop and background-service app for running a team of AI agents on your own machine. You describe a job in plain language, and an orchestrator splits it into tasks and hands each one to a role such as coder, reviewer, merger, researcher or ops. Each coding task runs in its own git worktree, and a second model reviews the diff before it lands. Agents ask for confirmation before pushing, publishing or deleting anything.
Is timon free to use? What license does it have?
timon is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is timon still maintained?
Actively maintained. The last commit to timon was on Nov 7, 2026.
What can I use timon for?
Letting agents implement and review code changes overnight on a personal machine Running scheduled or webhook-triggered routines against a local repository Coordinating several coding agents on one project without sending work to token-billed APIs Controlling long-running agent missions from a phone or Telegram
How do I install timon?
Download the installer for your system from the releases page Make sure one agent CLI (such as claude or codex) is already signed in Check that the service, backends and paths are working: timon doctor List the agent CLIs Timon found: timon backends
Where can I get timon?
The source code and installation instructions are on GitHub: https://github.com/ai-timon/timon

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects