dodo-mcp 1.0.6 → 1.2.0

package/README.md

@@ -1,17 +1,18 @@
 # DODO MCP
 
-**DODO MCP 1.0.6** คือ MCP server แบบ local-first สำหรับให้ AI ช่วยพัฒนา software โดยทำงานกับ workspace ที่เจ้าของเลือก ค่าเริ่มต้นเป็นโหมดส่วนตัวแบบเพิ่มโปรเจกต์แล้วใช้ได้ทันที และยังมีโหมด managed สำหรับแยก workspace ACL/trust แบบละเอียด
+**DODO MCP** คือ MCP server แบบ local-first สำหรับให้ AI ช่วยพัฒนา software โดยทำงานกับ workspace ที่เจ้าของเลือก ค่าเริ่มต้นเป็นโหมดส่วนตัวแบบเพิ่มโปรเจกต์แล้วใช้ได้ทันที และยังมีโหมด managed สำหรับแยก workspace ACL/trust แบบละเอียด
 
 ## จุดเด่น
 
 - MCP ผ่าน HTTP ที่ `127.0.0.1:21730/mcp` พร้อม OAuth และ PKCE
 - Local Config แบบ loopback ที่ `127.0.0.1:21731` และ Remote Config ชั่วคราวผ่าน tunnel เมื่อเจ้าของสั่ง `dodo --web`
-- HTTP ใช้ Compact Tool Surface 19 tools เพื่อลดภาระการโหลด schema
-- STDIO ใช้ Full Tool Surface; มี capability definitions ทั้งหมด 125 รายการ แต่ค่าเริ่มต้นซ่อน Sub-agent 4 operations จาก MCP จึงเห็น 121 tools
+- HTTP ใช้ Compact Tool Surface 20 tools เพื่อลดภาระการโหลด schema
+- STDIO ใช้ Full Tool Surface; มี capability definitions ทั้งหมด 138 รายการ แต่ค่าเริ่มต้นซ่อน Sub-agent 4 operations จาก MCP จึงเห็น 134 tools
 - Hybrid Surface 49 tools สำหรับ client ที่รับ catalog ขนาดกลาง
 - อ่าน ค้นหา สร้าง แก้ ย้าย ลบไฟล์ พร้อม expected hash, journal และ rollback
 - รันคำสั่ง งานแบบขนาน jobs, Git, TypeScript/JavaScript intelligence, LSP และ task assistance
 - รองรับภาพ เสียง วิดีโอ เบราว์เซอร์ เกม และ workflow ตาม dependency และ permission ที่เจ้าของเปิดใช้
+- ตรวจและควบคุมมือถือ Android ผ่าน ADB ได้ตั้งแต่ภาพหน้าจอ/UI/logcat ไปจนถึง input, apps, APK, file transfer และ device-side shell โดยจำกัดเฉพาะ serial ที่เจ้าของอนุญาต ([คู่มือ](docs/ANDROID.md))
 - มี Universal Resource Layer + CAS สำหรับ text/binary/image/audio/video/PDF/ZIP/WASM พร้อม SHA-256, dedup, bounded range/resume และ MCP image/audio blocks
 - มี Project Brain ที่ทำ incremental AST index สำหรับ symbols, references, imports, routes, tests และ dependencies พร้อม source-hash freshness
 - มี Context Engine สำหรับ goal-driven retrieval แบบมี budget, provenance, confidence, freshness และ L0–L6 dependency cache
