OpenAgent

Every AI coding session starts by re-explaining the same context.

The Solution

OpenAgent reads your codebase, interviews you once via SOUL.md, and generates directives that sound like something you’d actually write.

Install

pip install openagent-directive

Quick Start

# 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.

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

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.