Configuration
Environment variables and CLI commands, with their defaults.
Every path and bind is configurable through the environment. Defaults are chosen so the safe option requires no configuration at all.
Canonical source ↗Environment
| Variable | Default | Purpose |
|---|---|---|
| OPENCODE_DB | ~/.local/share/opencode/opencode.db | Source database, read-only |
| OPENCODEVIEW_CACHE | <repo>/.cache/analytics.sqlite | Derived cache |
| OPENCODEVIEW_HOST | 127.0.0.1 | API bind; non-loopback requires a token |
| OPENCODEVIEW_AUTH_TOKEN | unset | Bearer token for non-loopback /api/* |
| PORT | 4317 | API port |
| OH_MY_OPENCODE_LOG | $TMPDIR/oh-my-opencode.log | Optional live activity tail |
Commands
| Command | What it does |
|---|---|
| bun src/scan.ts --list | Cheap project list |
| bun src/scan.ts <project> | Scan one project into the cache |
| bun src/scan.ts --all | Scan everything |
| bun run serve | API on 127.0.0.1:4317 |
| bun run web | UI on 127.0.0.1:5273 |
| bun run check | Full gate: test, typecheck, lint, build, audit, Gitleaks |
| bun run release:check | Release harness only |