@@ -35,9 +36,9 @@ dodo setup --check
 dodo --cli
 ```
 
-### Android / Termux (ทดลองใช้)
+### Android / ADB และ Termux
 
-DODO 1.0.6 ไม่โหลด Sharp ตั้งแต่เริ่ม CLI อีกต่อไป จึงใช้คำสั่งพื้นฐานและ MCP
+DODO ไม่โหลด Sharp ตั้งแต่เริ่ม CLI จึงใช้คำสั่งพื้นฐานและ MCP
 สำหรับ text/code ได้แม้เครื่องไม่มี native Sharp build แพ็กเกจมี WebAssembly image backend
 เป็น optional dependency; หาก npm ข้าม optional dependency ให้ติดตั้งเพิ่มแล้วเปิด DODO ใหม่:
 
@@ -51,6 +52,18 @@ dodo --version
 OS credential store, sandbox, desktop control และ browser automation ยังไม่ได้ผ่าน
 Android acceptance ครบ ดูข้อจำกัดและวิธีตรวจรับที่ [Android / Termux](docs/ANDROID.md)
 
+ถ้าต้องการให้ AI ตรวจหรือควบคุมมือถือที่เชื่อมกับเครื่องนี้ ให้ติดตั้ง Platform-Tools,
+เปิด USB/Wireless debugging และยอมรับ RSA prompt บนมือถือ จากนั้นอนุญาต exact serial:
+
+```bash
+dodo setup --check --components adb
+dodo android devices
+dodo android allow --device SERIAL --mode control --persist --yes
+```
+
+Full surface มี `android_*` 13 operations ส่วน HTTP Compact ใช้ `dodo_mobile` gateway
+สิทธิ์นี้ไม่ปิด OAuth, project context, trust/approval, expected hash หรือ audit
+
 ## เชื่อม ChatGPT ภายในไม่กี่นาที
 
 ChatGPT ต้องเชื่อมผ่าน **Public MCP URL** ของ DODO ซึ่งลงท้ายด้วย `/mcp` ส่วน
@@ -102,7 +115,7 @@ dodo auth approve REQUEST_ID
 ```
 
 กลับไปที่ ChatGPT รอให้ scan เสร็จ เริ่มแชตใหม่ เลือก DODO ใน Developer mode แล้ว
-ทดสอบด้วย `ใช้ DODO เรียก project_overview` HTTP จะแสดง Compact surface ประมาณ 19
+ทดสอบด้วย `ใช้ DODO เรียก project_overview` HTTP จะแสดง Compact surface 20
 tools และเข้าถึง operations ที่เหลือผ่าน `dodo_discover` กับ gateway ตามสิทธิ์เดิม
 
 ดูขั้นตอนเต็มและวิธีแก้ OAuth/Tunnel ที่ [เชื่อม Web clients](docs/WEB_CLIENTS.md)
@@ -156,6 +169,35 @@ Chat & Tasks · Runs & Jobs · Approvals · Knowledge · Settings) หน้า
 สร้าง MCP app ใหม่ตามพฤติกรรมของ client การตั้งค่านี้เปลี่ยนเฉพาะการมองเห็น tools
 และไม่เพิ่ม OAuth scope, trust, approval หรือสิทธิ์ของ profile
 
