omp-deck/.env.example at main · bjb2/omp-deck · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# omp-deck environment reference.
#
# Copy this file to `.env` (gitignored) or set vars in your shell. The deck
# also persists settings into `<dataDir>/.env` (managed by the Settings UI);
# values from your launching shell always win, then the managed .env, then
# the defaults below.

# ─── Network ────────────────────────────────────────────────────────────────

# Bind host. Loopback by default; expose via Tailscale or SSH tunnel — never
# bind 0.0.0.0 without an auth layer in front.
OMP_DECK_HOST=127.0.0.1
OMP_DECK_PORT=8787

# Vite dev server (apps/web). Proxies /api + /ws to OMP_DECK_PORT.
OMP_DECK_WEB_PORT=5173

# Loopback API base used by standalone bridge processes (telegram bridge etc).
# Derived from host+port when unset.
# OMP_DECK_API_BASE=http://127.0.0.1:8787

# ─── Workspaces ─────────────────────────────────────────────────────────────

# Working dir for new sessions. Defaults to the launching cwd (process.cwd).
# OMP_DECK_DEFAULT_CWD=/home/you/code

# Comma-separated extra workspace roots that show up in the picker even
# without prior sessions.
# OMP_DECK_WORKSPACES=/home/you/code,/home/you/scratch

# ─── omp SDK ────────────────────────────────────────────────────────────────

# omp agent dir — sessions live under <OMP_AGENT_DIR>/sessions/. Defaults
# to ~/.omp/agent. Override to isolate a deployment.
# OMP_AGENT_DIR=

# Default omp SDK model identifier. Empty = SDK's own default.
# OMP_MODEL=anthropic/claude-opus-4-7

# Disable SDK automatic title generation when set truthy.
# PI_NO_TITLE=

# ─── Auto-start ─────────────────────────────────────────────────────────────

# Prompt fired automatically when a new session opens. Set to `/start` after
# creating ~/.omp/agent/commands/start.md. Leave empty to disable (default).
# OMP_DECK_AUTO_START=/start

# Milliseconds before an unsubscribed idle session is reaped. 0 disables.
OMP_DECK_IDLE_TIMEOUT_MS=300000

# ─── Storage ────────────────────────────────────────────────────────────────

# SQLite database path for the deck's tasks/inbox/routines/sequences tables.
# Defaults to <cwd>/data/deck.db. Use an absolute path in production.
# OMP_DECK_DB_PATH=

# Static web bundle directory for production serving. Auto-detected at
# apps/web/dist in dev.
# OMP_DECK_WEB_DIST=

# Directory for the deck-managed .env, audit log, and bridge databases.
# Defaults to %LOCALAPPDATA%/omp-deck on Windows, $XDG_CONFIG_HOME/omp-deck
# elsewhere.
# OMP_DECK_DATA_DIR=

# ─── Logging ────────────────────────────────────────────────────────────────

# Server log threshold: debug | info | warn | error.
LOG_LEVEL=info

# ─── Telegram bridge ────────────────────────────────────────────────────────
#
# The telegram bridge (apps/bridges/telegram) is a standalone Bun process.
# It only starts after a user clicks Start in Settings → Messaging, or via
# `bun run dev:telegram`. None of these are required for the deck itself.

# Bot token from @BotFather.
# TELEGRAM_BOT_TOKEN=

# Comma-separated numeric Telegram user IDs allowed to DM the bot.
# Look up your own via https://t.me/userinfobot. Required to start the bridge.
# TELEGRAM_ALLOWED_USERS=

# Optional SQLite path for chat→session mappings. Defaults to <dataDir>/telegram-bridge.db.
# TELEGRAM_BRIDGE_DB_PATH=

# ─── Provider API keys (omp SDK reads these) ────────────────────────────────
#
# Saving any of these here, in the managed .env, or in your shell profile is
# equivalent — the omp SDK reads them from process.env. The deck's Settings
# UI masks them in lists; reveal requires the loopback API.

# ANTHROPIC_API_KEY=
# OPENAI_API_KEY=
# OPENROUTER_API_KEY=
# GROQ_API_KEY=
# GOOGLE_API_KEY=
# XAI_API_KEY=