Perseus resolves your workspace (git, services, tests, tasks) into verified facts before the context window opens. Your agent reads what's true, not instructions to go find out. Fewer tokens, no cold-start tax.
Static context files rot the moment you write them. Perseus renders live state at the moment the session opens, so nothing is stale, and the agent never burns turns re-discovering it.
A resolved document is a fraction of the size of "go check these ten things." On the Perseus repo itself, 22,528 varied directives rendered in 1.014s warm vs 619.1s cold.
No "let me check what's running" round-trips. The first turn is productive because the context was already true when it arrived.
A live judge found 20/20 A/B pairs semantically equivalent: Perseus changes what the agent knows, not what it says.
Write @query, @services, @read, @waypoint; Perseus resolves them to plain markdown at render time.
Progressive disclosure: lean tier-1 core by default; the agent pulls heavier context on demand. One integer compare per directive.
perseus prompt-size attributes every byte per directive; @budget fails CI when context bloats.
Per-model context profiles retrieve memory on demand instead of stapling a standing blob into every prompt. Prefix-cache friendly.
Crash-safe checkpoints on disk; namespaced, lock-protected stores let agents hand off without an orchestration platform.
Plugins, macros, render hooks, and pipes: drop Python into ~/.perseus/, no source patching.
Named methodology and rerunnable scripts in the repo.
Perseus speaks the Model Context Protocol and writes whatever file your assistant reads at session start.
Harness engineering — the practice of building the infrastructure around LLMs rather than fine-tuning the models themselves — was named the defining AI paradigm of 2026 by OpenAI, Anthropic, ThoughtWorks, Red Hat, and Mitchell Hashimoto. Perseus implements the Context Engineering dimension: resolving workspace state into verified facts before the model ever sees a token.
@query directives that execute shell commands, check services, and embed live state@memory persists decisions, conventions, and corrections across sessions via Perseus Vault@focus attention, @research synthesis, and automated coherence maintenance