company-os 0.28.0

Host-agnostic multi-agent company framework

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 a production consumer application with git history preserved.

Releases: v0.28.0 (latest) · see CHANGELOG.md · Publishing · Releasing

Documentation: docs/README.md · Company OS handbook (full project guide)

New repo? Adopt in 5 commands · Migrating? Consumer adoption · Hosting? Hosted dashboard playbook

Install (pinned)

pip install company-os==0.28.0

Or from git tag:

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

For local editable installs on the framework repo:

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/	Documentation hub — start at docs/README.md

Commands

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 scheduler run           # execute due schedule-triggered agents
company-os agent-run providers     # run agents/flows via API keys (anthropic/openai/cursor)
company-os agent-run agent developer --task "…" --provider openai --model gpt-4o
company-os agent-run flow eng-loop --task "…" --provider anthropic   # run the whole flow
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 hosting doctor             # hosted mirror health (v0.24+)
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 (new) or 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

pytest -q
company-os version

Requires Python 3.10+.