+### เพิ่มโปรเจกต์ครั้งเดียว แล้วสั่งงานด้วยชื่อ
+
+เพิ่มโปรเจกต์จากหน้า Projects (หรือ CLI) โดยกรอกแค่ **ชื่อ**, **absolute path** และ
+**ระดับการเข้าถึง** หนึ่งค่า:
+
+| ระดับ | AI ทำอะไรได้ |
+|---|---|
+| อ่านอย่างเดียว | อ่าน ค้นหา วิเคราะห์ |
+| แก้ไข | อ่านและแก้ไฟล์ |
+| ทำงานเต็มรูปแบบ | อ่าน แก้ไฟล์ และรันคำสั่ง/ทดสอบ |
+
+```bash
+dodo project add "C:\Users\User\Desktop\auto-upload" --name "auto-upload" --access full
+dodo project access "auto-upload" --mode edit
+dodo project list
+```
+
+ในโหมดส่วนตัว (ค่าเริ่มต้น) เท่านี้ก็พร้อมใช้ — ไม่ต้องตั้ง Client ACL, Trust หรือ
+profile allowlist ซ้ำอีกหลายหน้า ระดับที่เลือกเป็น **เพดาน** สิทธิ์จริงคือส่วนที่ทับกับ
+OAuth scope ของ client นั้น (token ที่อ่านได้อย่างเดียวจะยังอ่านได้อย่างเดียวเสมอ)
+
+จากนั้นสั่ง AI ด้วยชื่อโปรเจกต์ได้ตรง ๆ:
+
+> "ใช้ DODO แก้โปรเจกต์ auto-upload"
+
+AI จะ resolve ชื่อเอง (`project_overview` ด้วย `targetProject: "auto-upload"`) รับ
+`workspaceId`/`workspaceEpoch` ของโปรเจกต์นั้น แล้วส่ง `targetProject` ไปกับทุกคำสั่งถัดไป
+เจ้าของไม่ต้องรู้หรือพิมพ์ project ID เลย ดู [docs/PROJECTS.md](docs/PROJECTS.md)
+
 ลงทะเบียนโปรเจกต์ที่ต้องการใช้งานบ่อยได้โดยไม่เริ่ม server:
 
 ```bash
@@ -328,14 +370,22 @@ command sandbox, idempotency และ audit เดิม `agent_exec` ใช้
 
 ### เชื่อม Remote MCP ผ่าน Cloudflare Tunnel
 
-DODO เลือกวิธีเชื่อมต่อระดับ installation ได้หนึ่งแบบ: `local` หรือ `tunnel` ค่าที่เลือก
-มีผลกับทุก `dodo start` และไม่มี fallback อัตโนมัติ หากเลือก Tunnel แล้ว credential หรือ
-readiness ไม่พร้อม DODO จะหยุด startup แทนการเปิด local โดยไม่แจ้ง
+DODO เลือกวิธีเชื่อมต่อระดับ installation ได้หนึ่งแบบ: `local` (loopback เท่านั้น),
+`external` (Cloudflare ที่เจ้าของติดตั้ง/รันเอง) หรือ `tunnel` (DODO ดูแล cloudflared)
+ค่าที่เลือกมีผลกับทุก `dodo start` และไม่มี fallback อัตโนมัติ
+
+เฉพาะเครื่อง:
+
+```bash
+dodo tunnel configure --loopback
+dodo start
+```
 
-Local mode:
+Cloudflare Local (ติดตั้งในเครื่อง) — ผู้ใช้ดูแล process/token เอง:
 
 ```bash
-dodo tunnel configure --local
+dodo tunnel configure --cloudflare-local --public-url https://mcp.example.com
+# เริ่ม cloudflared ที่ติดตั้งในเครื่องด้วยวิธีของผู้ใช้
 dodo start
 ```
 
@@ -352,7 +402,8 @@ dodo start
 
 เจ้าของสร้าง remotely-managed Tunnel, public hostname และ DNS ใน Cloudflare และ route
 **ทุก path** มาที่ `http://127.0.0.1:21730` DODO ไม่จัดการ Cloudflare account/DNS
-Token ถูกบันทึกใน macOS Keychain, Windows Credential Manager หรือ Linux Secret Service;
+เฉพาะ DODO Tunnel เท่านั้นที่ใช้ token ซึ่งถูกบันทึกใน macOS Keychain, Windows
+Credential Manager หรือ Linux Secret Service;
 global config เก็บเพียง opaque reference ทุกครั้งที่เปิด DODO ระบบจะเริ่ม
 `cloudflared` เป็น child และหยุด child พร้อม DODO Token ไม่อยู่ใน argv, config, log,
 audit, browser storage, MCP response หรือ environment ของ MCP jobs
@@ -369,14 +420,17 @@ dodo web --close    # ปิดหน้า Remote Config แต่ MCP/Tunnel
 terminal หลังจับคู่ browser จะใช้ cookie ที่เป็น `Secure`, `HttpOnly`,
 `SameSite=Strict` และจำกัด path ที่ `/config` หน้า Remote Config ปิดอัตโนมัติภายใน
 1 ชั่วโมง การเปิดใหม่ออก code/session ใหม่และไม่ต้อง restart MCP ไม่มี token หรือ
