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.29.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.29.0

Or from git tag:

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

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for futureflow.ai from gravatar.com futureflow.ai

Credits

Author: Mohit Meena

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

binary dev google

Tags

agents multi-agent cursor workflow

Classifiers

Report project as malware

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.29.0.tar.gz (542.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.29.0-py3-none-any.whl (630.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: company_os-0.29.0.tar.gz
  • Upload date:
  • Size: 542.1 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.29.0.tar.gz
Algorithm Hash digest
SHA256 c048d25845bcd87939bfddc1a7c2e4fcda681b95ded954095859a2be186ab82d
MD5 5fc8eabf587a6fd635aae0848ceec6f0
BLAKE2b-256 348fd3ead15289618915fb35f0b0d636885e549c65231877be9a5cedb118732a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: company_os-0.29.0-py3-none-any.whl
  • Upload date:
  • Size: 630.2 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.29.0-py3-none-any.whl
Algorithm Hash digest
SHA256 418bba64446019a337f0c62aa2255cfa931ab34edccb4da3f89126d143716233
MD5 ce0d185bdba456c17bd8fd979ac7552d
BLAKE2b-256 4e6212e9b6f1d0f94f7334bb2b105ac88fb5accb0501d162925884555ac1474f

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 Sentry Error logging StatusPage Status page