Metadata-Version: 2.1
Name: company-os
Version: 0.23.0
Summary: Host-agnostic multi-agent company framework
Author: Mohit Meena
License: MIT
Project-URL: Homepage, https://github.com/mohitmeena144/company-os
Project-URL: Repository, https://github.com/mohitmeena144/company-os
Project-URL: Documentation, https://github.com/mohitmeena144/company-os#readme
Keywords: agents,multi-agent,cursor,workflow
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6
Provides-Extra: binary
Requires-Dist: shiv>=1.0.8; extra == "binary"
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build<1.3,>=1.2; extra == "dev"
Requires-Dist: twine>=6.1; extra == "dev"
Provides-Extra: google
Requires-Dist: google-auth>=2.29.0; extra == "google"
Requires-Dist: google-auth-oauthlib>=1.2.0; extra == "google"
Requires-Dist: google-api-python-client>=2.130.0; extra == "google"

# company-os

Host-agnostic multi-agent company framework. Install into any repo; it compiles a neutral
`.company-os/` source into the host(s) you enable (Cursor today; Claude/Codex later).

Extracted from [feedback-ai](https://github.com/mohitmeena144/feedback-ai) with git history preserved.

**Releases:** [v0.21.0](https://github.com/mohitmeena144/company-os/releases/tag/v0.21.0) (latest) · see [CHANGELOG.md](CHANGELOG.md) · [Publishing](docs/publishing.md) · [Releasing](docs/RELEASING.md)

**New repo?** [Adopt in 5 commands](docs/adopt-in-5-commands.md) · **Migrating?** [Consumer adoption](docs/consumer-adoption.md)

## Install (pinned)

```bash
pip install "git+https://github.com/mohitmeena144/company-os@v0.21.0"
```

For local development:

```bash
pip install -e ".[dev]"
```

## Layout (this repo)

| Path | Role |
|------|------|
| **`.company-os/`** | Canonical source + runtime state (`state/sprints`, `todos.json`, …) |
| **`.cursor/`**, **`AGENTS.md`** | Generated by `company-os update` — do not edit directly |
| **`src/company_os/`** | Installable Python package (engine + compiler) |
| **`src/company_os/plugins/`** | Optional pod plugins (`sales`, `social`, `media`, `seo`) — see [docs/plugins.md](docs/plugins.md) |
| **`.claude/company/`** | Legacy extraction — pod agents/scripts retired in v0.4.0 |

## Commands

```bash
company-os init --name myproject --host cursor   # or: cos init …
company-os update
company-os migrate-legacy          # copy legacy state into .company-os/state/
company-os run list                # agent run audit trail (start/finish/record/hook)
company-os budget status           # monthly spend vs caps (Phase 6)
company-os flows allowed eng-loop --agent developer  # ORIENT gate incl. budget
company-os link                       # register repo in hub registry
company-os dashboard --all            # observability rollup across linked repos
company-os plugin list               # optional pod plugins (v0.4.0+)
company-os docs generate             # company reference tables (v0.7.0+)
company-os linear status             # Linear sync dry-run (v0.7.0+)
company-os linear migrate          # one-time local → Linear (v0.10.0+)
company-os agent new …               # scaffold chassis agent (v0.8.0+)
company-os qa run --branch …         # Playwright sprint QA (v0.9.0+)
company-os remote auth-status      # remote webhook config (v0.3.1+)
company-os status
company-os doctor --check
```

Edit workflow content in **`.company-os/rules/`**, **`skills/`**, **`agents/`**, and **`overlays/`**.

**Adopting in another repo:** [docs/adopt-in-5-commands.md](docs/adopt-in-5-commands.md) (new) or [docs/consumer-adoption.md](docs/consumer-adoption.md) (migrate).

## Legacy (retired in v0.14+)

- `.claude/company/scripts/` — removed; use `company-os` / `cos` CLI only
- One-off utilities quarantined in `tools/legacy-scripts/`

## Development

```bash
pytest -q
company-os version
```

Requires Python 3.10+.
