Metadata-Version: 2.4
Name: promptosaurus
Version: 0.13.0
Summary: Build AI coding assistant configs from a shared prompt library
Project-URL: Homepage, https://github.com/johna/promptosaurus
Project-URL: Repository, https://github.com/johna/promptosaurus
Project-URL: Issues, https://github.com/johna/promptosaurus/issues
Author: john@snoodleboot.io
License: MIT
Keywords: ai,cli,coding-assistant,configuration,prompts
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: jinja2>=3.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: ruamel-yaml>=0.18
Requires-Dist: sweet-tea>=0.1.0
Description-Content-Type: text/markdown

# Promptosaurus

**Version 0.1.0** - A unified, tool-agnostic prompt architecture for managing AI agent configurations across 5 coding assistants.

Define your agent once in a simple IR format, automatically generate outputs for:
- **Kilo** IDE (YAML + Markdown)
- **Cline** (Markdown with skill directives)
- **Claude** (Markdown `.claude/` directory)
- **Cursor** (Markdown rules)
- **GitHub Copilot** (GitHub instructions)

## Install

Install via pip:

```bash
pip install promptosaurus
```

Or with uv:

```bash
uv add promptosaurus
```

This installs the `promptosaurus` CLI command.

## Quick Start

See [QUICKSTART.md](./docs/QUICKSTART.md) for a 5-minute guide.

## Key Features

- **Unified IR System** - Define agents once, generate for all tools
- **5 Production-Ready Builders** - Kilo, Cline, Claude, Cursor, Copilot
- **Minimal/Verbose Variants** - Save tokens by choosing variant at build time
- **Persona-Based Filtering** - Select your team\'s roles, get only relevant agents
- **Auto-Discovery Registry** - Zero-config agent registration
- **CLI Tool** - Interactive `promptosaurus init` command
- **Backwards Compatible** - Existing configurations still work

## Commands Reference

| Command | Description |
|---------|-------------|
| `promptosaurus init` | Interactively initialize prompt configuration for your project |
| `promptosaurus list` | List all registered modes and their prompt files |
| `promptosaurus switch` | Switch to a different AI assistant tool |
| `promptosaurus swap` | Swap active personas and regenerate AI assistant configurations |
| `promptosaurus update` | Update configuration options interactively |
| `promptosaurus validate` | Check that all registered prompt files exist and no files are missing |

## Documentation

### User Guides
- **[QUICKSTART.md](./docs/QUICKSTART.md)** - Quick start guide
- **[PERSONAS.md](./docs/PERSONAS.md)** - Documentation on persona-based filtering
- **[GETTING_STARTED.md](./docs/user-guide/GETTING_STARTED.md)** - Detailed getting started guide

### Reference
- **[API_REFERENCE.reference.md](./docs/reference/API_REFERENCE.reference.md)** - API reference documentation
- **[BUILDER_API_REFERENCE.builder.md](./docs/builders/BUILDER_API_REFERENCE.builder.md)** - Builder API reference
- **[BUILDER_IMPLEMENTATION_GUIDE.builder.md](./docs/builders/BUILDER_IMPLEMENTATION_GUIDE.builder.md)** - Guide for implementing new builders
- **[ARCHITECTURE_OVERVIEW.md](./docs/architecture/ARCHITECTURE_OVERVIEW.md)** - System architecture overview
- **[INDEX.md](./docs/INDEX.md)** - Documentation navigation hub

### Workflow
- **Adding prompts**: Run `promptosaurus init` to generate configurations, then edit files in generated directories (e.g., `.kilo/rules/`)
- **Updating prompts**: Edit source prompts, then re-run `promptosaurus init` to regenerate

### Mode Reference
| Mode | Key | Purpose |
|------|-----|---------|  
| Architect | `architect` | Scaffold projects, task breakdowns, data models |
| Test | `test` | Coverage-first test writing |
| Refactor | `refactor` | Structural changes, behavior preserved |
| Document | `document` | Docstrings, READMEs, changelogs |
| Explain | `explain` | Code walkthroughs for onboarding |
| Migration | `migration` | Dependency upgrades, framework ports |
| Code | `code` | Feature implementation, boilerplate |
| Review | `review` | Code, performance, accessibility review |
| Debug | `debug` | Root cause, log analysis, rubber duck |
| Ask | `ask` | Q&A, decision logs |
| Security | `security` | Security review (code and infra) |
| Compliance | `compliance` | SOC 2, ISO 27001, GDPR, HIPAA, PCI-DSS |
| Orchestrator | `orchestrator` | CI/CD, DevOps, PR descriptions |

## Development

To contribute or develop locally:

```bash
# Clone the repository
git clone https://github.com/johna/promptosaurus.git
cd promptosaurus

# Install in development mode
pip install -e .

# Or with uv
uv pip install -e .

# Run tests
pytest -v

# Type checking
pyright
```
