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.6.tar.gz (552.3 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.6-py3-none-any.whl (664.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: company_os-0.25.6.tar.gz
  • Upload date:
  • Size: 552.3 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.6.tar.gz
Algorithm Hash digest
SHA256 50e2ec8d1c02c008496dbbf8a985c89e1ea3c15076c81930ad909d607c1721c8
MD5 340240f774a2dc0ebbcf9a0fe1517b8e
BLAKE2b-256 c7c8c2484e0a0ad5c3cf354b332c29eb4ad042b4fd51a40f9511a12e55f6a077

See more details on using hashes here.

File details

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

File metadata

  • Download URL: company_os-0.25.6-py3-none-any.whl
  • Upload date:
  • Size: 664.9 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 680b7fbc7bde46fbc147cdbba491944ea8354a9600e36fdd68e8d922ff4425aa
MD5 2a0bc9e1df67b6e790ab87df441c6f32
BLAKE2b-256 042d1bcbe9a0a8d127efaef2306e313c2fb608b44af29b764231596be72e87a6

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