Metadata-Version: 2.4
Name: openagent-directive
Version: 0.2.2
Summary: Repo-aware directive generator that personalizes strategic analysis to your working style
Project-URL: Homepage, https://github.com/openagent/openagent
Project-URL: Repository, https://github.com/openagent/openagent
Project-URL: Documentation, https://github.com/openagent/openagent/docs
Project-URL: Bug Tracker, https://github.com/openagent/openagent/issues
Author-email: OpenAgent Contributors <openagent@example.com>
License-Expression: MIT
Keywords: code-analysis,developer-tools,repository-analysis,strategic-planning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: click>=8.1.7
Requires-Dist: gitpython>=3.1.46
Requires-Dist: google-adk>=1.27.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: openai>=2.26.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pytest>=9.0.2
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.3.3
Description-Content-Type: text/markdown

# OpenAgent

I built this to replace the need for a more expensive AI ChatBot as my Directive Writer for my IDE Coding Agent. It nearly works using OpenRouter.

OpenAgent reads your codebase and generates strategic recommendations shaped to your architectural preferences and development style.

## Quick Start

```bash
# Install
pip install openagent

# First time setup - personalize your experience
openagent init

# Generate personalized strategic analysis
openagent analyze

# Check repository structure  
openagent inventory
```

## What It Does

OpenAgent is a **repo-aware directive generator** that:

- **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

## How It Works

### 1. Personalize Your Experience
```bash
openagent init
```
- 8-question interview captures your working style
- Creates SOUL.md with your preferences
- Shapes all future directive generation

### 2. Get Strategic Analysis
```bash
openagent analyze
```
- Analyzes your repository structure
- Considers your SOUL.md preferences
- Generates personalized recommendations

### 3. Take Action
OpenAgent provides clear, actionable directives. You decide what to implement.

## Key Features

- **Repo-aware analysis** - Understands your actual code structure
- **Personalized recommendations** - Shaped to your working style
- **Strategic guidance** - Focuses on what matters most for your project
- **Advisory mode only** - Never executes code, always advises
- **CLI-driven** - Simple command-line interface

## Installation

```bash
# Install with pip
pip install openagent

# Or with uv  
uv add openagent
```

## Usage Examples

### Basic Analysis
```bash
# Analyze current repository
openagent analyze

# Check repository structure
openagent inventory

# See system health
openagent health
```

### Personalized Workflow
```bash
# Setup your profile
openagent init

# Get personalized advice
openagent analyze --context "Preparing for v2.0 release"

# Monitor costs
openagent costs
```

## What OpenAgent Analyzes

- **Repository Structure**: File organization, architecture patterns
- **Code Quality**: Maintainability, complexity, technical debt
- **Documentation**: Completeness, consistency, alignment
- **Dependencies**: Security, versions, conflicts
- **Test Coverage**: Gaps, organization, quality metrics
- **Strategic Opportunities**: Missing components, improvements

## Architecture

Built with:
- **Google ADK** for LLM orchestration
- **Multi-Agent System** for specialized analysis
- **Personalization Engine** via SOUL.md integration
- **Rich CLI** for developer experience

## Development Status

See [docs/state/current.md](docs/state/current.md) for current implementation status.

## Contributing

1. Fork the repository
2. Create a feature branch  
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Support

- **Documentation**: [docs/](docs/) directory
- **Issues**: [GitHub Issues](https://github.com/openagent/openagent/issues)
- **Discussions**: [GitHub Discussions](https://github.com/openagent/openagent/discussions)
MIT
