This package keeps the source needed to run the local-first Cognitive OS runtime. It intentionally excludes desktop UI shells, WebArena, ARC-AGI-3, benchmark fixtures, frozen reports, and generated artifacts.
Included source surfaces:
conos_cli.pycore/decision/evolution/integrations/local_machine/modules/planner/scripts/conos.pyscripts/local_mirror.pyscripts/run_local_machine.pyscripts/check_conos_repo_layout.pyscripts/check_runtime_preflight.pyself_model/tests/tools/managed_vm/trace_runtime.py
Excluded by design:
- desktop app sources and generated
.appbundles - WebArena adapters and runners
- ARC-AGI-3 adapters and runners
- benchmark fixtures and closed-loop experiment runners
- frozen phase evidence reports and external baseline artifacts
- generated outputs under
runtime/,reports/,audit/, anddist/ - Python caches and packaging metadata generated by local installs
Minimal setup:
python3.10 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements-dev.txt
pip install -e .
conos preflight --strict-dev
conos layout
pytest -qPrimary entry points:
conos run local-machine --instruction "inspect README" --candidate README.md --max-ticks 2
conos mirror init --mirror-root runtime/mirrors/session-1
conos llm --help
conos vm report
conos supervisor --helpExecution safety note:
Local-machine command execution defaults to the Con OS managed-VM boundary.
Host-local execution is a development opt-in via --execution-backend local or
conos mirror exec --backend local. Mirror writes require evidence,
validation, an approved sync plan, source-hash checks, and rollback
checkpoints.