@openlife/cli 1.7.5 → 1.7.6

package/dist/cli/InstallModules.js

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPrecheck = runPrecheck;
 exports.maskToken = maskToken;
+exports.providedApiKeyEnvNames = providedApiKeyEnvNames;
+exports.saveApiKeysToEnv = saveApiKeysToEnv;
 exports.saveTelegramConfig = saveTelegramConfig;
 exports.validateTelegramToken = validateTelegramToken;
 exports.checkTelegram409Conflict = checkTelegram409Conflict;
@@ -71,6 +73,41 @@ function maskToken(token) {
         return '***';
     return `${token.slice(0, 6)}...${token.slice(-4)}`;
 }
+const API_KEY_ENV_MAP = {
+    openai: 'OPENAI_API_KEY',
+    anthropic: 'ANTHROPIC_API_KEY',
+    gemini: 'GEMINI_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+    elevenlabs: 'ELEVENLABS_API_KEY',
+};
+function providedApiKeyEnvNames(keys) {
+    return Object.keys(keys)
+        .filter((k) => typeof keys[k] === 'string' && keys[k].trim().length > 0)
+        .map((k) => API_KEY_ENV_MAP[k]);
+}
+function saveApiKeysToEnv(root, keys) {
+    const envPath = path.join(root, '.env');
+    const current = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf-8') : '';
+    const provided = Object.keys(keys)
+        .filter((k) => typeof keys[k] === 'string' && keys[k].trim().length > 0);
+    if (provided.length === 0)
+        return { saved: [], path: envPath };
+    const envVars = new Set(provided.map((k) => API_KEY_ENV_MAP[k]));
+    const lines = current
+        .split('\n')
+        .filter(Boolean)
+        .filter((l) => {
+        const eq = l.indexOf('=');
+        if (eq < 0)
+            return true;
+        return !envVars.has(l.slice(0, eq));
+    });
+    for (const k of provided) {
+        lines.push(`${API_KEY_ENV_MAP[k]}=${keys[k].trim()}`);
+    }
+    fs.writeFileSync(envPath, lines.join('\n') + '\n', 'utf-8');
+    return { saved: provided.map((k) => API_KEY_ENV_MAP[k]), path: envPath };
+}
 function saveTelegramConfig(root, token, chatId) {
     const envPath = path.join(root, '.env');
     const current = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf-8') : '';

package/dist/cli/InstallWizard.js

@@ -185,9 +185,15 @@ class InstallWizard {
             }
             preExistingAction = idx === 1 ? 'reinstall' : 'repair';
         }
-        // 2. Profile selection
-        const profileIdx = await this.answers.choice('Which profile do you want to install?\n  framework — local interactive CLI (default)\n  autonomous — long-running daemon with Telegram gateway and governance', ['framework', 'autonomous'], 0);
-        const profile = profileIdx === 1 ? 'autonomous' : 'framework';
+        // 2. Profile selection — 3 user-visible options. `both` is an alias for
+        // `autonomous` since autonomous already includes the framework layer
+        // (systemInstaller.install() runs unconditionally in InstallFlow.run()).
+        const profileIdx = await this.answers.choice('Which profile do you want to install?\n  framework — local interactive CLI only\n  autonomous — long-running daemon with Telegram gateway and governance\n  both — autonomous daemon plus framework CLI (recommended for full setup)', ['framework', 'autonomous', 'both'], 0);
+        const profile = profileIdx === 0 ? 'framework' : 'autonomous';
+        const installBoth = profileIdx === 2;
+        if (installBoth) {
+            warnings.push('INSTALLING_BOTH: autonomous profile selected (includes framework layer)');
+        }
         // 3. Host selection — auto-detect, but always ask to confirm.
         const detected = (0, InstallFlow_1.detectHostFromEnv)();
         const hostOptions = [...InstallFlow_1.VALID_HOSTS];
