Skip to main content

Host-agnostic multi-agent company framework

Project description

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.24.2 (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.24.2

Or from git tag:

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

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 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+.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

company_os-0.25.7.tar.gz (561.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

company_os-0.25.7-py3-none-any.whl (673.5 kB view details)

Uploaded Python 3

File details

Details for the file company_os-0.25.7.tar.gz.

File metadata

  • Download URL: company_os-0.25.7.tar.gz
  • Upload date:
  • Size: 561.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for company_os-0.25.7.tar.gz
Algorithm Hash digest
SHA256 c9475dff4eb97478c17bc35328bf3d7fb0aa661380cbb89873be0ac319aea7c0
MD5 105732cabfb6704c284ad009c73b972b
BLAKE2b-256 5e0b9b9e9bd83b0ad0158fdb57686c06b474d8107cbdbd18f05214011cd95e28

See more details on using hashes here.

File details

Details for the file company_os-0.25.7-py3-none-any.whl.

File metadata

  • Download URL: company_os-0.25.7-py3-none-any.whl
  • Upload date:
  • Size: 673.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for company_os-0.25.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2495b3b2d2b106336a88c411d0eb7805683734431b5b36bec03e02c1e42c1eba
MD5 176452c48fde4c460b77543c37244261
BLAKE2b-256 7c6f713c575868cc16484ad16fb9bc58348d64590a478c26e625867cf00fdfd1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page