noahatfin

noahatfin / telos

Public

Agent-first intent and constraint tracking layer for Git. Structured, queryable memory for AI coding agents.

ai-agents cli code-review constraints content-addressable
15
0
100% credibility
Found Mar 01, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Telos is a companion to code projects that structuredly records goals, rules to follow, decisions made, and helper actions for easy recall by people or smart assistants.

How It Works

1
📖 Discover a memory helper for projects

You hear about a simple tool that helps remember the goals, rules, and reasons behind your code changes so nothing gets forgotten.

2
🏠 Add it to your project

With one easy step in your project folder, you set up this helpful memory alongside your work.

3
💡 Share your next goal

You write a quick note about what you plan to build next, like adding a new feature, so everyone knows the purpose.

4
⚖️ Note key rules

You list important rules to follow, such as security musts or how things should behave, keeping your project safe and consistent.

5
🤔 Record smart choices

As you decide between options, you note why you picked one, creating a trail of thoughtful reasoning.

6
🔍 Get instant context

Anytime you or a smart helper need background, you ask and get exactly the relevant goals, rules, and history.

🧠 Your project remembers forever

Now your work has a living memory—past goals, rules, and actions are always there, making teamwork and fixes effortless.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is telos?

Telos is an agent-first intent and constraint tracking layer for Git, providing structured, queryable memory for AI coding agents. It captures why changes happen—intents, rules like "sessions expire in 24h", decisions, and agent actions—alongside your repo in a .telos/ store. Rust-built CLI lets you init, log intents via `telos intent "add auth" --constraint "use HTTPS"`, query with `telos query constraints --file src/auth.rs --json`, and manage lifecycles like supersede/deprecate.

Why is it gaining traction?

Unlike scattered commit messages or static CONSTRAINTS.md, Telos offers scoped queries by file/symbol/impact/security, with JSON output tailored for agents recovering context across sessions. Agent-first organization shines: log ops via `telos agent-log --agent claude --operation review`, bridge to Git commits. Stands out for persistent memory in AI GitHub workflows, beyond flat files.

Who should use this?

Teams building AI coding agents needing Git intent memory, Rust devs enforcing constraints queryably before commits, solo engineers tracking decisions/ADRs without Markdown chaos. Perfect for agent-first repos where LLMs check rules on files like src/auth/mod.rs or symbols like validate_token.

Verdict

Worth prototyping for agent-first Git flows—solid CLI, JSON queries, 76 tests—but 12 stars and 1.0% credibility signal early days; docs are strong, expect iteration. Grab if telos ai github tools are your jam.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.