Perseus
Perseus is a developer tool that resolves live workspace state into a context briefing before an AI assistant starts working, preventing stale or missing context. It scaffolds a source document with directives and renders it to assistant-specific files like AGENTS.md or CLAUDE.md, and can also serve the context via MCP. It is for developers building agentic workflows who want their assistants to start with accurate, current project information.
✨ Key features
- Renders live workspace context to AGENTS.md, CLAUDE.md, etc.
- One source document, multiple assistant output formats.
- Local-first core renderer, no account or hosted service required.
- MCP server (stdio/SSE) exposing context tools.
- Quickstart detects stack and scaffolds config.
- Watch mode keeps context fresh automatically.
🎯 Use cases
- Scaffold a context file for a new project.
- Generate AGENTS.md for AI coding assistants.
- Serve live context to MCP-compatible assistants.
- Keep context updated as workspace changes.
- Integrate with Perseus Vault for durable memory.
📦 Installation
🧰 Requirements: Python and pip; no API keys or accounts required for core use.
pip install perseus-ctx==1.0.26
For Perseus Vault (optional), download the binary from GitHub releases and install to ~/.local/bin.
🚀 Usage
pip install perseus-ctx==1.0.26
cd your-project && perseus quickstart
perseus render .perseus/context.md -o AGENTS.md
⚠️ Good to know
Shell-executing directives require PERSEUS_ALLOW_DANGEROUS=1; otherwise they are silently skipped.
❓ FAQ
How do I install Perseus?
Run pip install perseus-ctx==1.0.26.
What does perseus quickstart do?
It detects your stack, scaffolds .perseus/context.md, writes config, and verifies a render.
How do I generate an AGENTS.md file?
Run perseus render .perseus/context.md -o AGENTS.md.
Does Perseus require an account or hosted service?
No, the core renderer is local-first and does not require an account or hosted service.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.