ContextOS

CLI Reference

Command Line Interface for ContextOS administration.

ContextOS provides several utility scripts for managing data and generating traces. These are currently available in the scripts/ directory of the repository.

seed_demo.py

Seeds the PostgreSQL database with a deterministic set of engineering memories (Slack messages, JIRA tickets, PR comments). This is required before running the interactive demo or the evaluation benchmarks.

python scripts/seed_demo.py

generate_demo_trace.py

Executes a realistic query against the seeded database and exports the resulting ExecutionTrace to a JSON file. This file can be used to populate the frontend demo.

python scripts/generate_demo_trace.py

alembic

ContextOS relies on Alembic for all schema migrations. To initialize a fresh database or upgrade an existing one, run:

alembic upgrade head