Command reference

Run these commands from the repository root unless noted.

Install and local app

bun install
bun run dev
bun run setup
bun run aggregate

bun run dev is the one-command local app start. bun run setup is optional and can read or write local machine state while wiring telemetry and hooks.

Scheduler

bun run scheduler:status
bun run scheduler:run
bun run scheduler:agents:run
bun run scheduler:trend-finder:run
bun run scheduler:dream:run
bun run scheduler:systemd:check
bun run scheduler:systemd:render

Each scoped job has a matching :status command. The systemd commands validate or render all four Linux service/timer pairs but never install or activate them. See Local services lifecycle.

OpenAI account runtime

bun run auth:openai -- login
bun run auth:openai -- status
bun run auth:openai -- refresh
bun run auth:openai -- reauth
bun run auth:openai -- logout
bun run codex:smoke -- --model gpt-5.6-sol --json

These commands operate the script-only subscription runtime used by Dream and Trend Finder. They are separate from Hermes and browser provider setup.

Trend Finder

bun run trend-finder:export-brief
bun run trend-finder:backtest -- --help
bun run trend-finder:mcp
bun run apify:smoke -- --json

Backtests and MCP reads are local script workflows. The scoped scheduler job remains the normal collector path.

Knowledge Graph and Dream

bash scripts/setup-graphify-brain.sh
bun run graph:policy:check
bun run install-dream
bun run uninstall-dream

Public demo

bun run demo:build:pages
bun run demo:scan:pages
bun run demo:preview:pages

Documentation site

bun run docs:dev
bun run docs:check
bun run docs:scan
bun run docs:build
bun run docs:preview
bun run docs:test:e2e
bun run docs:release-check

The docs package also works independently from docs-site/ with bun run check, bun run build, and bun run preview.

Repository validation

bun run test
bun run lint
bun run typecheck
bun run typecheck:scripts
bun run format:check
bun run build
bun run budget:check
bun run runtime:check-private

Use Testing and release to choose the focused and broad gates appropriate to a change.