@4via6/relay 1.0.0 → 1.1.1

package/dist/utils/stt.js.map

@@ -1 +1 @@
-{"version":3,"file":"stt.js","sourceRoot":"","sources":["../../src/utils/stt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stt.js","sourceRoot":"","sources":["../../src/utils/stt.ts"],"names":[],"mappings":"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"}

package/dist/utils/system-prompt.js

@@ -1,5 +1,6 @@
 import { readFileSync, existsSync, watchFile, unwatchFile } from "fs";
-import { resolve } from "path";
+import { resolve, join } from "path";
+import { getConfig } from "../config/index.js";
 const DEFAULT_SYSTEM_PROMPT = `You are a coding assistant accessed through a Telegram bot. Your responses are delivered as Telegram messages, so keep them concise and under 4000 characters when possible — use Markdown formatting (bold, inline code, code blocks) for readability. Focus on actionable, practical answers: provide code, commands, or direct solutions rather than lengthy explanations. Messages may originate from voice transcriptions, so interpret the user's intent generously even if the wording is imprecise or contains transcription artifacts.`;
 let cachedPrompt = null;
 let watchedPath = null;
@@ -56,9 +57,19 @@ export function unwatchSystemPrompt() {
     }
 }
 function resolvePromptPath() {
-    const envPath = process.env.SYSTEM_PROMPT_FILE;
-    if (envPath)
-        return resolve(envPath);
-    return resolve("skill.md");
+    const config = getConfig();
+    // 1. Explicit path from config
+    if (config.systemPromptFile)
+        return resolve(config.systemPromptFile);
+    // 2. .relay/SKILL.md
+    const relaySkill = join(config.dataDir || ".relay", "SKILL.md");
+    if (existsSync(relaySkill))
+        return resolve(relaySkill);
+    // 3. ./SKILL.md in cwd (backward compat)
+    const cwdSkill = resolve("SKILL.md");
+    if (existsSync(cwdSkill))
+        return cwdSkill;
+    // 4. Return the .relay/SKILL.md path anyway (for watch setup)
+    return resolve(relaySkill);
 }
 //# sourceMappingURL=system-prompt.js.map

package/dist/utils/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/utils/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,qBAAqB,GAAG,ihBAAihB,CAAC;AAEhjB,IAAI,YAAY,GAAkB,IAAI,CAAC;AACvC,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC/C,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,WAAW,EAAE,CAAC;gBAChB,YAAY,GAAG,WAAW,CAAC;gBAC3B,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;oBAC7B,IAAI,WAAW;wBAAE,WAAW,CAAC,WAAW,CAAC,CAAC;oBAC1C,SAAS,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;wBAC3C,YAAY,GAAG,IAAI,CAAC;oBACtB,CAAC,CAAC,CAAC;oBACH,WAAW,GAAG,QAAQ,CAAC;gBACzB,CAAC;gBACD,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IACD,YAAY,GAAG,qBAAqB,CAAC;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,YAAY,GAAG,IAAI,CAAC;IACpB,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/utils/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,qBAAqB,GAAG,ihBAAihB,CAAC;AAEhjB,IAAI,YAAY,GAAkB,IAAI,CAAC;AACvC,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC/C,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,WAAW,EAAE,CAAC;gBAChB,YAAY,GAAG,WAAW,CAAC;gBAC3B,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;oBAC7B,IAAI,WAAW;wBAAE,WAAW,CAAC,WAAW,CAAC,CAAC;oBAC1C,SAAS,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;wBAC3C,YAAY,GAAG,IAAI,CAAC;oBACtB,CAAC,CAAC,CAAC;oBACH,WAAW,GAAG,QAAQ,CAAC;gBACzB,CAAC;gBACD,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IACD,YAAY,GAAG,qBAAqB,CAAC;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,YAAY,GAAG,IAAI,CAAC;IACpB,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,WAAW,EAAE,CAAC;QAChB,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAErE,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvD,yCAAyC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,8DAA8D;IAC9D,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/timeout.js

