Give people and coding agents a shared contract for what your software should do.

Local-first  ·  Model-agnostic  ·  Git-native  ·  Any tech stack

Telos is a local CLI that keeps requirements, scenarios, code links, and test evidence together in Git. Review changes before implementation, give coding agents focused context, and let configured CI detect drift from the approved state.

Telos is written in Rust but works with any language. It makes no LLM calls, generates no application code, and requires no hosted service.

Why Telos?

**Tired of coding agents breaking existing behavior every time you ask for a new feature?**

Telos is built on a simple spec-first principle: if your intent, scenarios, constraints, and test evidence are detailed enough, a fresh agent—with no chat history or hidden project knowledge—should be able to rebuild the software.

The specification is the durable source of truth. The current code is one verified implementation of it.

• Durable intent versioned with the repository.
• Focused context for developers and coding agents.
• Reviewable changes approved before implementation.
• Test evidence linked to the same test failing, then passing in strict TDD mode.
• Drift detection across specifications and production code.

How it works

Related Skills