Perseus-Computing-LLC/perseus

What it does

Perseus is a local-first context engine designed to prepare comprehensive context briefings for AI-assisted coding workflows. It functions as an MCP (Model Context Protocol) server that automatically pre-resolves and compiles relevant information from your project including git history, running services, test suites, and memory into an organized context package before your session starts.

How to set up

Perseus is available via PyPI under the package name 'perseusctx'. Installation is straightforward: use pip to install the package, then configure it as an MCP server in your AI tool of choice (Claude, ChatGPT, or compatible platforms). The tool is designed to work with the local-first philosophy, meaning it operates directly on your machine and project files without requiring cloud dependencies.

Key features

• Automatic git repository analysis and history compilation
• Service and dependency detection and status monitoring
• Test suite integration and results aggregation
• Memory and context persistence across sessions
• MCP server compatibility for seamless AI tool integration
• Pre-compiled context briefings ready at session start (compilebeforecontext)
• Cross-platform support (macOS, Windows, Linux)