Repository navigation
Configuration
Wijanarko Putra Rajeb edited this page Oct 28, 2026
·
2 revisions
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.
-
MOCK=false(the default, also when unset) runs against the real SQLite database and your real workspace, and shells out to the realompbinary. -
MOCK=trueswaps in bundled demo datasets: sessions, telemetry ranges, provider reports, plugins, wikis and panel data all come fromsrc/client/data/and the server'sdata-mockmodules. It needs noompinstall and writes nothing to a real workspace. Every screenshot and recording in the README was captured inMOCK=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).
Using Kabmo
How it is built
- Architecture
- Runtime and toolchain
- App shell and layout
- Chat stream and tools
- omp engine and settings
- Plugins, skills and automation
- Desktop integration
- Workspace panels
- Providers
- Harnesses
- Tool panels
Shipping it
History