@@ -207,25 +213,53 @@ class InstallWizard {
         if (validatedHost !== 'claude-code') {
             warnings.push(`HOST_NOT_YET_SUPPORTED: ${validatedHost} host-specific install is a no-op for now; .openlife state will still be created`);
         }
-        // 4. Model chain (optional)
+        // 4. API keys (optional) — each prompt accepts paste or blank to skip.
+        //    IMPORTANT: collect first, but only persist after final confirmation.
+        //    An aborted wizard must not mutate .env or write pasted secrets.
+        let savedApiKeyNames = [];
+        const collectedApiKeys = {};
+        const wantsApiKeys = await this.answers.yesNo('Configure LLM API keys now? (You can also set them later in .env)', true);
+        if (wantsApiKeys) {
+            collectedApiKeys.openai = await this.answers.text('OPENAI_API_KEY (paste or Enter to skip)', '');
+            collectedApiKeys.anthropic = await this.answers.text('ANTHROPIC_API_KEY (paste or Enter to skip)', '');
+            collectedApiKeys.gemini = await this.answers.text('GEMINI_API_KEY (paste or Enter to skip)', '');
+            collectedApiKeys.openrouter = await this.answers.text('OPENROUTER_API_KEY (paste or Enter to skip)', '');
+            savedApiKeyNames = (0, InstallModules_1.providedApiKeyEnvNames)(collectedApiKeys);
+            if (savedApiKeyNames.length === 0) {
+                warnings.push('NO_API_KEYS_PROVIDED: model providers will only work via OAuth CLIs or Ollama until keys are added to .env');
+            }
+        }
+        else {
+            warnings.push('SKIPPED_API_KEYS: configure providers later via .env or `openlife auth <provider>`');
+        }
+        // 5. OAuth pointer — informational only. The actual `openlife auth gemini`
+        //    / `auth openai` flows are interactive subprocesses; running them inside
+        //    the wizard would break the canned-answer test seam. We just signal the
+        //    operator that the flag exists so they can opt-in after init completes.
+        const wantsOAuth = await this.answers.yesNo('Plan to configure OAuth for Gemini or OpenAI CLI later?', false);
+        if (wantsOAuth) {
+            warnings.push('OAUTH_PENDING: after init completes, run `openlife auth gemini` and/or `openlife auth openai` to log in');
+        }
+        // 6. Model chain (optional)
         const modelsRaw = await this.answers.text('LLM model order (comma-separated provider/model chain, blank = defaults)', '');
         const modelOrder = modelsRaw
             ? modelsRaw.split(',').map((m) => m.trim()).filter(Boolean)
             : undefined;
-        // 5. Telegram (autonomous only)
+        // 7. Telegram (autonomous only)
         if (profile === 'autonomous') {
             const hasTelegram = await this.answers.yesNo('Do you already have TELEGRAM_BOT_TOKEN and OPENLIFE_TELEGRAM_ALLOWED_USER_ID set in your .env?', false);
             if (!hasTelegram) {
                 warnings.push('TELEGRAM_NOT_CONFIGURED: autonomous profile needs TELEGRAM_BOT_TOKEN and OPENLIFE_TELEGRAM_ALLOWED_USER_ID — set them in .env before running `openlife agent start`');
             }
         }
-        // 6. Skip doctor?
+        // 8. Skip doctor?
         const skipDoctor = await this.answers.yesNo('Skip the system doctor run?', false);
-        // 7. Confirm preview
+        // 9. Confirm preview
         const previewLines = [
             'Review your choices:',
-            `  profile      : ${profile}`,
+            `  profile      : ${profile}${installBoth ? ' (both — framework + autonomous)' : ''}`,
             `  host         : ${validatedHost}`,
+            `  apiKeys      : ${savedApiKeyNames.length ? savedApiKeyNames.join(', ') : '(none saved)'}`,
             `  modelOrder   : ${modelOrder ? modelOrder.join(', ') : '(defaults)'}`,
             `  skipDoctor   : ${skipDoctor}`,
             preExistingAction ? `  preExisting  : ${preExistingAction}` : ''
@@ -239,6 +273,10 @@ class InstallWizard {
         if (!confirmed) {
             return { ok: false, reason: 'user_aborted', detail: 'preview_not_confirmed' };
         }
+        if (savedApiKeyNames.length > 0) {
+            const saved = (0, InstallModules_1.saveApiKeysToEnv)(this.root, collectedApiKeys);
+            savedApiKeyNames = saved.saved;
+        }
         const options = {
             profile,
             host: validatedHost,

package/dist/index.js

@@ -298,6 +298,8 @@ program
 program.command('init')
     .description('Interactive install wizard — guided setup for OpenLife into the chosen host CLI')
     .action(async () => {
+    console.log((0, InstallBanner_1.installationBanner)());
+    console.log('');
     // Lazy require preserves the lazy-import contract (`src/index.ts:11-13`).
     const { InstallWizard, ReadlineAnswerProvider } = require('./cli/InstallWizard');
     const { InstallFlow } = require('./cli/InstallFlow');
@@ -320,6 +322,15 @@ program.command('init')
             for (const w of result.warnings)
                 console.log(`  - ${w}`);
         }
+        console.log('');
+        console.log('✅ OpenLife ready.');
+        console.log('');
+        console.log('Try:');
+        console.log('  openlife ask "hello, what can you do?"');
+        console.log('  openlife status');
+        console.log('  openlife --help');
+        console.log('');
+        console.log('Docs: https://github.com/GOOODZ/openlife-core');
     }
     finally {
         // Release the readline interface so the CLI exits cleanly.

package/dist/test_install_wizard.js

@@ -3,12 +3,15 @@
 // Uses CannedAnswerProvider so no real stdin/tty is required.
 //
 // Question order in wizard.run() (when no pre-existing install):
-//   1) profile          (choice: 0=framework, 1=autonomous)
+//   1) profile          (choice: 0=framework, 1=autonomous, 2=both)
 //   2) host             (choice: 0=claude-code, 1=gemini-cli, 2=codex)
-//   3) model order      (text: blank or comma list)
-//   4) telegram?        (yesNo, autonomous only)
-//   5) skip doctor?     (yesNo)
-//   6) confirm preview  (yesNo)
+//   3) wantsApiKeys     (yesNo)
+//   3a-d) [if Y] OPENAI / ANTHROPIC / GEMINI / OPENROUTER pastes (text)
+//   4) wantsOAuth       (yesNo)
+//   5) model order      (text: blank or comma list)
+//   6) telegram?        (yesNo, autonomous only)
+//   7) skip doctor?     (yesNo)
+//   8) confirm preview  (yesNo)
 //
 // When pre-existing install detected, an extra choice prompt fires FIRST:
 //   0) abort  1) reinstall  2) repair
@@ -76,8 +79,8 @@ function writeExistingInstall(root) {
 async function scenario1HappyPathFrameworkClaudeCode() {
     const root = tempRoot();
     try {
-        // profile=framework(0), host=claude-code(0), models='', skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, '', false, true]);
+        // profile=framework(0), host=claude-code(0), apiKeys=N, oauth=N, models='', skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, false, false, '', false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario1: expected ok=true');
@@ -88,7 +91,8 @@ async function scenario1HappyPathFrameworkClaudeCode() {
         assert(result.options.skipDoctor === false, 'scenario1: skipDoctor should be false');
         assert(result.options.modelOrder === undefined, 'scenario1: modelOrder should be undefined when blank');
         assert(result.preExistingAction === undefined, 'scenario1: no pre-existing action expected');
-        assert(!result.warnings, 'scenario1: no warnings expected for default claude-code');
+        // SKIPPED_API_KEYS warning is expected when wantsApiKeys=false
+        assert(Array.isArray(result.warnings) && result.warnings.some((w) => w.includes('SKIPPED_API_KEYS')), 'scenario1: should warn SKIPPED_API_KEYS when api-key prompt skipped');
         console.log('✅ scenario 1: happy path framework + claude-code');
     }
     finally {
@@ -98,8 +102,8 @@ async function scenario1HappyPathFrameworkClaudeCode() {
 async function scenario2HappyPathAutonomousClaudeCode() {
     const root = tempRoot();
     try {
-        // profile=autonomous(1), host=claude-code(0), models='', telegram=true, skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([1, 0, '', true, false, true]);
+        // profile=autonomous(1), host=claude-code(0), apiKeys=N, oauth=N, models='', telegram=true, skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([1, 0, false, false, '', true, false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario2: expected ok=true');
@@ -107,7 +111,8 @@ async function scenario2HappyPathAutonomousClaudeCode() {
             return;
         assert(result.options.profile === 'autonomous', 'scenario2: profile should be autonomous');
         assert(result.options.host === 'claude-code', 'scenario2: host should be claude-code');
-        assert(!result.warnings, 'scenario2: no warnings when telegram already configured');
+        // SKIPPED_API_KEYS warning is expected when wantsApiKeys=false
+        assert(Array.isArray(result.warnings) && result.warnings.some((w) => w.includes('SKIPPED_API_KEYS')), 'scenario2: should warn SKIPPED_API_KEYS when api-key prompt skipped');
         console.log('✅ scenario 2: happy path autonomous + claude-code');
     }
     finally {
@@ -117,8 +122,8 @@ async function scenario2HappyPathAutonomousClaudeCode() {
 async function scenario3UserAbortsOnConfirm() {
     const root = tempRoot();
     try {
-        // framework, claude-code, blank models, skipDoctor=false, confirm=false (abort)
-        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, '', false, false]);
+        // framework, claude-code, apiKeys=N, oauth=N, blank models, skipDoctor=false, confirm=false (abort)
+        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, false, false, '', false, false]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === false, 'scenario3: expected ok=false');
@@ -156,8 +161,8 @@ async function scenario5PreExistingRepair() {
     const root = tempRoot();
     try {
         writeExistingInstall(root);
-        // 2=repair, then full flow: framework, claude-code, '', skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([2, 0, 0, '', false, true]);
+        // 2=repair, then full flow: framework, claude-code, apiKeys=N, oauth=N, '', skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([2, 0, 0, false, false, '', false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario5: expected ok=true');
@@ -175,8 +180,8 @@ async function scenario6PreExistingReinstall() {
     const root = tempRoot();
     try {
         writeExistingInstall(root);
-        // 1=reinstall, framework, claude-code, '', skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([1, 0, 0, '', false, true]);
+        // 1=reinstall, framework, claude-code, apiKeys=N, oauth=N, '', skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([1, 0, 0, false, false, '', false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario6: expected ok=true');
@@ -192,8 +197,8 @@ async function scenario6PreExistingReinstall() {
 async function scenario7UnsupportedHostGeminiCli() {
     const root = tempRoot();
     try {
-        // framework, host=1 (gemini-cli, not yet supported), blank models, skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([0, 1, '', false, true]);
+        // framework, host=1 (gemini-cli, not yet supported), apiKeys=N, oauth=N, blank models, skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([0, 1, false, false, '', false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario7: expected ok=true even with unsupported host');
@@ -212,8 +217,8 @@ async function scenario8CustomModelChain() {
     const root = tempRoot();
     try {
         const models = 'gemini-api/gemini-3.1-pro-preview,openai-api/gpt-5.4-mini';
-        // framework, claude-code, models=custom, skipDoctor=false, confirm=true
-        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, models, false, true]);
+        // framework, claude-code, apiKeys=N, oauth=N, models=custom, skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([0, 0, false, false, models, false, true]);
         const wizard = new InstallWizard_1.InstallWizard(root, provider);
         const result = await wizard.run();
         assert(result.ok === true, 'scenario8: expected ok=true');
@@ -252,6 +257,64 @@ async function scenario9OutOfAnswersThrows() {
         cleanup(root);
     }
 }
+async function scenario10WithApiKeysPersists() {
+    const root = tempRoot();
+    try {
+        // framework, claude-code, apiKeys=Y, paste 4 keys (openai+anthropic, skip gemini+openrouter),
+        // oauth=N, blank models, skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([
+            0, 0,
+            true, // wantsApiKeys
+            'openai-test-key', // openai paste (non-secret test fixture)
+            'anthropic-test-key', // anthropic paste (non-secret test fixture)
+            '', // gemini skip
+            '', // openrouter skip
+            false, // wantsOAuth
+            '', // models
+            false, // skipDoctor
+            true, // confirm
+        ]);
+        const wizard = new InstallWizard_1.InstallWizard(root, provider);
+        const result = await wizard.run();
+        assert(result.ok === true, 'scenario10: expected ok=true');
+        if (!result.ok)
+            return;
+        // .env should contain the pasted keys
+        const envPath = path.join(root, '.env');
+        assert(fs.existsSync(envPath), 'scenario10: .env should exist after wizard');
+        const envContent = fs.readFileSync(envPath, 'utf-8');
+        assert(envContent.includes('OPENAI_API_KEY=openai-test-key'), 'scenario10: .env should have OPENAI_API_KEY');
+        assert(envContent.includes('ANTHROPIC_API_KEY=anthropic-test-key'), 'scenario10: .env should have ANTHROPIC_API_KEY');
+        assert(!envContent.includes('GEMINI_API_KEY='), 'scenario10: .env should NOT have GEMINI_API_KEY (skipped)');
+        // SKIPPED_API_KEYS warning should NOT fire when at least one key was provided
+        if (result.warnings) {
+            assert(!result.warnings.some((w) => w.includes('SKIPPED_API_KEYS')), 'scenario10: should NOT warn SKIPPED_API_KEYS when keys were provided');
+        }
+        console.log('✅ scenario 10: API keys collected and persisted to .env');
+    }
+    finally {
+        cleanup(root);
+    }
+}
+async function scenario11ProfileBothMapsToAutonomous() {
+    const root = tempRoot();
+    try {
+        // profile=both(2), claude-code, apiKeys=N, oauth=N, models='', telegram=true (autonomous path),
+        // skipDoctor=false, confirm=true
+        const provider = new InstallWizard_1.CannedAnswerProvider([2, 0, false, false, '', true, false, true]);
+        const wizard = new InstallWizard_1.InstallWizard(root, provider);
+        const result = await wizard.run();
+        assert(result.ok === true, 'scenario11: expected ok=true');
+        if (!result.ok)
+            return;
+        assert(result.options.profile === 'autonomous', 'scenario11: profile=both should map internally to autonomous');
+        assert(Array.isArray(result.warnings) && result.warnings.some((w) => w.includes('INSTALLING_BOTH')), 'scenario11: should emit INSTALLING_BOTH warning so caller knows both layers were intended');
+        console.log('✅ scenario 11: profile=both maps to autonomous with INSTALLING_BOTH warning');
+    }
+    finally {
+        cleanup(root);
+    }
+}
 async function main() {
     console.log('🧪 test_install_wizard — Story 3.5 regression suite');
     await scenario1HappyPathFrameworkClaudeCode();
@@ -263,6 +326,8 @@ async function main() {
     await scenario7UnsupportedHostGeminiCli();
     await scenario8CustomModelChain();
     await scenario9OutOfAnswersThrows();
+    await scenario10WithApiKeysPersists();
+    await scenario11ProfileBothMapsToAutonomous();
     console.log('');
     console.log('TEST_INSTALL_WIZARD_OK');
 }

package/docs/getting-started.md

@@ -0,0 +1,137 @@
+# Getting Started
+
+A 5-minute walkthrough to get OpenLife CLI running on your machine.
+
+## 1. Install globally
+
+```bash
+npm install -g @openlife/cli
+openlife --version
+```
+
+You should see the current version (matching the npm tag).
+
+## 2. Run the wizard
+
+```bash
+openlife init
+```
+
+The wizard prints the OpenLife banner, then walks you through:
+
+1. **Profile** — choose `framework` (CLI only), `autonomous` (daemon),
+   or `both`. `both` installs the autonomous profile, which includes
+   the framework layer.
+2. **Host** — `claude-code`, `gemini-cli`, or `codex`. Auto-detected
+   when you launch `openlife init` from inside one of these CLIs.
+3. **API keys** — paste your `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`,
+   `GEMINI_API_KEY`, and/or `OPENROUTER_API_KEY`. Press Enter to skip
+   any one. Keys are saved to `.env` in the project directory.
+4. **OAuth pointer** — answer `y` if you plan to use `openlife auth
+   gemini` or `openlife auth openai` later. The wizard does not start
+   the OAuth flow itself; it just reminds you to run those commands
+   after init completes.
+5. **Model chain** — comma-separated `provider/model` list, e.g.
+   `openai-api/gpt-5.4-mini,anthropic-api/claude-sonnet-4-6`. Leave
+   blank to accept the defaults from `models.json`.
+6. **Telegram** (autonomous only) — confirm whether `TELEGRAM_BOT_TOKEN`
+   and `OPENLIFE_TELEGRAM_ALLOWED_USER_ID` are already in `.env`.
+7. **Doctor** — answer `n` to run system diagnostics after install.
+8. **Confirm** — review the summary and answer `Y` to proceed.
+
+When the wizard finishes you should see:
+
+```
+✅ OpenLife ready.
+
+Try:
+  openlife ask "hello, what can you do?"
+  openlife status
+  openlife --help
+
+Docs: https://github.com/GOOODZ/openlife-core
+```
+
+## 3. Try your first command
+
+```bash
+openlife ask "summarize this README in one sentence"
+```
+
+OpenLife will route the request to the highest-priority model in your
+chain that has a working key. If no API key is configured, it falls
+back to local Ollama (if available) or returns an error.
+
+## 4. Common follow-ups
+
+- **Set up OAuth (no API key needed):**
+  ```bash
+  openlife auth gemini    # browser-based Google login
+  openlife auth openai    # browser-based OpenAI login
+  ```
+- **Start the autonomous daemon (autonomous profile):**
+  ```bash
+  openlife start --daemon
+  ```
+- **Inspect runtime state:**
+  ```bash
+  ls .openlife/
+  cat .openlife/heartbeat.json
+  cat .openlife/install-manifest.json
+  ```
+- **Update to latest version:**
+  ```bash
+  npm install -g @openlife/cli@latest
+  ```
+
+## Troubleshooting
+
+### `openlife: command not found` after install
+
+The global npm bin directory is probably not on your `PATH`. Run:
+
+```bash
+npm bin -g
+```
+
+Add that path to your shell profile (`~/.bashrc`, `~/.zshrc`).
+
+### `npm install -g` says EEXIST
+
+You have a leftover symlink from a previous `npm link`. Run:
+
+```bash
+npm unlink -g @openlife/cli
+rm -f $(which openlife)
+npm install -g @openlife/cli
+```
+
+### `openlife ask` fails with `MODEL_TIMEOUT` or `no provider available`
+
+No API key is configured and no fallback (Ollama, OAuth) is wired up.
+Either:
+
+- Edit `.env` to add `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or
+  `GEMINI_API_KEY`, then retry, or
+- Run `openlife auth gemini` / `openlife auth openai` to use OAuth, or
+- Start a local Ollama server (`ollama serve`) and set
+  `OPENLIFE_ENABLE_OLLAMA=true` in `.env`.
+
+### Telegram autonomous mode reports `TELEGRAM_NOT_CONFIGURED`
+
+Set both in `.env`:
+
+```
+TELEGRAM_BOT_TOKEN=<from BotFather>
+OPENLIFE_TELEGRAM_ALLOWED_USER_ID=<your Telegram user id>
+```
+
+Then restart with `openlife start --daemon`.
+
+## Where to go next
+
+- [INSTALL.md](../INSTALL.md) — full install options including
+  non-interactive (`openlife system setup`) for CI use.
+- [README.md](../README.md) — feature overview and architecture.
+- [CHANGELOG.md](../CHANGELOG.md) — what changed across versions.
+- [CONTRIBUTING.md](../CONTRIBUTING.md) — dev setup and conventions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlife/cli",
-  "version": "1.7.5",
+  "version": "1.7.6",
   "description": "OPEN-LIFE Córtex Orquestrador Dual-Core",
   "main": "dist/index.js",
   "files": [
@@ -10,6 +10,7 @@
     "dist-templates",
     "docs/README.md",
     "docs/quickstart.md",
+    "docs/getting-started.md",
     "docs/workflow-schema.md",
     "docs/toolset-enforcement.md",
     "docs/release-process.md",