@@ -1,7 +1,6 @@
-const DEFAULT_PROMPT_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+import { getConfig } from "../config/index.js";
 export function getPromptTimeout() {
-    const env = process.env.PROMPT_TIMEOUT_MS;
-    return env ? Number(env) : DEFAULT_PROMPT_TIMEOUT;
+    return getConfig().promptTimeoutMs;
 }
 export async function withTimeout(promise, ms, label = "Operation") {
     let timer;

package/dist/utils/timeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/utils/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAE1D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC1C,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,EAAU,EACV,QAAgB,WAAW;IAE3B,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAC7E,EAAE,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/utils/timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,EAAE,CAAC,eAAe,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,EAAU,EACV,QAAgB,WAAW;IAE3B,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAC7E,EAAE,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/docs/commands.md

@@ -202,27 +202,19 @@ List all available OpenCode commands that can be used with `/cmd`.
 
 ### `/models`
 
-List all available models grouped by provider. Each model shows capability badges:
+List all available models with an interactive inline keyboard. Tap a model button to select it instantly.
+
+Each model shows capability badges:
 
 - `[reasoning]` -- The model supports extended thinking/reasoning
 - `[vision]` -- The model accepts image input
-- `[active]` -- Currently selected model
-
-Example output:
+- `✓` prefix -- Currently selected model
 
-```
-Available Models
-
-anthropic
-  claude-sonnet-4-20250514  [reasoning] [active]
-  claude-opus-4-20250514  [reasoning]
-  claude-haiku-4-20250514
+Models are grouped by provider with header rows. If there are more than 8 models, pagination buttons (`« Prev` / `Next »`) appear at the bottom.
 
-openrouter
-  deepseek/deepseek-r1  [reasoning]
-```
+Tapping a model button switches to that model immediately and shows a confirmation with capabilities.
 
-All providers fetch models dynamically from their respective APIs.
+All providers fetch models dynamically from their respective APIs. If the provider API key is not set, no models are listed.
 
 ### `/model [provider/model]`
 

package/docs/configuration.md

@@ -1,88 +1,108 @@
 # Configuration Reference
 
-All configuration is done through environment variables in the `.env` file. Copy `.env.example` to `.env` to get started.
+Relay uses a JSON config file at `.relay/config.json`. Run `relay onboard` for the interactive wizard, or pass settings via CLI flags.
 
-## Required Variables
+## Setup
 
-| Variable | Description |
-|----------|-------------|
-| `BOT_TOKEN` | Telegram bot token from [@BotFather](https://t.me/BotFather) |
-| `ALLOWED_USER_ID` | Your Telegram user ID (only this user can interact with the bot) |
-| `PROVIDER` | Which coding agent to use: `opencode`, `claude`, or `codex` |
+```bash
+relay onboard                    # Interactive wizard
+relay --bot-token=xxx --allowed-user-id=123 --provider=opencode  # CLI flags
+```
+
+Config resolution order: **CLI flags > config file > defaults**.
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| `relay onboard` | Interactive configuration wizard |
+| `relay start` | Start the bot as a background daemon |
+| `relay stop` | Stop the background daemon |
+| `relay restart` | Restart the background daemon |
+| `relay logs` | Tail daemon logs (Ctrl+C to exit) |
+| `relay status` | Show daemon status (PID, uptime, memory) |
+| `relay update` | Update Relay to the latest version |
+
+## CLI Flags
+
+| Flag | Description |
+|------|-------------|
+| `--help`, `-h` | Show help |
+| `--version`, `-v` | Show version |
+| `--bot-token` | Telegram bot token |
+| `--allowed-user-id` | Telegram user ID |
+| `--provider` | Provider: `opencode`, `claude`, `codex` |
+| `--bot-mode` | `polling` or `webhook` |
+| `--webhook-url` | Webhook URL (when `--bot-mode=webhook`) |
+| `--webhook-port` | Webhook port (default: 3000) |
+| `--webhook-secret` | Webhook secret token |
+| `--streaming-enabled` | `true` or `false` |
+| `--stream-edit-interval-ms` | Stream edit interval in ms |
+| `--prompt-timeout-ms` | Prompt timeout in ms |
+| `--log-level` | `debug`, `info`, `warn`, `error` |
+| `--data-dir` | Data directory (default: `.relay/`) |
+| `--system-prompt-file` | Custom system prompt file path |
+
+## Core Settings
+
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `botToken` | `--bot-token` | -- | Telegram bot token from [@BotFather](https://t.me/BotFather) |
+| `allowedUserId` | `--allowed-user-id` | -- | Your Telegram user ID |
+| `provider` | `--provider` | `opencode` | Coding agent: `opencode`, `claude`, or `codex` |
 
 ## Provider Configuration
 
-Each provider has its own set of required and optional variables. See [Providers](providers.md) for detailed setup.
+Each provider has its own settings. Provider API keys (like `ANTHROPIC_API_KEY`) are configured in your coding agent's environment, not in Relay.
+
+See [Providers](providers.md) for detailed setup.
 
 ### OpenCode
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `OPENCODE_MODE` | No | `start` | `start` spawns a local server, `connect` connects to a remote URL |
-| `OPENCODE_URL` | No | `http://localhost:4096` | Server URL (used when `MODE=connect`) |
-| `OPENCODE_HOSTNAME` | No | `127.0.0.1` | Bind address (used when `MODE=start`) |
-| `OPENCODE_PORT` | No | `4096` | Port number (used when `MODE=start`) |
-| `OPENCODE_MODEL` | No | Server default | Model override, e.g. `anthropic/claude-sonnet-4-20250514` |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `opencodeMode` | `--opencode-mode` | `start` | `start` spawns a local server, `connect` connects to a remote URL |
+| `opencodeUrl` | `--opencode-url` | `http://localhost:4096` | Server URL (used when mode=`connect`) |
+| `opencodeHostname` | `--opencode-hostname` | `127.0.0.1` | Bind address (used when mode=`start`) |
+| `opencodePort` | `--opencode-port` | `4096` | Port number (used when mode=`start`) |
+| `opencodeModel` | `--opencode-model` | Server default | Model override, e.g. `anthropic/claude-sonnet-4-20250514` |
 
 ### Claude Code
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `ANTHROPIC_API_KEY` | Yes | -- | Anthropic API key |
-| `CLAUDE_MODEL` | No | `sonnet` | Model name or ID (use `/models` to see all available) |
-| `CLAUDE_PERMISSION_MODE` | No | `acceptEdits` | How Claude handles file edits |
-| `CLAUDE_CWD` | No | Current directory | Working directory for Claude |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `claudeModel` | `--claude-model` | `sonnet` | Model name or ID |
+| `claudePermissionMode` | `--claude-permission-mode` | `acceptEdits` | How Claude handles file edits |
+| `claudeCwd` | `--claude-cwd` | Current directory | Working directory |
 
 ### OpenAI Codex
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `CODEX_API_KEY` | Yes* | -- | OpenAI API key (*or use `OPENAI_API_KEY`) |
-| `CODEX_MODEL` | No | `o3` | Model name or ID (use `/models` to see all available) |
-| `CODEX_CWD` | No | Current directory | Working directory for Codex |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `codexModel` | `--codex-model` | `o3` | Model name or ID |
+| `codexCwd` | `--codex-cwd` | Current directory | Working directory |
 
 ## Bot Mode
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `BOT_MODE` | `polling` | `polling` for long-polling, `webhook` for webhook mode |
-| `WEBHOOK_URL` | -- | Public URL for receiving Telegram updates (required when `BOT_MODE=webhook`) |
-| `WEBHOOK_PORT` | `3000` | Port for the webhook HTTP server |
-| `WEBHOOK_SECRET` | -- | Optional secret token for webhook verification |
-
-### Long Polling (default)
-
-The bot connects to Telegram and pulls updates. Simple to set up, works behind NATs/firewalls.
-
-```env
-BOT_MODE=polling
-```
-
-### Webhook Mode
-
-The bot runs an HTTP server and Telegram pushes updates to it. Lower latency and better for production deployments.
-
-```env
-BOT_MODE=webhook
-WEBHOOK_URL=https://your-server.com/bot
-WEBHOOK_PORT=3000
-WEBHOOK_SECRET=your-random-secret
-```
-
-Requirements:
-- A public HTTPS URL that Telegram can reach
-- The port must be accessible (default: 3000)
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `botMode` | `--bot-mode` | `polling` | `polling` or `webhook` |
+| `webhookUrl` | `--webhook-url` | -- | Public URL for webhook (required when mode=`webhook`) |
+| `webhookPort` | `--webhook-port` | `3000` | Webhook HTTP server port |
+| `webhookSecret` | `--webhook-secret` | -- | Secret token for webhook verification |
 
 ## Data Persistence
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `RELAY_DATA_DIR` | `.relay/` | Directory for persisted bot state |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `dataDir` | `--data-dir` | `.relay/` | Directory for persisted bot state |
 
-Relay persists session state, model selection, and provider-specific data to disk so they survive restarts. The `.relay/` directory is created automatically in the project root.
+Relay persists session state, model selection, and provider-specific data to disk so they survive restarts. The `.relay/` directory is created automatically.
 
 Files stored:
+- `config.json` — Your configuration (0600 permissions)
 - `session.json` — Active session ID and selected model
+- `SKILL.md` — Custom system prompt (optional, create manually)
 - `claude-mcp.json` — Claude provider MCP server configurations
 - `codex-threads.json` — Codex provider thread ID mappings
 
@@ -90,71 +110,65 @@ The directory is excluded from git via `.gitignore`.
 
 ## Streaming
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `STREAMING_ENABLED` | `false` | Enable progressive message editing during AI responses |
-| `STREAM_EDIT_INTERVAL_MS` | `2000` | How often (in ms) to update the Telegram message while streaming |
-
-When streaming is enabled, the bot sends a "Thinking..." placeholder and progressively updates it as the AI generates its response. This works with all three providers.
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `streamingEnabled` | `--streaming-enabled` | `false` | Enable progressive message editing |
+| `streamEditIntervalMs` | `--stream-edit-interval-ms` | `2000` | Update interval (ms) while streaming |
 
 ## Timeout
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PROMPT_TIMEOUT_MS` | `300000` | Maximum time (in ms) to wait for a provider response. Default is 5 minutes. |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `promptTimeoutMs` | `--prompt-timeout-ms` | `300000` | Max wait time for provider response (5 min) |
 
-If the AI takes longer than this to respond, the request is cancelled and an error message is shown.
+## Logging
 
-## System Prompt
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `logLevel` | `--log-level` | `info` | Log level: `debug`, `info`, `warn`, `error` |
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `SYSTEM_PROMPT_FILE` | `skill.md` | Path to your custom system prompt file |
+Relay uses structured JSON logging via pino. Set to `debug` for verbose output when troubleshooting.
 
-The bot looks for a file named `skill.md` in the project root. If found, its contents are prepended to every message sent to the AI. If the file doesn't exist, a built-in default prompt is used.
+## System Prompt
+
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `systemPromptFile` | `--system-prompt-file` | -- | Path to custom system prompt file |
 
-The file is watched for changes and reloaded automatically. You can also force a reload with `/system reload`.
+The bot looks for a system prompt in this order:
+1. Explicit path from `systemPromptFile` config
+2. `.relay/SKILL.md` if it exists
+3. `./SKILL.md` in the current directory (backward compatibility)
+4. Built-in default prompt
 
-See [Features > System Prompt](features.md#system-prompt) for details on customizing the prompt.
+The file is watched for changes and reloaded automatically. Use `/system reload` to force a reload.
 
 ## Voice / Speech-to-Text
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `STT_PROVIDER` | `auto` | STT provider: `groq`, `openai`, `assemblyai`, or `auto` |
-| `GROQ_API_KEY` | -- | Groq API key for Whisper |
-| `GROQ_STT_MODEL` | `whisper-large-v3-turbo` | Groq transcription model |
-| `OPENAI_API_KEY` | -- | OpenAI API key for Whisper |
-| `OPENAI_STT_MODEL` | `gpt-4o-mini-transcribe` | OpenAI transcription model |
-| `ASSEMBLYAI_API_KEY` | -- | AssemblyAI API key |
+| Config field | CLI flag | Default | Description |
+|-------------|----------|---------|-------------|
+| `sttProvider` | `--stt-provider` | `auto` | STT provider: `groq`, `openai`, `assemblyai`, or `auto` |
+| `groqApiKey` | `--groq-api-key` | -- | Groq API key for Whisper |
+| `openaiSttApiKey` | `--openai-stt-api-key` | -- | OpenAI API key for speech-to-text |
+| `assemblyaiApiKey` | `--assemblyai-api-key` | -- | AssemblyAI API key |
+| `groqSttModel` | -- | `whisper-large-v3-turbo` | Groq transcription model |
+| `openaiSttModel` | -- | `gpt-4o-mini-transcribe` | OpenAI transcription model |
 
-Set at least one API key to enable voice message support. When `STT_PROVIDER=auto` (default), the cheapest available provider is selected automatically:
+Set at least one API key during `relay onboard` to enable voice message support. When `sttProvider` is `auto` (default), the cheapest available provider is selected:
 
 1. **Groq** (fastest, has a free tier)
 2. **AssemblyAI**
 3. **OpenAI**
 
-## Example `.env` File
-
-```env
-# Telegram
-BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
-ALLOWED_USER_ID=987654321
-
-# Provider
-PROVIDER=opencode
-OPENCODE_MODE=start
-
-# Bot mode (polling or webhook)
-BOT_MODE=polling
-
-# Streaming
-STREAMING_ENABLED=true
-STREAM_EDIT_INTERVAL_MS=2000
-
-# Timeout
-PROMPT_TIMEOUT_MS=300000
-
-# Voice (set at least one for voice support)
-GROQ_API_KEY=gsk_...
+## Example Config
+
+```json
+{
+  "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
+  "allowedUserId": 987654321,
+  "provider": "opencode",
+  "streamingEnabled": true,
+  "logLevel": "info",
+  "groqApiKey": "gsk_..."
+}
 ```

package/docs/features.md

@@ -24,13 +24,21 @@ Relay streams AI responses in real time. As the AI generates text, the Telegram
 
 ### Configuration
 
-Streaming is enabled by default. To disable it:
+Streaming is configured during `relay onboard`, or via CLI flag:
 
-```env
-STREAMING=false
+```bash
+relay --streaming-enabled=true
 ```
 
-When disabled, the bot waits for the complete response before sending a single message.
+Or set it in `.relay/config.json`:
+
+```json
+{
+  "streamingEnabled": true
+}
+```
+
+When disabled (default), the bot waits for the complete response before sending a single message.
 
 ---
 
@@ -68,12 +76,14 @@ Send voice notes to the bot and they'll be transcribed and processed as text inp
 
 ### Setup
 
-Configure at least one speech-to-text provider:
+Configure at least one speech-to-text provider during `relay onboard`, or set keys in `.relay/config.json`:
 
-```env
-GROQ_API_KEY=gsk_...          # Groq Whisper (fastest, has free tier)
-OPENAI_API_KEY=sk-...          # OpenAI Whisper
-ASSEMBLYAI_API_KEY=...         # AssemblyAI
+```json
+{
+  "groqApiKey": "gsk_...",
+  "openaiSttApiKey": "sk-...",
+  "assemblyaiApiKey": "..."
+}
 ```
 
 If multiple providers are configured, the cheapest available one is selected automatically.
@@ -194,25 +204,17 @@ Relay supports switching between AI models at runtime.
 
 ### Listing available models
 
-Use `/models` to see all configured models:
+Use `/models` to see all available models as an interactive inline keyboard. Models are grouped by provider, with capability badges shown next to each name. The currently active model is marked with a `✓` prefix.
 
-```
-Available Models
+Tap any model button to switch to it instantly — no need to type a command.
 
-anthropic
-  claude-sonnet-4-20250514  [reasoning] [active]
-  claude-opus-4-20250514  [reasoning]
-  claude-haiku-4-20250514
-
-openrouter
-  deepseek/deepseek-r1  [reasoning]
-```
+If there are more than 8 models, pagination buttons (`« Prev` / `Next »`) appear at the bottom.
 
 ### Capability badges
 
 - `[reasoning]` — The model supports extended thinking/reasoning
 - `[vision]` — The model accepts image input
-- `[active]` — Currently selected model
+- `✓` prefix — Currently selected model
 
 ### Switching models
 
@@ -236,8 +238,10 @@ Capabilities: reasoning, vision
 ### Provider behavior
 
 - **OpenCode**: Lists all models from all configured providers dynamically
-- **Claude**: Fetches available models dynamically from the Anthropic API (`GET /v1/models`)
-- **Codex**: Fetches available models dynamically from the OpenAI API (`GET /v1/models`)
+- **Claude**: Fetches available models dynamically from the Anthropic API — requires `ANTHROPIC_API_KEY` in the environment
+- **Codex**: Fetches available models dynamically from the OpenAI API — requires `CODEX_API_KEY` or `OPENAI_API_KEY` in the environment
+
+If the provider API key is not set or the API call fails, no models are listed.
 
 ---
 
@@ -247,14 +251,26 @@ Customize the AI's behavior with a system prompt file.
 
 ### Default behavior
 
-The bot loads a system prompt from `skill.md` in the project root. If the file doesn't exist, a built-in default prompt is used.
+The bot looks for a system prompt in this order:
+1. Explicit path from `systemPromptFile` in config
+2. `.relay/SKILL.md` if it exists
+3. `./SKILL.md` in the current directory (backward compatibility)
+4. Built-in default prompt
 
 ### Custom prompt file
 
-Set a custom path:
+Set a custom path in `.relay/config.json`:
 
-```env
-SYSTEM_PROMPT_FILE=prompts/my-prompt.md
+```json
+{
+  "systemPromptFile": "prompts/my-prompt.md"
+}
+```
+
+Or via CLI flag:
+
+```bash
+relay --system-prompt-file=prompts/my-prompt.md
 ```
 
 ### Hot reload
@@ -397,10 +413,18 @@ Relay automatically persists critical state to disk so it survives bot restarts
 
 ### Configuration
 
-Override the data directory:
+Override the data directory in `.relay/config.json`:
+
+```json
+{
+  "dataDir": "/path/to/custom/data"
+}
+```
+
+Or via CLI flag:
 
-```env
-RELAY_DATA_DIR=/path/to/custom/data
+```bash
+relay --data-dir=/path/to/custom/data
 ```
 
 Default: `.relay/` in the project root.
@@ -413,11 +437,21 @@ For production deployments, you can run Relay in webhook mode instead of long-po
 
 ### Setup
 
-```env
-BOT_MODE=webhook
-WEBHOOK_URL=https://your-server.com/bot
-WEBHOOK_PORT=3000
-WEBHOOK_SECRET=your-random-secret
+Configure webhook mode during `relay onboard`, or set it in `.relay/config.json`:
+
+```json
+{
+  "botMode": "webhook",
+  "webhookUrl": "https://your-server.com/bot",
+  "webhookPort": 3000,
+  "webhookSecret": "your-random-secret"
+}
+```
+
+Or via CLI flags:
+
+```bash
+relay --bot-mode=webhook --webhook-url=https://your-server.com/bot --webhook-port=3000
 ```
 
 ### Requirements
@@ -434,7 +468,7 @@ WEBHOOK_SECRET=your-random-secret
 
 ### Switching back to polling
 
-Set `BOT_MODE=polling` (or remove the variable). The bot will clear any stale webhook before starting long-polling.
+Set `botMode` to `polling` in your config (or remove it — polling is the default). The bot will clear any stale webhook before starting long-polling.
 
 ### Benefits over polling