remoat 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 optimistengineer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,297 @@
+<h1 align="center">Remoat</h1>
+
+<p align="center">
+  <strong>Control your AI coding assistant from anywhere — right from Telegram.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/optimistengineer/Remoat/blob/main/LICENSE"><img src="https://img.shields.io/github/license/optimistengineer/Remoat?style=flat-square" alt="License" /></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square&logo=node.js" alt="Node.js" />
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform" />
+</p>
+
+---
+
+Remoat is a **local Telegram bot** that lets you remotely operate [Antigravity](https://antigravity.dev) IDE on your PC — from your phone, tablet, or any device with Telegram.
+
+Type a natural-language instruction, attach a screenshot, or send a voice note. Remoat dispatches it to Antigravity via Chrome DevTools Protocol, monitors progress in real time, and streams results back to Telegram. Everything runs on your machine.
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Features](#features)
+- [Advanced Setup](#advanced-setup)
+- [Commands](#commands)
+- [Troubleshooting](#troubleshooting)
+- [How It Works](#how-it-works)
+- [Project Structure](#project-structure)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Quick Start
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) 18 or higher
+- [Antigravity](https://antigravity.dev) installed on your machine
+- A [Telegram](https://telegram.org/) account
+
+<details>
+<summary>macOS: you'll also need Xcode Command Line Tools</summary>
+
+Remoat uses `better-sqlite3`, a native C++ module that requires a compiler. If you don't have Xcode CLI tools installed, run:
+
+```bash
+xcode-select --install
+```
+
+You can verify they're installed with `xcode-select -p`.
+
+</details>
+
+### 1. Install Remoat
+
+```bash
+npm install -g remoat
+```
+
+### 2. Run the setup wizard
+
+```bash
+remoat setup
+```
+
+The wizard walks you through:
+
+- **Telegram Bot Token** — Create a bot via [@BotFather](https://t.me/BotFather) on Telegram (`/newbot`), then copy the token it gives you
+- **Allowed User IDs** — Only these Telegram users can control the bot. Message [@userinfobot](https://t.me/userinfobot) to get your ID
+- **Workspace Directory** — The parent directory where your coding projects live (e.g. `~/Code`)
+
+### 3. Launch Antigravity with CDP enabled
+
+```bash
+remoat open
+```
+
+> [!NOTE]
+> If Antigravity is already running, quit it first and relaunch with `remoat open` — it needs the CDP debug port to be enabled.
+
+### 4. Start the Telegram bot (in a new terminal)
+
+```bash
+remoat start
+```
+
+That's it. Open Telegram, find your bot, and start sending instructions.
+
+<details>
+<summary>Voice messages (optional): install the Whisper model</summary>
+
+```bash
+npx nodejs-whisper download
+```
+
+This pulls `base.en` (~140 MB). Requires `cmake` (`brew install cmake` on macOS, `apt install cmake` on Linux).
+
+</details>
+
+> Having issues? Run `remoat doctor` to diagnose your setup.
+
+## Features
+
+**Remote control from anywhere** — Send natural-language prompts, images, or voice notes from your phone. Antigravity executes them on your PC with full local resources.
+
+**Project isolation via Telegram Topics** — Each project maps to a Telegram Forum Topic. All messages within a topic automatically use the correct project directory and session history — no manual context switching needed.
+
+**Real-time progress streaming** — Long-running tasks report progress in phases (sending, thinking, complete) with a live process log and elapsed timer, streamed as Telegram messages.
+
+**Voice input** — Hold the mic button and speak. Remoat transcribes locally via [whisper.cpp](https://github.com/ggerganov/whisper.cpp) — no cloud APIs, no Telegram Premium required.
+
+**Approval routing** — When Antigravity asks for confirmation (file edits, plan decisions), the dialog surfaces in Telegram with inline action buttons. Or toggle `/autoaccept` to approve automatically.
+
+**Security by design** — Whitelist-based access control. Path traversal prevention. Credentials stored locally. No webhooks, no port exposure.
+
+## Advanced Setup
+
+### From source
+
+```bash
+git clone https://github.com/optimistengineer/Remoat.git
+cd Remoat
+npm install
+cp .env.example .env
+```
+
+Edit `.env` with your values:
+
+```env
+TELEGRAM_BOT_TOKEN=your_bot_token_here
+ALLOWED_USER_IDS=123456789
+WORKSPACE_BASE_DIR=~/Code
+USE_TOPICS=true
+```
+
+> [!TIP]
+> Alternatively, run `npm start -- setup` to use the interactive wizard instead of editing `.env` manually.
+
+Then start the bot:
+
+```bash
+npm run dev       # development mode with auto-reload
+# or
+npm start         # run from source
+```
+
+### Launching Antigravity with CDP
+
+Remoat connects to Antigravity via Chrome DevTools Protocol. Launch Antigravity with a debug port enabled:
+
+```bash
+remoat open       # auto-selects an available port (9222, 9223, 9333, 9444, 9555, or 9666)
+```
+
+From source, you can also use the bundled launcher scripts:
+
+| Platform | Method |
+|----------|--------|
+| macOS    | Double-click `start_antigravity_mac.command` (run `chmod +x` first time) |
+| Windows  | Double-click `start_antigravity_win.bat` |
+| Linux    | Set `ANTIGRAVITY_PATH=/path/to/antigravity` in `.env`, then `remoat open` |
+
+> Launch Antigravity first, then start the bot. It connects automatically.
+
+### Forum Topics (optional)
+
+For multi-project workflows, Remoat supports Telegram Forum Topics — each project gets its own topic thread.
+
+1. Create a Telegram supergroup and enable **Topics** in group settings
+2. Add your bot to the group with admin permissions
+3. Set `USE_TOPICS=true` in `.env` (this is the default)
+
+For simpler setups, set `USE_TOPICS=false` and use the bot in a regular chat.
+
+## Commands
+
+### CLI
+
+```
+remoat              auto-detect: runs setup if unconfigured, otherwise starts the bot
+remoat setup        interactive setup wizard
+remoat open         launch Antigravity with CDP port enabled
+remoat start        start the Telegram bot
+remoat doctor       diagnose configuration and connectivity issues
+remoat --verbose    show debug-level logs (CDP traffic, detector events)
+remoat --quiet      errors only
+```
+
+### Telegram
+
+| Command | Description |
+|---------|-------------|
+| `/project` | Browse and select a project (inline keyboard) |
+| `/new` | Start a new chat session in the current project |
+| `/chat` | Show current session info and list all sessions |
+| | |
+| `/model [name]` | Switch the LLM model (e.g. `gemini-2.5-pro`, `claude-opus-4-6`) |
+| `/mode` | Switch execution mode (`fast`, `plan`) |
+| `/stop` | Force-stop a running Antigravity task |
+| | |
+| `/template` | List registered prompt templates with execute buttons |
+| `/template_add <name> <prompt>` | Register a new prompt template |
+| `/template_delete <name>` | Delete a template |
+| | |
+| `/screenshot` | Capture and send Antigravity's current screen |
+| `/status` | Show connection status, active project, and current mode |
+| `/autoaccept` | Toggle auto-approval of file edit dialogs |
+| `/cleanup [days]` | Clean up inactive session topics (default: 7 days) |
+| `/help` | Show available commands |
+
+### Natural Language
+
+Just type in any bound topic or direct chat:
+
+> _refactor the auth components — see the attached screenshot for the target layout_
+
+Or hold the mic button and speak — the voice note gets transcribed locally and sent as a prompt.
+
+## Troubleshooting
+
+Run diagnostics first:
+
+```bash
+remoat doctor
+```
+
+This checks your config, Node.js version, Xcode tools (macOS), Antigravity installation, and CDP port connectivity.
+
+**`npm install` fails with `gyp ERR!` on macOS** — Install Xcode Command Line Tools: `xcode-select --install`
+
+**`remoat open` can't find Antigravity** — The app must be in `/Applications`. If you installed it elsewhere, set `ANTIGRAVITY_PATH` in your `.env` file or environment:
+
+```bash
+export ANTIGRAVITY_PATH=/path/to/Antigravity
+remoat open
+```
+
+**Bot not responding to messages** — Make sure Antigravity is running with CDP enabled (`remoat open`) before starting the bot. The bot will warn you on startup if no CDP ports are responding, but it continues running and auto-connects once Antigravity is available.
+
+**CDP connection lost** — If you restart Antigravity, the bot auto-reconnects. Sending any message also triggers reconnection.
+
+**Verbose logging:**
+
+```bash
+remoat --verbose      # see CDP traffic, detector events, and internal state
+```
+
+## How It Works
+
+<p align="center">
+  <a href="https://excalidraw.com/#json=a54sSDUatTXGCtJORO7GJ,muz3R_zi4nbj9RKuRAfbEA">
+    <img src="docs/images/architecture.svg" alt="Remoat architecture diagram" width="700" />
+  </a>
+</p>
+
+1. You send a message in Telegram
+2. Remoat authenticates it against your whitelist, resolves the project context, and injects the prompt into Antigravity via CDP
+3. A response monitor polls Antigravity's DOM at 2-second intervals, detecting progress phases, approval dialogs, errors, and completion
+4. Results stream back to Telegram as formatted messages
+
+The bot never exposes a port, never forwards traffic externally, and never stores your code anywhere but your local disk.
+
+> For a deeper dive, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). Click the diagram above for an [interactive version](https://excalidraw.com/#json=a54sSDUatTXGCtJORO7GJ,muz3R_zi4nbj9RKuRAfbEA).
+
+## Project Structure
+
+```
+src/
+  bin/          CLI entry point (Commander subcommands)
+  bot/          grammy bot — event handling, command routing, callback queries
+  commands/     Telegram slash command handlers and message parser
+  services/     core business logic (CDP, response monitoring, detectors, sessions)
+  database/     SQLite repositories (sessions, workspace bindings, templates, schedules)
+  middleware/   auth (user ID whitelist) and input sanitization
+  ui/           Telegram InlineKeyboard builders
+  utils/        config, logging, formatting, i18n, path security, voice/image handling
+tests/          test files mirroring src/ structure
+docs/           architecture docs, DOM selector reference, diagrams
+locales/        i18n translations (en, ja)
+```
+
+## Contributing
+
+Contributions are welcome — whether it's a bug fix, a new feature, documentation improvements, or test coverage.
+
+```bash
+git clone https://github.com/optimistengineer/Remoat.git
+cd Remoat
+npm install
+cp .env.example .env  # fill in your values
+npm run dev           # start with auto-reload
+npm test              # run the test suite
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide — code style, commit conventions, PR process, and project architecture.
+
+## License
+
+[MIT](LICENSE)

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const package_json_1 = require("../../package.json");
+const start_1 = require("./commands/start");
+const doctor_1 = require("./commands/doctor");
+const setup_1 = require("./commands/setup");
+const open_1 = require("./commands/open");
+const configLoader_1 = require("../utils/configLoader");
+const program = new commander_1.Command()
+    .name('remoat')
+    .description('Control your AI coding assistant from Telegram')
+    .version(package_json_1.version)
+    .option('--verbose', 'Show debug-level logs')
+    .option('--quiet', 'Only show errors');
+// Default action: no subcommand → start or setup
+program.action(async () => {
+    const hasConfig = configLoader_1.ConfigLoader.configExists();
+    const hasEnv = fs.existsSync(path.resolve(process.cwd(), '.env'));
+    if (!hasConfig && !hasEnv) {
+        return (0, setup_1.setupAction)();
+    }
+    else {
+        return (0, start_1.startAction)(program.opts(), program);
+    }
+});
+program
+    .command('start')
+    .description('Start the Telegram bot')
+    .action((_opts, cmd) => (0, start_1.startAction)(cmd.parent.opts(), cmd.parent));
+program
+    .command('doctor')
+    .description('Check environment and dependencies')
+    .action(doctor_1.doctorAction);
+program
+    .command('setup')
+    .description('Interactive setup wizard')
+    .action(setup_1.setupAction);
+program
+    .command('open')
+    .description('Open Antigravity with CDP enabled (auto-selects available port)')
+    .action(open_1.openAction);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,uCAAyB;AACzB,2CAA6B;AAC7B,yCAAoC;AACpC,qDAA6C;AAC7C,4CAA+C;AAC/C,8CAAiD;AACjD,4CAA+C;AAC/C,0CAA6C;AAC7C,wDAAqD;AAErD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE;KACxB,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,gDAAgD,CAAC;KAC7D,OAAO,CAAC,sBAAO,CAAC;KAChB,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC;KAC5C,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAE3C,iDAAiD;AACjD,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IACtB,MAAM,SAAS,GAAG,2BAAY,CAAC,YAAY,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAElE,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,IAAA,mBAAW,GAAE,CAAC;IACzB,CAAC;SAAM,CAAC;QACJ,OAAO,IAAA,mBAAW,EAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wBAAwB,CAAC;KACrC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAExE,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,qBAAY,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,mBAAW,CAAC,CAAC;AAEzB,OAAO;KACF,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,iBAAU,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/bin/commands/doctor.d.ts

@@ -0,0 +1 @@
+export declare function doctorAction(): Promise<void>;

package/dist/bin/commands/doctor.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorAction = doctorAction;
+const http = __importStar(require("http"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const cdpPorts_1 = require("../../utils/cdpPorts");
+const configLoader_1 = require("../../utils/configLoader");
+const pathUtils_1 = require("../../utils/pathUtils");
+const logger_1 = require("../../utils/logger");
+const ok = (msg) => console.log(`  ${logger_1.COLORS.green}[OK]${logger_1.COLORS.reset} ${msg}`);
+const warn = (msg) => console.log(`  ${logger_1.COLORS.yellow}[--]${logger_1.COLORS.reset} ${msg}`);
+const fail = (msg) => console.log(`  ${logger_1.COLORS.red}[!!]${logger_1.COLORS.reset} ${msg}`);
+const hint = (msg) => console.log(`       ${logger_1.COLORS.dim}${msg}${logger_1.COLORS.reset}`);
+function checkPort(port) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://127.0.0.1:${port}/json/list`, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    resolve(Array.isArray(parsed));
+                }
+                catch {
+                    resolve(false);
+                }
+            });
+        });
+        req.on('error', () => resolve(false));
+        req.setTimeout(2000, () => {
+            req.destroy();
+            resolve(false);
+        });
+    });
+}
+function checkEnvFile() {
+    const envPath = path.resolve(process.cwd(), '.env');
+    return { exists: fs.existsSync(envPath), path: envPath };
+}
+function checkRequiredEnvVars() {
+    const required = ['TELEGRAM_BOT_TOKEN', 'ALLOWED_USER_IDS'];
+    // Also check config.json values
+    let persisted = {};
+    try {
+        const configPath = configLoader_1.ConfigLoader.getConfigFilePath();
+        if (fs.existsSync(configPath)) {
+            persisted = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+    }
+    catch { /* ignore parse errors here */ }
+    const configKeyMap = {
+        TELEGRAM_BOT_TOKEN: 'telegramBotToken',
+        ALLOWED_USER_IDS: 'allowedUserIds',
+    };
+    return required.map((name) => ({
+        name,
+        set: Boolean(process.env[name]) || Boolean(persisted[configKeyMap[name]]),
+    }));
+}
+async function doctorAction() {
+    console.log(`\n${logger_1.COLORS.cyan}remoat doctor${logger_1.COLORS.reset}\n`);
+    let allOk = true;
+    // 1. Config directory check
+    const configDir = configLoader_1.ConfigLoader.getConfigDir();
+    if (fs.existsSync(configDir)) {
+        ok(`Config directory exists: ${configDir}`);
+    }
+    else {
+        warn(`Config directory not found: ${configDir}`);
+        hint('Run: remoat setup  (optional if using .env)');
+    }
+    // 2. Config file check
+    const configFilePath = configLoader_1.ConfigLoader.getConfigFilePath();
+    if (configLoader_1.ConfigLoader.configExists()) {
+        ok(`Config file found: ${configFilePath}`);
+    }
+    else {
+        warn(`Config file not found: ${configFilePath} (optional — .env fallback used)`);
+    }
+    // 3. .env file check
+    const env = checkEnvFile();
+    if (env.exists) {
+        // Load .env so subsequent checks can see the variables
+        require('dotenv').config({ path: env.path });
+        ok(`.env file found: ${env.path}`);
+    }
+    else {
+        if (!configLoader_1.ConfigLoader.configExists()) {
+            fail(`.env file not found: ${env.path}`);
+            allOk = false;
+        }
+        else {
+            warn(`.env file not found: ${env.path} (not needed — config.json used)`);
+        }
+    }
+    // 4. Required environment variables (checks both .env and config.json)
+    const vars = checkRequiredEnvVars();
+    for (const v of vars) {
+        if (v.set) {
+            ok(`${v.name} is set`);
+        }
+        else {
+            fail(`${v.name} is NOT set`);
+            allOk = false;
+        }
+    }
+    // 5. Node.js version check
+    const nodeVersion = process.versions.node;
+    const major = parseInt(nodeVersion.split('.')[0], 10);
+    if (major >= 18) {
+        ok(`Node.js ${nodeVersion}`);
+    }
+    else {
+        fail(`Node.js ${nodeVersion} (>= 18.0.0 required)`);
+        allOk = false;
+    }
+    // 6. Platform-specific checks
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        // Check Xcode Command Line Tools (needed for native module compilation)
+        try {
+            (0, child_process_1.execFileSync)('xcode-select', ['-p'], { stdio: 'pipe' });
+            ok('Xcode Command Line Tools installed');
+        }
+        catch {
+            warn('Xcode Command Line Tools not found');
+            hint('Install with: xcode-select --install');
+            hint('Required for native dependencies (better-sqlite3)');
+        }
+        // Check if Antigravity.app exists
+        const antigravityPath = process.env.ANTIGRAVITY_PATH;
+        if (antigravityPath) {
+            if (fs.existsSync(antigravityPath)) {
+                ok(`Antigravity found: ${antigravityPath}`);
+            }
+            else {
+                fail(`ANTIGRAVITY_PATH set but not found: ${antigravityPath}`);
+                allOk = false;
+            }
+        }
+        else if (fs.existsSync('/Applications/Antigravity.app')) {
+            ok('Antigravity.app found in /Applications');
+        }
+        else {
+            warn('Antigravity.app not found in /Applications');
+            hint('Install Antigravity, or set ANTIGRAVITY_PATH in .env');
+        }
+    }
+    // 7. CDP port check
+    console.log(`\n  ${logger_1.COLORS.dim}Checking CDP ports...${logger_1.COLORS.reset}`);
+    let cdpOk = false;
+    for (const port of cdpPorts_1.CDP_PORTS) {
+        const alive = await checkPort(port);
+        if (alive) {
+            ok(`CDP port ${port} is responding`);
+            cdpOk = true;
+        }
+    }
+    if (!cdpOk) {
+        fail('No CDP ports responding');
+        hint(`Run: remoat open`);
+        hint(`Or manually: ${(0, pathUtils_1.getAntigravityCdpHint)(9222)}`);
+        allOk = false;
+    }
+    // Summary
+    console.log('');
+    if (allOk) {
+        console.log(`  ${logger_1.COLORS.green}All checks passed!${logger_1.COLORS.reset}`);
+    }
+    else {
+        console.log(`  ${logger_1.COLORS.red}Some checks failed. Please fix the issues above.${logger_1.COLORS.reset}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/bin/commands/doctor.js.map

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

package/dist/bin/commands/open.d.ts

@@ -0,0 +1 @@
+export declare function openAction(): Promise<void>;