Operational Commands

The OSS bundle ships scripts in scripts/. The list below covers the everyday commands; check the directory for additions.

Database migrations

Migrations are managed with Alembic, configured in alembic.ini:

docker compose run --rm core-api alembic upgrade head
docker compose run --rm core-api alembic revision --autogenerate -m "what changed"

Agent skill installer

The OSS API exposes a one-line installer for the memclaw agent skill — see tests/test_install_skill_endpoint.py for the supported parameters. URL auto-targets this deployment's host:

curl -s "https://caura.ai/api/v1/install-skill?agent=both" | bash

Health checks

curl http://localhost:8000/api/v1/health

core-api exposes /api/v1/health only — it returns the dependency probe shape (status, storage, redis, event_bus). Sibling services (core-storage-api, core-worker, core-operations) expose /readyz for readiness probes on Cloud Run, where /healthz is intercepted by the GFE.

Client CLI: memclaw-interviewer

Installing the memclaw-client Python package (pip install memclaw-client) also provides memclaw-interviewer — the read-only Interviewer disk-parser for Claude Code and Cursor workstations. Subcommands: run, status, hook. Full flags, environment variables, and trigger wiring are in Interviewer → Setup.