-credential อยู่ใน URL คำสั่งนี้ใช้ได้เฉพาะเมื่อ persistent mode เป็น `tunnel` และ
-DODO-owned Tunnel กำลังทำงาน; มันไม่รับ token ใหม่ผ่าน IPC และไม่เปลี่ยนจาก Local เอง
-
-หน้า Local Config ที่ `127.0.0.1:21731` เลือก Local/Tunnel, ตั้ง public origin และบันทึก
-token แบบ write-only เข้า OS credential store ได้ ค่าใหม่มีผลหลัง restart หน้าเว็บแสดง
-Active MCP URL จาก runtime จริงและไม่กล่าวว่า Tunnel หรือ AI client เชื่อมแล้วหากไม่มี
-หลักฐาน ดูสถานะด้วย `dodo tunnel status`, ตรวจ connectivity ด้วย `dodo tunnel doctor`
-และดู log ที่ redacted ด้วย `dodo tunnel logs`
+credential อยู่ใน URL ใช้ได้ทั้งโหมด **Cloudflare Local** ที่เจ้าของรัน
+`cloudflared` เอง และ **DODO Tunnel** ที่ DODO ดูแล process; โหมดเฉพาะเครื่องไม่มี
+public route จึงเปิด Remote Config ไม่ได้
+
+หน้า Local Config ที่ `127.0.0.1:21731` แยกตัวเลือกชัดเจนเป็น
+**เฉพาะเครื่อง (Loopback)**, **Cloudflare Local (ติดตั้งในเครื่อง)** และ
+**DODO Tunnel** ตั้ง public origin ได้ และรับ token แบบ write-only เฉพาะ DODO Tunnel
+ค่าใหม่มีผลหลัง restart หน้าเว็บแสดง Active MCP URL จาก runtime จริงและไม่กล่าวว่า
+Tunnel หรือ AI client เชื่อมแล้วหากไม่มีหลักฐาน ดูสถานะด้วย `dodo tunnel status`,
+ตรวจ connectivity ด้วย `dodo tunnel doctor` และดู log ที่ redacted ด้วย
+`dodo tunnel logs` (log/supervisor ใช้กับ DODO Tunnel เท่านั้น)
 
 บน macOS `dodo setup --yes` เลือก component `cloudflared` อยู่ในชุด `all` แล้ว
 Tunnel route ต้องชี้เฉพาะ MCP/OAuth listener `21730` ห้ามชี้ Local Config `21731`

package/dist/cli/main.js

@@ -22,8 +22,11 @@ import { TRUST_MODE_DESCRIPTIONS } from '../security/policy.js';
 import { DodoError } from '../errors.js';
 import { sandboxAvailability } from '../services/jobs/sandbox.js';
 import { DesktopPolicyInputSchema, saveDesktopPolicy } from '../services/desktop/desktopPolicy.js';
+import { AndroidPolicyInputSchema, saveAndroidPolicy } from '../services/android/androidPolicy.js';
 import { INPUT_LIMIT_PROFILES } from '../config/limits.js';
 import { ProjectRegistry } from '../projects/registry.js';
+import { ProjectAdmin } from '../projects/ownerAdmin.js';
+import { LEVEL_SUMMARY, parseProjectAccessLevel } from '../security/projectAccess.js';
 import { runCliMenu } from './menu.js';
 import { TunnelRuntime } from '../tunnel/runtime.js';
 import { INSTALLATION_AUTHORITY_ID } from '../auth/constants.js';
@@ -84,11 +87,16 @@ function withProjectRegistry(fn) {
         db.close();
     }
 }
