Skip to content

Configuration

Wijanarko Putra Rajeb edited this page Oct 28, 2026 · 2 revisions

Configuration

Environment variables, read from .env (see .env.example):

Variable Default Purpose
PORT 3000 Server port
HOST localhost Server bind address
MOCK false true = demo datasets, false = real SQLite + workspace only
SYNC_WORKSPACE true Seed the workspace list from discovered omp projects — only while the list is still empty (one-time bootstrap; a curated list is never appended to)
KABMO_DATA_DIR (OMPCHAMBER_DATA_DIR) ~/.kabmo CLI registry, logs, database, wiki mirrors and TLS certificate root
KABMO_PORT / KABMO_HOST — Defaults for the CLI when no flag is passed
KABMO_UI_PASSWORD (OMPCHAMBER_UI_PASSWORD) — Require a UI password (see Security); erased from the environment at boot
KABMO_DB_PATH (OMPCHAMBER_DB_PATH, DB_PATH) ~/.kabmo/db.sqlite SQLite database path
KABMO_BUN — Explicit Bun binary for the CLI to spawn
KABMO_OMP_BIN (OMPCHAMBER_OMP_BIN) — Explicit omp binary path
KABMO_MARKETPLACE_DIR / KABMO_BUNDLED_MARKETPLACE_DIR — Override where plugin marketplaces are read from
PI_CONFIG_DIR / PI_CODING_AGENT_DIR ~/.omp Oh-My-Pi config root overrides
SKILLS_API_URL https://skills.sh Skills catalog source
NPM_CONFIG_REGISTRY https://registry.npmjs.org Registry the update check reads

Runtime state, sessions and settings live in SQLite (~/.kabmo/db.sqlite), the single source of truth for persisted settings. Per-session UI state (open tabs, panel widths, the picked repo, drafts) lives beside it, keyed by session id, so a reload restores the layout that session was left in.

Two data modes

  • MOCK=false (the default, also when unset) runs against the real SQLite database and your real workspace, and shells out to the real omp binary.
  • MOCK=true swaps in bundled demo datasets: sessions, telemetry ranges, provider reports, plugins, wikis and panel data all come from src/client/data/ and the server's data-mock modules. It needs no omp install and writes nothing to a real workspace. Every screenshot and recording in the README was captured in MOCK=true.

Rules that follow from the mode: a demo must never write rows into a real database, so the MOCK-only fallbacks are deliberately separate from the real paths (see Codebase rules and the panel pages).

Clone this wiki locally