ai-timon/timon
TIMON — AI AGENT ORCHESTRATOR ON LOCAL MACHINE
Timon manages a team of AI agents on your computer using existing CLI subscriptions without token billing. The orchestrator distributes tasks among coder, reviewer, merger and other agents.
// KEY FEATURES
- Orchestrator plans and distributes tasks among specialized agents
- Each task in its own git worktree, reviewed by second model before merge
- Works via your CLI subscriptions (Claude, Codex, Copilot, etc.) without API tokens
- Plugins, mission memory, quotas, voice, browser — accessible everywhere: desktop, web, Telegram, CLI
// DEEP DIVE: HOW IT WORKS
Timon runs as a background service on Windows, macOS, or Linux and connects to already installed CLI agents: claude, codex, copilot, grok, opencode, pi, or hermes-acp. User describes a task in natural language — the orchestrator breaks it into subtasks, assigns models, launches agents in isolated git worktrees, and tracks execution until merge. Each agent has a role, skill set, and long-term memory portable across missions. System asks for confirmation before push, publish, or delete.
Difference from cloud orchestrators — full locality: code never leaves your machine, payment only via existing subscriptions, no token billing. Inside — plugin architecture (widgets, pages, themes without restart), built-in browser with session recording, voice I/O, quota fallbacks when one backend exhausts limits. Missions keep full tool-call history and can be resumed after crash.
Requires: installed and authorized CLI of at least one supported agent. Installer pulls Node.js automatically, and Git on Windows. For headless servers there is `timon service install`. Supported OS: Windows 10+ x64, macOS 11+ Apple Silicon, Linux x64 glibc 2.28+.
// USE CASES
Best for: Developers automating routine with local AI agents
- Assign refactoring to orchestrator: it distributes edits, review, and merge among agents
- Run nightly routine updating dependencies and generating release notes via cron
- Dictate task via voice in Telegram — agent executes it on home workstation
// QUICK START
curl -fsSL https://timon-ai.com/install.sh | sh
irm https://timon-ai.com/install.ps1 | iex
timon doctor
timon backends
timon service installCommands are taken from the repository README — check the current version on GitHub before running.
New repositories every 30 minutes
REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.
Join on Telegram