Metadata-Version: 2.4
Name: quinn-ai
Version: 0.2.0
Summary: QuinnAI - hierarchical AI organization management CLI
Project-URL: Homepage, https://github.com/qosha1/quinn-ai
Project-URL: Repository, https://github.com/qosha1/quinn-ai
Project-URL: Issues, https://github.com/qosha1/quinn-ai/issues
Project-URL: Changelog, https://github.com/qosha1/quinn-ai/blob/main/CHANGELOG.md
Author: QuinnAI Team
License-Expression: MIT
Keywords: agents,ai,claude,cli,openai,orchestration,organization
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: click>=8.1.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.3.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: systemeval[pytest]>=0.3.0; extra == 'dev'
Description-Content-Type: text/markdown

# quinn-ai

A QuinnAI organization - hierarchical AI workers collaborating on strategic objectives.

## Quick Start

### Start the Organization
```bash
qn org start
```

### Check Status
```bash
qn org status
```

### Stop the Organization
```bash
qn org stop
```

## Organization Structure

View the org chart:
```bash
qn org chart show
```

## Workers

### Hire a Worker
```bash
qn org hire --name="Alice" --role="Engineer" --manager=ceo
```

### Fire a Worker
```bash
qn org fire <worker-id> --reason="Performance issues"
```

### View Worker Status
```bash
qn wrkr list
```

## Work Tracking

All work is tracked in **beads** (our issue tracker):

```bash
# View all work
qn-bd list --status=open

# View ready work (no blockers)
qn-bd ready

# View strategic objectives (OKRs)
qn-bd list --label=okr
```

## Storage

Organization storage structure:
- `storage/shared/company/` - Org-wide documentation
- `storage/shared/{team}/` - Team collaboration spaces
- `storage/workers/{path}/` - Worker personal storage (mirrors org chart)

## Configuration

- `config/providers.yaml` - AI service providers
- `config/workflow.yaml` - Workflow rules and automation
- `config/worker-templates.yaml` - Worker session templates

## Documentation

- `storage/shared/company/QUICKSTART.md` - Worker quick reference
- `storage/shared/company/BEADS_WORKFLOW.md` - Complete beads guide
- `storage/shared/company/OKR_GUIDE.md` - Understanding OKRs

## Database

Organization state: `live/quinn.db`

View org status:
```bash
qn org status
```

## Monitoring

Launch the dashboard:
```bash
qn board ui
```

## Getting Help

Run `qn --help` for full command reference.