The flight recorder for AI coding agents.¶

See exactly what your AI agent did, why it failed, and how much it cost. Every model call, every tool invocation, every file change — captured as a structured execution trace.

pip install intentos
intent-os demo --auto

What Intent OS Does¶

Three things, simply:

Trace — Record every step your AI agent takes. Model calls, tool invocations, file changes, test runs — all captured.

Analyze — See cost, latency, token usage, and failure reasons for every execution. Know why your agent failed.

Govern — Define security policies that control what agents can do. Audit every action with full compliance reporting.

Quick Demo¶

Try it — no API key required (Ollama recommended for local execution):

# Validate a manifest
intent-os validate examples/translate.yaml

# Run a built-in capability by name
intent-os run text_summarize -p text="AI is transforming how we work"

# Compare runtimes
intent-os compare examples/translate.yaml --input '{"text":"hello","target_lang":"fr"}'

# Natural language (requires Ollama or API key)
intent-os ask "translate 'good morning' to Japanese"

# See what's available
intent-os demo --auto

How It Works¶

graph LR
    A[User / CLI] --> B{Intent OS Runtime}
    B --> C[Manifest Parser]
    B --> D[Execution Engine]
    B --> E[Security Manager]
    B --> F[Event Recorder]
    C --> G[Registry]
    D --> H[OpenAI Adapter]
    D --> I[Anthropic Adapter]
    D --> J[Ollama Adapter]
    D --> K[...]
    F --> L[Event Store]
    G --> M[Capability Registry]

Why Not Just Use MCP?¶

Model Context Protocol standardizes connection — how an AI tool talks to a runtime.

Intent OS standardizes execution — how a capability is described, composed, discovered, secured, and recorded across runtimes.

They are complementary: Intent OS can consume MCP servers as capability providers.

Project Status¶

731 tests passed, 8 skipped, 0 failures — CI across Python 3.10, 3.11, and 3.12.

Intent OS is building the execution layer for AI agents. See the specs for details.

Next Steps¶

Step	Action
	Quickstart — 60 seconds to first command
	Learn the Manifest format
	Browse the CLI reference
	Star the repo