+/** The CLI and Local Config share ONE owner-administration service. */
+function withProjectAdmin(fn) {
+    return withProjectRegistry((_registry, store) => fn(new ProjectAdmin(store), store));
+}
 function projectLines(project) {
     return [
         `${project.displayName}  ${project.projectId}`,
         `  Path: ${project.root}`,
         `  Workspace: ${project.workspaceId}`,
+        `  Access: ${project.accessLevel} — ${LEVEL_SUMMARY[project.accessLevel]}`,
         `  Status: ${project.availability} — ${project.statusText}`,
         `  Updated: ${new Date(project.updatedAt).toISOString()}`,
         ...(project.removedAt === null ? [] : [`  Removed: ${new Date(project.removedAt).toISOString()}`]),
@@ -145,20 +153,22 @@ async function launchHttp(opts) {
     const connectionMode = config.tunnel.connectionMode;
     const publicUrl = config.publicUrl;
     const selectedPort = opts.port ?? config.port;
-    if (connectionMode === 'tunnel') {
+    if (connectionMode !== 'local') {
         if (!publicUrl)
-            fail('Tunnel mode requires a public HTTPS origin; run dodo tunnel configure --tunnel --os-credential --public-url https://your-host');
+            fail('Cloudflare mode requires a public HTTPS origin; configure Cloudflare Local or DODO Tunnel with --public-url https://your-host');
         validatePublicUrl(publicUrl, false);
+    }
+    if (connectionMode === 'tunnel') {
         if (!config.tunnel.credentialRef)
             fail('Tunnel mode requires a saved credential; run dodo tunnel configure --tunnel --os-credential --public-url https://your-host');
     }
-    else {
+    else if (connectionMode === 'local') {
         if (opts.web)
-            fail('Remote Config requires Tunnel mode; configure Tunnel, restart DODO, then run dodo --web');
+            fail('Remote Config requires a public Cloudflare connection; select Cloudflare Local or DODO Tunnel, restart DODO, then run dodo --web');
         if (selectedPort === 0)
             fail('local connection mode requires a concrete MCP port');
     }
-    const endpointOrigin = connectionMode === 'tunnel' ? publicUrl : `http://127.0.0.1:${selectedPort}`;
+    const endpointOrigin = connectionMode === 'local' ? `http://127.0.0.1:${selectedPort}` : publicUrl;
     const startOpts = {
         configPort: config.configPort,
         ...(opts.bypass ? { runMode: 'bypass' } : opts.allow ? { runMode: 'allow-all' } : {}),
@@ -203,8 +213,13 @@ async function launchHttp(opts) {
             throw error;
         }
     }
-    else if (!opts.quiet) {
-        console.log(`[dodo] Local connection selected: ${endpointOrigin}/mcp`);
+    else {
+        if (connectionMode === 'external' && opts.web)
+            printRemoteConfig(await ipcForInstallation('remoteConfig.open'));
+        if (!opts.quiet)
+            console.log(connectionMode === 'external'
+                ? `[dodo] Cloudflare Local selected: ${endpointOrigin}/mcp (cloudflared is owner-managed)`
+                : `[dodo] Loopback-only connection selected: ${endpointOrigin}/mcp`);
     }
     async function stop(signal) {
         if (shutdownPromise)
@@ -287,16 +302,40 @@ program.command('setup')
 // trust/client access; those remain keyed by the referenced workspace ID.
 const project = program.command('project').description('manage the local owner-only project registry');
 project.command('add <path>')
-    .description('register an absolute project directory without changing trust or client access')
+    .description('register an absolute project directory and choose what AI clients may do in it')
     .option('--name <display-name>', 'local display name (defaults to the directory name)')
+    .option('--access <level>', 'read | edit | full (read = read/search only, edit = also change files, full = also run commands)')
     .option('--json', 'machine-readable result', false)
     .action((projectPath, opts) => {
     try {
-        const result = withProjectRegistry((registry) => registry.add(projectPath, opts.name));
+        const access = opts.access === undefined ? undefined : parseProjectAccessLevel(opts.access);
+        const result = withProjectAdmin((admin) => admin.add({ path: projectPath, ...(opts.name ? { name: opts.name } : {}), ...(access ? { access } : {}) }));
         printJsonOrLines(opts.json, result, () => [
             result.relocated ? 'Updated the location of an existing project identity.' : result.changed ? 'Project registered.' : 'Project was already registered; nothing changed.',
             ...projectLines(result.project),
-            'Trust, OAuth grants and workspace client access were not changed.',
+            result.project.requiresClientAcl
+                ? 'Managed mode: also allow a client for this project in Local Config before it can be used.'
+                : 'Ready to use. A client may do at most what this level allows, still bounded by its own OAuth scopes.',
+        ]);
+    }
+    catch (error) {
+        if (error instanceof DodoError)
+            fail(`${error.code}: ${error.message}${error.recovery ? `\n  → ${error.recovery}` : ''}`);
+        throw error;
+    }
+});
+project.command('access <project>')
+    .description('set what AI clients may do in a registered project (by name or ID)')
+    .requiredOption('--mode <level>', 'read | edit | full')
+    .option('--json', 'machine-readable result', false)
+    .action((reference, opts) => {
+    try {
+        const level = parseProjectAccessLevel(opts.mode);
+        const updated = withProjectAdmin((admin) => admin.setAccess(admin.resolve(reference).projectId, level));
+        printJsonOrLines(opts.json, updated, () => [
+            `Access level for ${updated.displayName} is now ${updated.accessLevel}.`,
+            ...projectLines(updated),
+            'OAuth scopes, trust, approvals, path/secret guards and the command sandbox are unchanged.',
         ]);
     }
     catch (error) {
@@ -306,7 +345,7 @@ project.command('add <path>')
     }
 });
 project.command('list')
-    .description('list registered projects and current path readiness')
+    .description('list registered projects, their access level and current path readiness')
     .option('--all', 'include reviewed removals', false)
     .option('--json', 'machine-readable output', false)
     .action((opts) => {
@@ -365,12 +404,14 @@ project.command('remove <projectId>')
 // --------------------------------------------------------------- tunnel ----
 const tunnel = program.command('tunnel').description('manage or inspect a Cloudflare remotely-managed Tunnel without managing DNS or the Cloudflare account');
 tunnel.command('configure')
-    .description('select persistent local or DODO-owned Tunnel mode; tokens are never written to config')
+    .description('select loopback, owner-managed Cloudflare Local, or DODO-owned Tunnel mode; tokens are never written to config')
     .option('--tunnel', 'select the DODO-owned Tunnel for every dodo start', false)
-    .option('--local', 'select local-only MCP for every dodo start', false)
+    .option('--cloudflare-local', 'use cloudflared installed and run by the owner; DODO advertises only the saved public origin', false)
+    .option('--loopback', 'select loopback-only MCP for every dodo start', false)
+    .option('--local', 'deprecated alias for --loopback', false)
     .option('--managed', 'deprecated alias for --tunnel', false)
-    .option('--external', 'deprecated alias for --local', false)
-    .option('--public-url <url>', 'public HTTPS origin used by the selected DODO Tunnel')
+    .option('--external', 'alias for --cloudflare-local', false)
+    .option('--public-url <url>', 'public HTTPS origin used by Cloudflare Local or DODO Tunnel')
     .option('--os-credential', 'prompt through the reviewed OS credential provider', false)
     .option('--token-env <name>', 'reference an uppercase environment variable that already contains the token')
     .option('--token-file <absolute-path>', 'reference an owner-private absolute token file')
@@ -383,9 +424,10 @@ tunnel.command('configure')
     .action(async (opts) => {
     try {
         const chooseTunnel = opts.tunnel || opts.managed;
-        const chooseLocal = opts.local || opts.external;
-        if (chooseTunnel && chooseLocal)
-            fail('choose --tunnel or --local');
+        const chooseExternal = opts.cloudflareLocal || opts.external;
+        const chooseLoopback = opts.loopback || opts.local;
+        if ([chooseTunnel, chooseExternal, chooseLoopback].filter(Boolean).length > 1)
+            fail('choose only one of --loopback, --cloudflare-local or --tunnel');
         const methods = [opts.osCredential, opts.tokenEnv !== undefined, opts.tokenFile !== undefined].filter(Boolean).length;
         if (methods > 1)
             fail('choose only one of --os-credential, --token-env or --token-file');
@@ -396,16 +438,18 @@ tunnel.command('configure')
         const { dir } = resolveConfigDir(process.env);
         ensureConfigDir(dir);
         const paths = statePaths(dir), current = loadGlobalConfig(paths.configFile);
-        const connectionMode = chooseTunnel ? 'tunnel' : chooseLocal ? 'local' : methods > 0 ? 'tunnel' : current.tunnel.connectionMode;
+        if (chooseExternal && methods > 0)
+            fail('Cloudflare Local is owner-managed and does not accept a Tunnel credential in DODO');
+        const connectionMode = chooseTunnel ? 'tunnel' : chooseExternal ? 'external' : chooseLoopback ? 'local' : methods > 0 ? 'tunnel' : current.tunnel.connectionMode;
         const publicUrl = opts.publicUrl !== undefined
             ? validatePublicUrl(opts.publicUrl, false).origin
             : current.publicUrl;
-        if (connectionMode === 'tunnel' && !publicUrl)
-            fail('Tunnel mode requires --public-url https://your-host (or a previously saved public origin)');
-        if (connectionMode === 'tunnel' && publicUrl)
+        if (connectionMode !== 'local' && !publicUrl)
+            fail('Cloudflare mode requires --public-url https://your-host (or a previously saved public origin)');
+        if (connectionMode !== 'local' && publicUrl)
             validatePublicUrl(publicUrl, false);
         if (connectionMode === 'local' && opts.publicUrl !== undefined)
-            fail('--public-url is used only with --tunnel');
+            fail('--public-url is used only with --cloudflare-local or --tunnel');
         const credentials = await import('../tunnel/credentials.js');
         const { resolveCloudflared } = await import('../tunnel/supervisor.js');
         const previousCredentialRef = current.tunnel.credentialRef;
@@ -445,14 +489,33 @@ tunnel.command('configure')
         saveGlobalConfig(paths.configFile, next);
         if (opts.removeCredential && previousCredentialRef)
             credentials.deleteOsTunnelCredential(previousCredentialRef);
-        const result = { connectionMode: next.tunnel.connectionMode, publicOrigin: next.tunnel.connectionMode === 'tunnel' ? next.publicUrl : null, credential: next.tunnel.credentialRef ? 'configured' : 'not-configured', metricsPort: next.tunnel.metricsPort, maxRestarts: next.tunnel.maxRestarts, cloudflared: next.tunnel.executable ? 'owner-selected' : 'trusted-PATH', started: false };
+        const result = {
+            connectionMode: next.tunnel.connectionMode,
+            publicOrigin: next.tunnel.connectionMode === 'local' ? null : next.publicUrl,
+            credential: next.tunnel.connectionMode === 'tunnel'
+                ? next.tunnel.credentialRef ? 'configured' : 'not-configured'
+                : 'not-used',
+            metricsPort: next.tunnel.metricsPort,
+            maxRestarts: next.tunnel.maxRestarts,
+            cloudflared: next.tunnel.connectionMode === 'local'
+                ? 'not-used'
+                : next.tunnel.connectionMode === 'external'
+                    ? 'owner-managed'
+                    : next.tunnel.executable ? 'owner-selected' : 'trusted-PATH',
+            started: false,
+        };
         if (opts.json)
             console.log(JSON.stringify(result, null, 2));
         else {
             console.log(`Connection mode: ${result.connectionMode}`);
-            console.log(`Credential: ${result.credential} (value is not stored in config or displayed)`);
-            console.log(`Readiness: 127.0.0.1:${result.metricsPort}   Restarts: ${result.maxRestarts}`);
-            console.log(result.connectionMode === 'tunnel' ? 'Saved. Every dodo start now owns this Tunnel and fails closed if it cannot start.' : 'Saved. Every dodo start now uses only the local MCP endpoint.');
+            console.log(`Credential: ${result.credential}${result.connectionMode === 'tunnel' ? ' (value is not stored in config or displayed)' : ''}`);
+            if (result.connectionMode === 'tunnel')
+                console.log(`Readiness: 127.0.0.1:${result.metricsPort}   Restarts: ${result.maxRestarts}`);
+            console.log(result.connectionMode === 'tunnel'
+                ? 'Saved. Every dodo start now owns this Tunnel and fails closed if it cannot start.'
+                : result.connectionMode === 'external'
+                    ? 'Saved. DODO advertises the public origin; you must start and maintain cloudflared on this machine.'
+                    : 'Saved. Every dodo start now uses only the loopback MCP endpoint.');
         }
     }
     catch (error) {
@@ -1422,6 +1485,61 @@ desktop.command('disable').description('revoke and forget installation-wide desk
     console.log(JSON.stringify(saved, null, 2));
     console.log('Desktop access disabled and forgotten for this DODO installation.');
 });
+function saveInstallationAndroidPolicy(input) {
+    const args = AndroidPolicyInputSchema.parse(input);
+    const { dir } = resolveConfigDir(process.env);
+    ensureConfigDir(dir);
+    const db = openDatabase(statePaths(dir).dbFile);
+    try {
+        const store = new Store(db);
+        store.installSecret();
+        return db.transaction(() => saveAndroidPolicy(store, INSTALLATION_AUTHORITY_ID, 'local-cli', args, Date.now()))();
+    }
+    finally {
+        db.close();
+    }
+}
+const android = program.command('android').description('inspect and authorize Android devices connected through ADB');
+android.command('devices').description('list devices visible to the local ADB host; does not grant AI access')
+    .action(async () => {
+    const { NativeAdbBackend, parseAdbDevices } = await import('../services/android/adbBackend.js');
+    const backend = new NativeAdbBackend(process.cwd());
+    const result = await backend.run(['devices', '-l'], { maxStdoutBytes: 128 * 1024 });
+    if (result.code !== 0)
+        fail('ADB could not list devices. Install Platform-Tools and authorize this host on the phone.');
+    console.log(JSON.stringify(parseAdbDevices(result.stdout.toString('utf8')), null, 2));
+});
+android.command('status').description('show Android policy and ADB status for the running workspace')
+    .action(async () => console.log(JSON.stringify(await ipcForCwd('android.status'), null, 2)));
+android.command('allow')
+    .description('allow exact connected ADB serials; --persist remembers once for this DODO installation')
+    .requiredOption('--device <serials...>', 'exact serials from dodo android devices')
+    .option('--mode <mode>', 'view | control', 'view')
+    .option('--minutes <n>', 'temporary permission lifetime 1..480 minutes; excludes --persist', (v) => Number(v))
+    .option('--persist', 'remember these device serials until dodo android disable', false)
+    .option('--yes', 'acknowledge that ADB can expose private data and control the selected devices', false)
+    .action(async (opts) => {
+    if (!['view', 'control'].includes(opts.mode))
+        fail('Android mode must be view or control');
+    if (!opts.yes)
+        fail('ADB can read private device data and CONTROL can change apps/files with the Android shell user. Repeat with --yes to authorize exact serials.');
+    if (opts.persist && opts.minutes !== undefined)
+        fail('use --persist or --minutes, not both');
+    const input = { mode: opts.mode, allowedDevices: opts.device, persistent: opts.persist, ...(opts.minutes !== undefined ? { minutes: opts.minutes } : {}) };
+    if (opts.persist) {
+        console.log(JSON.stringify(saveInstallationAndroidPolicy(input), null, 2));
+        console.log('Remembered for this DODO installation. OAuth dodo:exec, project access, trust/approval and exact serial checks still apply.');
+    }
+    else {
+        console.log(JSON.stringify(await ipcForCwd('android.policy', input), null, 2));
+        console.log('Temporary Android grant: expires or resets on workspace epoch change.');
+    }
+});
+android.command('disable').description('revoke and forget Android ADB access installation-wide')
+    .action(() => {
+    console.log(JSON.stringify(saveInstallationAndroidPolicy({ mode: 'off' }), null, 2));
+    console.log('Android ADB access disabled and forgotten for this DODO installation.');
+});
 // Static-client helpers are imported lazily to keep CLI startup light.
 import { addStaticClient as addStaticClientLocal, listStaticClients as listStaticClientsLocal } from '../auth/clients.js';
 program.addHelpText('after', `
@@ -1436,11 +1554,17 @@ MCP subprocess clients:
 Desktop (platform helper and explicit app permission required):
   dodo desktop setup                 prepare the platform desktop backend
   dodo desktop disable               revoke desktop access
+Android (ADB host authorization and exact-device permission):
+  dodo android devices               list connected/authorized device serials
+  dodo android allow --device SERIAL --mode control --persist --yes
+  dodo android disable               revoke DODO Android access
 Remote setup:
   dodo init --public-url https://...   configure public origin once
+  dodo tunnel configure --cloudflare-local --public-url https://...
+                                       use cloudflared you install/run yourself
   dodo tunnel configure --tunnel --os-credential --public-url https://...
                                        select the persistent DODO Tunnel
-  dodo tunnel configure --local        select local-only MCP
+  dodo tunnel configure --loopback     select loopback-only MCP
   dodo start                            use exactly the saved connection mode
   dodo --web                           start/renew Remote Config through that tunnel for 1 hour
   dodo web --close                     close Remote Config; keep MCP/Tunnel running`);