# Tirith

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Andres Sanchez](https://cerebralvalley.ai/u/andreslaley)
- **GitHub:** https://github.com/andreseloysv/Tirith
- **Demo video:** https://youtu.be/LVqD1oW3KDw
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2167

Tirith — An autonomous manager for your coding agents: they finish the plan, rules are enforced in code, you see everything and are asked only what only you can decide.

When you run several coding agents, you spend the day asking "what is everyone doing?", re-explaining the rules, and answering questions the agents could settle themselves. Tirith takes that job.

- The plan drives the agents. An agent starts only from an open item of the project's plan and must report an outcome. Tirith is the only writer of the plan, and ticks an item only when the work is verified on main.
- Rules are code, not prompts. A hook blocks the agent's tool call and tells it the exact command to use instead: tests and builds through Tirith, no helpers started behind its back, no skipped commit checks, no editing the plan, writes only inside the agent's own worktree, never reading credentials.
- The owner gate. Nothing reaches you unless only you can do it (credentials, payment, a personal account, a physical device, your decision). Everything else goes to an on-call manager agent.
- Claim check. Before a merge, the agent's report is compared with the real change (files, tests added, tests passing). A false claim blocks the merge. It uses git and test records, not a model.
- Keep going until done. A lane that ends with gaps (no report, uncommitted work, no passing tests, a branch that does not merge) is sent back to the same agent session with exactly what is missing; a round that fixes nothing goes straight to the manager instead of wasting another round.
- Loop detection. An agent that repeats the same tool call with the same input is reminded at 3 and stopped at 8.
- The CEO. A few times a day a read-only agent reviews how the manager runs the work, from numbers measured by code (never from agents' claims). It sends the manager directives and asks the owner only for decisions that are theirs. It keeps its own findings and decisions so it never repeats itself, and it changes nothing itself: a hook enforces that.
- Autonomy. An on-call manager answers in the chat and delegates; Tirith checks itself every pass and heals what it can; finished lanes go through one merge queue (tested together, claim-checked, merged); proposals that cannot run now (machine load, a failing project check, a step the owner stopped) are held by code, and a manager's "wait" expires after 2 hours.
- Visibility. A chat that shows the manager's work live like a terminal, "Your turn" for what needs you, Agents (with what the manager and the CEO are doing right now), Pipelines, the Plan, a lane scoreboard (first-try rate, rounds, merges, cost per merged lane) and a health check.
- A desktop app (Tauri) for macOS, and a collector that keeps running when the app is closed.

No servers and no ports: a local collector writes one state file; the page and the app follow it.

Everything in the repository was built during the hackathon, starting 2026-10-28. No code or assets were reused from earlier projects.

Try it: git clone https://github.com/andreseloysv/Tirith && cd Tirith && ./run --demo
Requires uv and a browser; the demo needs no agents or API keys. Use ./run for the live collector. META_SI_API_KEY enables the Muse Spark brain.

Team: Andres Eloy Sanchez Vargas (solo).

## More from Meta Global AI Developer Hackathon

- [Qorelly](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2164)
- [Rasi Solutions](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2165)
- [Rocky Fx](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2166)
- [AgentGuard](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2168)
- [SiteSurgeon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2169)
- [Lazarus Sentinel](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2170)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/2167. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt