Skip to content

Self-improving AI Employees for everyone

1.5 KB
Raw Blame

company

Project supervisor CLI for the OpenCompany stack. The public command is company; the npm package is @zeenie-ai/opencompany, and the legacy machina bin remains as a deprecated compatibility alias. It is also backwards-compatible with bun run start/dev/stop/etc.

Install

No install step is required for a source checkout: bin/cli.js and the root package.json scripts both invoke python -m cli from the repo root; scripts/postinstall.js deliberately does not pip-install it. To install the company entry point on PATH:

python -m pip install -e .   # run from the repository root, not from cli/

Use

company --help        # list commands
company stop          # kill ports + orphans + temporal

Or via the package.json scripts (bun run <script>, which invoke the same Python CLI):

bun run stop

Cross-platform notes

  • Windows: python resolves correctly out of the box.
  • macOS / Linux: requires python to point to Python 3.12+. Most modern distros provide this via python-is-python3 or a symlink. If your distro only ships python3, run python3 -m cli <cmd> or add an alias.

Architecture

Built on battle-tested primitives — minimal custom code:

Layer Library
CLI typer
Subprocess anyio.open_process
Tree-kill psutil + pywin32 (Job Objects on Windows)
Restart backoff stdlib (deque + monotonic time + jittered exponential, ~20 LOC)
Output rich.Console
Env stdlib parser over .env.template, .env, and .env.dev