OpenAgent
Repo-aware CLI that generates structured directives for AI coding agents
The Problem
AI coding agents need context to be effective. Generic prompts miss project-specific patterns, architecture decisions, and coding style. The challenge was creating a tool that understands your actual codebase and personalizes recommendations to your development approach.
My Approach
- → Repo-aware analysis — reads actual files, structure, and patterns
- → SOUL.md interview — personalizes recommendations to your style
- → Strategic directive generation — creates actionable improvement plans
- → Advisory, not execution — you maintain full control over all decisions
Key Highlights
- Live on PyPI as openagent-directive
- Understands your actual codebase structure
- Personalized via SOUL.md profile interview
- Generates strategic directives, not generic advice
How It Works
OpenAgent is a repo-aware CLI that generates structured directives for AI coding agents. It reads your actual codebase, understands your files, structure, and patterns, then personalizes recommendations via your SOUL.md profile.
What It Does
OpenAgent analyzes your repository and generates strategic directives:
- Reads your actual codebase — understands your files, structure, and patterns
- Personalizes recommendations — uses your SOUL.md profile to shape advice to your style
- Generates strategic directives — creates actionable improvement plans
- Advises, doesn’t execute — you maintain full control over all decisions
Who It’s For
Developers who want to understand their codebase better:
- Solo developers working on complex projects
- Teams needing architectural guidance
- Developers transitioning between projects
- Anyone wanting strategic improvement recommendations
Quick Start
# Install
pip install openagent-directive
# First time setup - personalize your experience
openagent init
# Generate personalized strategic analysis
openagent analyze
# Check repository structure
openagent inventory
How It Works
1. Personalize Your Experience
Run openagent init to create your SOUL.md profile. This interview captures your coding style, architectural preferences, and development philosophy.
2. Get Strategic Analysis
Run openagent analyze to scan your codebase and generate personalized directives. OpenAgent understands your project structure, identifies patterns, and provides context-aware recommendations.
3. Take Action Review the generated directives and apply what makes sense. OpenAgent advises — you decide. Maintain full control over all implementation decisions.
Architecture
OpenAgent uses GitPython to traverse your repository, AST parsing to understand code structure, and pattern matching to identify architectural decisions. The SOUL.md profile acts as a personality layer, ensuring recommendations align with your development approach.
Development Status
Live on PyPI as openagent-directive. Active development with regular updates based on user feedback.
PyPI: openagent-directive GitHub: OpenAgent
Built with Python. Live on PyPI. Personalized via SOUL.md interview.