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.26.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.26.0

Or from git tag:

pip install "git+https://github.com/mohitmeena144/company-os@v0.26.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+.

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.26.0.tar.gz (492.9 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.26.0-py3-none-any.whl (587.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for company_os-0.26.0.tar.gz
Algorithm Hash digest
SHA256 cc22caf8384caff54ebddafddcfa7b799b563a8174dac6977ba1969ccbebc446
MD5 6a10df7cc6776858fd640e43464baefa
BLAKE2b-256 064f35f698ea16f32700f62194d79919bc2882214e0be6fc56860515d5dc59be

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for company_os-0.26.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d8f1ac0783a22d483e73d2c3a830621ce872f6774440393ab6bac2b2e982755
MD5 4a46fbbb9968f9f4a3ab946649eb8933
BLAKE2b-256 44492b7d147ddb8357a0591c2324d1298ed8c005ed0de640f9184433112b0daa

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