genbox 1.0.176 → 1.0.177

package/dist/commands/connect.js

@@ -42,6 +42,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const api_1 = require("../api");
 const genbox_selector_1 = require("../genbox-selector");
 const ssh_config_1 = require("../ssh-config");
+const local_session_manager_1 = require("../lib/local-session-manager");
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
@@ -60,13 +61,13 @@ function getPrivateSshKey() {
     throw new Error('No SSH private key found in ~/.ssh/');
 }
 exports.connectCommand = new commander_1.Command('connect')
-    .description('SSH into a Genbox')
+    .description('SSH into a Genbox (or attach to local genbox)')
     .argument('[name]', 'Name of the Genbox (optional - will prompt if not provided)')
     .option('-a, --all', 'Select from all genboxes (not just current project)')
     .action(async (name, options) => {
     try {
         // 1. Select Genbox (interactive if no name provided)
-        const { genbox: target, cancelled } = await (0, genbox_selector_1.selectGenbox)(name, {
+        const { genbox: target, cancelled, isLocal, localSession } = await (0, genbox_selector_1.selectGenbox)(name, {
             all: options.all,
             selectMessage: 'Select a genbox to connect to:',
         });
@@ -77,6 +78,13 @@ exports.connectCommand = new commander_1.Command('connect')
         if (!target) {
             return;
         }
+        // Handle local genbox - attach to session
+        if (isLocal && localSession) {
+            console.log(chalk_1.default.dim(`Attaching to local genbox ${chalk_1.default.bold(localSession.name)}...`));
+            const manager = (0, local_session_manager_1.getLocalSessionManager)();
+            await manager.attachToSession(localSession);
+            return;
+        }
         if (!target.ipAddress) {
             console.error(chalk_1.default.yellow(`Genbox '${target.name}' is still provisioning (no IP). Please wait.`));
             return;

package/dist/commands/create.js

@@ -45,6 +45,7 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const config_loader_1 = require("../config-loader");
+const local_session_manager_1 = require("../lib/local-session-manager");
 const profile_resolver_1 = require("../profile-resolver");
 const api_1 = require("../api");
 const ssh_config_1 = require("../ssh-config");
@@ -326,9 +327,72 @@ async function promptForProfile(profiles) {
     }
     return selected;
 }
+/**
+ * Create a local genbox (Docker container or VM)
+ * This creates the infrastructure without starting a session
+ */
+async function createLocalGenbox(nameArg, options) {
+    const manager = (0, local_session_manager_1.getLocalSessionManager)();
+    const provider = options.gemini ? 'gemini' : 'claude';
+    const isolation = options.vm ? 'multipass' : options.native ? 'native' : 'docker';
+    console.log('');
+    console.log(chalk_1.default.blue('=== Creating Local Genbox ==='));
+    console.log('');
+    console.log(`  ${chalk_1.default.bold('Type:')}      ${isolation}`);
+    console.log(`  ${chalk_1.default.bold('Provider:')}  ${provider}`);
+    console.log(`  ${chalk_1.default.bold('Directory:')} ${process.cwd()}`);
+    console.log('');
+    const spinner = (0, ora_1.default)(`Creating ${isolation} environment...`).start();
+    try {
+        const session = await manager.createSession({
+            provider,
+            isolation,
+            workdir: process.cwd(),
+            name: nameArg, // Use provided name if any
+        });
+        spinner.succeed(chalk_1.default.green('Local genbox created!'));
+        console.log('');
+        console.log(chalk_1.default.dim('───────────────────────────────────────────────'));
+        console.log(`  ${chalk_1.default.bold('Name:')}       ${session.name}`);
+        console.log(`  ${chalk_1.default.bold('ID:')}         ${session.id}`);
+        console.log(`  ${chalk_1.default.bold('Provider:')}   ${session.provider}`);
+        console.log(`  ${chalk_1.default.bold('Isolation:')}  ${session.isolation}`);
+        console.log(`  ${chalk_1.default.bold('Status:')}     ${chalk_1.default.green(session.status)}`);
+        if (session.containerId) {
+            console.log(`  ${chalk_1.default.bold('Container:')}  ${session.containerId.slice(0, 12)}`);
+        }
+        if (session.vmName) {
+            console.log(`  ${chalk_1.default.bold('VM:')}         ${session.vmName}`);
+        }
+        console.log(chalk_1.default.dim('───────────────────────────────────────────────'));
+        console.log('');
+        console.log(chalk_1.default.bold('Next steps:'));
+        console.log(`  Attach:   ${chalk_1.default.cyan(`gb session ${session.name}`)}`);
+        console.log(`  List:     ${chalk_1.default.cyan('gb session list')}`);
+        console.log(`  Stop:     ${chalk_1.default.cyan(`gb session stop ${session.name}`)}`);
+        console.log(`  Destroy:  ${chalk_1.default.cyan(`gb session kill ${session.name}`)}`);
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Failed to create local genbox: ${error.message}`));
+        if (error.message.includes('Docker')) {
+            console.log('');
+            console.log(chalk_1.default.yellow('Tip: Make sure Docker Desktop is running.'));
+        }
+        if (error.message.includes('multipass')) {
+            console.log('');
+            console.log(chalk_1.default.yellow('Tip: Install Multipass from https://multipass.run'));
+        }
+    }
+}
 exports.createCommand = new commander_1.Command('create')
     .description('Create a new Genbox environment')
     .argument('[name]', 'Name of the Genbox (optional - will prompt if not provided)')
+    .option('-l, --local', 'Create local genbox (Docker container or VM)')
+    .option('--vm', 'Use Multipass VM for local genbox')
+    .option('--native', 'Use native mode (no isolation) for local genbox')
+    .option('--claude', 'Use Claude provider (default)')
+    .option('--gemini', 'Use Gemini provider')
     .option('-p, --profile <profile>', 'Use a predefined profile')
     .option('-a, --apps <apps>', 'Comma-separated list of apps to include')
     .option('--add-apps <apps>', 'Add apps to the profile')
@@ -347,6 +411,11 @@ exports.createCommand = new commander_1.Command('create')
     .option('--inject-claude-auth', 'Inject local Claude Code credentials for remote execution')
     .action(async (nameArg, options) => {
     try {
+        // Handle local genbox creation
+        if (options.local) {
+            await createLocalGenbox(nameArg, options);
+            return;
+        }
         // Show config warnings (if any)
         (0, config_warnings_1.showConfigWarnings)();
         // Handle restore mode

package/dist/commands/destroy.js

@@ -46,6 +46,7 @@ const ora_1 = __importDefault(require("ora"));
 const api_1 = require("../api");
 const genbox_selector_1 = require("../genbox-selector");
 const ssh_config_1 = require("../ssh-config");
+const local_session_manager_1 = require("../lib/local-session-manager");
 /**
  * Format genbox for display in selection list
  */
@@ -316,6 +317,32 @@ async function handleUncommittedChanges(genbox, options) {
     }
     return { proceed: true, saveWorkResult: result };
 }
+/**
+ * Destroy a local genbox
+ */
+async function destroyLocalGenbox(session, options) {
+    // Confirm
+    let confirmed = options.yes;
+    if (!confirmed) {
+        confirmed = await (0, confirm_1.default)({
+            message: `Are you sure you want to destroy local genbox '${session.name}' (${session.isolation})?`,
+            default: false,
+        });
+    }
+    if (!confirmed) {
+        console.log('Operation cancelled.');
+        return;
+    }
+    const spinner = (0, ora_1.default)(`Destroying local genbox ${session.name}...`).start();
+    try {
+        const manager = (0, local_session_manager_1.getLocalSessionManager)();
+        await manager.destroySession(session.id);
+        spinner.succeed(chalk_1.default.green(`Local genbox '${session.name}' destroyed successfully.`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Failed to destroy local genbox: ${error.message}`));
+    }
+}
 exports.destroyCommand = new commander_1.Command('destroy')
     .alias('delete')
     .description('Destroy one or more Genboxes')
@@ -332,7 +359,7 @@ exports.destroyCommand = new commander_1.Command('destroy')
             return;
         }
         // Single genbox deletion flow
-        const { genbox: target, cancelled } = await (0, genbox_selector_1.selectGenbox)(name, {
+        const { genbox: target, cancelled, isLocal, localSession } = await (0, genbox_selector_1.selectGenbox)(name, {
             all: options.all, // If --all with name, search in all genboxes
             selectMessage: 'Select a genbox to destroy:',
         });
@@ -343,6 +370,11 @@ exports.destroyCommand = new commander_1.Command('destroy')
         if (!target) {
             return;
         }
+        // Handle local genbox destruction
+        if (isLocal && localSession) {
+            await destroyLocalGenbox(localSession, options);
+            return;
+        }
         // Check for uncommitted changes if genbox is running
         if (target.status === 'running') {
             const { proceed } = await handleUncommittedChanges(target, options);

package/dist/commands/list.js

@@ -8,6 +8,7 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const api_1 = require("../api");
 const genbox_selector_1 = require("../genbox-selector");
+const local_session_manager_1 = require("../lib/local-session-manager");
 exports.listCommand = new commander_1.Command('list')
     .alias('ls')
     .description('List genboxes (scoped to current project by default)')
@@ -51,7 +52,7 @@ exports.listCommand = new commander_1.Command('list')
         console.log(chalk_1.default.dim('────────────────────────────────────────────────────'));
         if (genboxes.length === 0) {
             if (projectName && !options.all) {
-                console.log(chalk_1.default.yellow(`No genboxes found for project '${projectName}'.`));
+                console.log(chalk_1.default.yellow(`No cloud genboxes found for project '${projectName}'.`));
                 console.log('');
                 console.log(chalk_1.default.dim('  Create one with:'));
                 console.log(chalk_1.default.cyan('  $ genbox create <name>'));
@@ -60,11 +61,13 @@ exports.listCommand = new commander_1.Command('list')
                 console.log(chalk_1.default.cyan('  $ genbox list --all'));
             }
             else {
-                console.log(chalk_1.default.yellow('No genboxes found.'));
+                console.log(chalk_1.default.yellow('No cloud genboxes found.'));
                 console.log('');
                 console.log(chalk_1.default.dim('  Create one with:'));
                 console.log(chalk_1.default.cyan('  $ genbox create <name>'));
             }
+            // Still show local genboxes even if no cloud ones
+            await showLocalGenboxes(options);
             return;
         }
         // Sort by createdAt (newest first)
@@ -218,6 +221,8 @@ exports.listCommand = new commander_1.Command('list')
         if (projectName && !options.all) {
             console.log(chalk_1.default.dim(`  Showing ${genboxes.length} genbox(es) for this project. Use ${chalk_1.default.cyan('--all')} to see all.`));
         }
+        // Show local genboxes
+        await showLocalGenboxes(options);
     }
     catch (error) {
         if (error instanceof api_1.AuthenticationError) {
@@ -227,3 +232,49 @@ exports.listCommand = new commander_1.Command('list')
         console.error(chalk_1.default.red(`Error: ${error.message}`));
     }
 });
+/**
+ * Show local genboxes section
+ */
+async function showLocalGenboxes(options) {
+    try {
+        const manager = (0, local_session_manager_1.getLocalSessionManager)();
+        const localSessions = await manager.listSessions();
+        if (localSessions.length === 0) {
+            return;
+        }
+        console.log('');
+        console.log(chalk_1.default.bold('Local Genboxes:'));
+        console.log(chalk_1.default.dim('────────────────────────────────────────────────────'));
+        const nameWidth = Math.max(12, ...localSessions.map(s => s.name.length));
+        for (const session of localSessions) {
+            const statusColor = session.status === 'running' || session.status === 'active' ? chalk_1.default.green :
+                session.status === 'stopped' ? chalk_1.default.red : chalk_1.default.yellow;
+            const namePart = chalk_1.default.cyan(session.name.padEnd(nameWidth));
+            const statusPart = statusColor(session.status.padEnd(12));
+            const isolationPart = chalk_1.default.dim(session.isolation.padEnd(10));
+            const providerPart = chalk_1.default.dim(`(${session.provider})`);
+            // Show age
+            let agePart = '';
+            if (session.createdAt) {
+                const age = Date.now() - new Date(session.createdAt).getTime();
+                const mins = Math.floor(age / 60000);
+                const hours = Math.floor(mins / 60);
+                if (hours > 0) {
+                    agePart = chalk_1.default.dim(` ${hours}h ago`);
+                }
+                else if (mins > 0) {
+                    agePart = chalk_1.default.dim(` ${mins}m ago`);
+                }
+                else {
+                    agePart = chalk_1.default.dim(' just now');
+                }
+            }
+            console.log(`${namePart} ${statusPart} ${isolationPart} ${providerPart}${agePart}`);
+        }
+        console.log(chalk_1.default.dim('────────────────────────────────────────────────────'));
+        console.log(chalk_1.default.dim(`  ${localSessions.length} local genbox(es). Use ${chalk_1.default.cyan('gb session')} to attach.`));
+    }
+    catch {
+        // Silently ignore local session errors
+    }
+}

package/dist/commands/start.js

@@ -7,9 +7,40 @@ exports.startCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
+const child_process_1 = require("child_process");
 const api_1 = require("../api");
 const genbox_selector_1 = require("../genbox-selector");
 const ssh_config_1 = require("../ssh-config");
+const local_session_manager_1 = require("../lib/local-session-manager");
+/**
+ * Start a stopped local genbox (Docker container or VM)
+ */
+async function startLocalGenbox(session) {
+    const spinner = (0, ora_1.default)(`Starting ${session.name}...`).start();
+    try {
+        if (session.isolation === 'docker' && session.containerId) {
+            (0, child_process_1.execSync)(`docker start ${session.containerId}`, { stdio: 'pipe' });
+        }
+        else if (session.isolation === 'multipass') {
+            (0, child_process_1.execSync)(`multipass start ${session.name}`, { stdio: 'pipe' });
+        }
+        else if (session.isolation === 'native') {
+            spinner.info(chalk_1.default.yellow('Native mode sessions do not need to be started'));
+            return;
+        }
+        // Update session status
+        const manager = (0, local_session_manager_1.getLocalSessionManager)();
+        session.status = 'running';
+        await manager.updateSession(session);
+        spinner.succeed(chalk_1.default.green(`Local genbox '${session.name}' started`));
+        console.log('');
+        console.log(chalk_1.default.dim(`  Attach with: ${chalk_1.default.cyan(`gb session ${session.name}`)}`));
+        console.log(chalk_1.default.dim(`  Or connect:  ${chalk_1.default.cyan(`gb connect ${session.name}`)}`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Failed to start local genbox: ${error.message}`));
+    }
+}
 exports.startCommand = new commander_1.Command('start')
     .alias('resume')
     .description('Start/resume a stopped Genbox')
@@ -18,7 +49,7 @@ exports.startCommand = new commander_1.Command('start')
     .addHelpText('after', '\nAliases: gb resume')
     .action(async (name, options) => {
     try {
-        const { genbox: target, cancelled } = await (0, genbox_selector_1.selectGenbox)(name, {
+        const { genbox: target, cancelled, isLocal, localSession } = await (0, genbox_selector_1.selectGenbox)(name, {
             selectMessage: 'Select a genbox to start:',
             statusFilter: 'stopped',
         });
@@ -29,6 +60,11 @@ exports.startCommand = new commander_1.Command('start')
         if (!target) {
             return;
         }
+        // Handle local genbox start
+        if (isLocal && localSession) {
+            await startLocalGenbox(localSession);
+            return;
+        }
         if (target.status !== 'stopped') {
             if (target.status === 'running') {
                 console.log(chalk_1.default.yellow(`Genbox '${target.name}' is already running`));

package/dist/commands/status.js

@@ -239,6 +239,76 @@ function tailCloudInitLogs(ip, keyPath) {
 function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+/**
+ * Display status for a local genbox
+ */
+async function displayLocalGenboxStatus(session) {
+    console.log(chalk_1.default.blue(`[INFO] Local Genbox: ${chalk_1.default.cyan(session.name)}`));
+    console.log('');
+    const statusColor = session.status === 'running' || session.status === 'active' ? chalk_1.default.green :
+        session.status === 'stopped' ? chalk_1.default.red : chalk_1.default.yellow;
+    console.log(chalk_1.default.blue('[INFO] === Details ==='));
+    console.log(`  Status:    ${statusColor(session.status)}`);
+    console.log(`  Provider:  ${session.provider}`);
+    console.log(`  Isolation: ${session.isolation}`);
+    console.log(`  Workdir:   ${chalk_1.default.dim(session.workdir || 'N/A')}`);
+    if (session.createdAt) {
+        const age = Date.now() - new Date(session.createdAt).getTime();
+        const mins = Math.floor(age / 60000);
+        const hours = Math.floor(mins / 60);
+        const ageStr = hours > 0 ? `${hours}h ${mins % 60}m ago` : mins > 0 ? `${mins}m ago` : 'just now';
+        console.log(`  Created:   ${chalk_1.default.dim(ageStr)}`);
+    }
+    if (session.lastActivityAt) {
+        const lastActivity = Date.now() - new Date(session.lastActivityAt).getTime();
+        const mins = Math.floor(lastActivity / 60000);
+        const hours = Math.floor(mins / 60);
+        const activityStr = hours > 0 ? `${hours}h ${mins % 60}m ago` : mins > 0 ? `${mins}m ago` : 'just now';
+        console.log(`  Activity:  ${chalk_1.default.dim(activityStr)}`);
+    }
+    console.log('');
+    // Get container/VM status if Docker
+    if (session.isolation === 'docker' && session.containerId) {
+        try {
+            const containerStatus = (0, child_process_1.execSync)(`docker inspect --format='{{.State.Status}}' ${session.containerId} 2>/dev/null`, { encoding: 'utf8' }).trim();
+            console.log(chalk_1.default.blue('[INFO] === Docker Container ==='));
+            console.log(`  Container ID: ${chalk_1.default.dim(session.containerId.substring(0, 12))}`);
+            console.log(`  Status:       ${containerStatus === 'running' ? chalk_1.default.green(containerStatus) : chalk_1.default.yellow(containerStatus)}`);
+            // Get resource usage
+            try {
+                const stats = (0, child_process_1.execSync)(`docker stats --no-stream --format='{{.CPUPerc}}\t{{.MemUsage}}' ${session.containerId} 2>/dev/null`, { encoding: 'utf8' }).trim();
+                if (stats) {
+                    const [cpu, mem] = stats.split('\t');
+                    console.log(`  CPU:          ${cpu}`);
+                    console.log(`  Memory:       ${mem}`);
+                }
+            }
+            catch {
+                // Ignore stats errors
+            }
+            console.log('');
+        }
+        catch {
+            console.log(chalk_1.default.yellow('[WARN] Container not found or not running'));
+            console.log('');
+        }
+    }
+    else if (session.isolation === 'multipass') {
+        console.log(chalk_1.default.blue('[INFO] === Multipass VM ==='));
+        try {
+            const vmInfo = (0, child_process_1.execSync)(`multipass info ${session.name} --format=csv 2>/dev/null`, { encoding: 'utf8' }).trim();
+            console.log(chalk_1.default.dim(vmInfo));
+        }
+        catch {
+            console.log(chalk_1.default.yellow('  VM info not available'));
+        }
+        console.log('');
+    }
+    // Show next steps
+    console.log(chalk_1.default.dim('Commands:'));
+    console.log(chalk_1.default.dim(`  Attach:   ${chalk_1.default.cyan(`gb session ${session.name}`)}`));
+    console.log(chalk_1.default.dim(`  Destroy:  ${chalk_1.default.cyan(`gb destroy ${session.name}`)}`));
+}
 exports.statusCommand = new commander_1.Command('status')
     .description('Check cloud-init progress and service status of a Genbox')
     .argument('[name]', 'Name of the Genbox (optional - will prompt if not provided)')
@@ -248,7 +318,7 @@ exports.statusCommand = new commander_1.Command('status')
     .action(async (name, options) => {
     try {
         // 1. Select Genbox (interactive if no name provided)
-        const { genbox: target, cancelled } = await (0, genbox_selector_1.selectGenbox)(name, {
+        const { genbox: target, cancelled, isLocal, localSession } = await (0, genbox_selector_1.selectGenbox)(name, {
             all: options.all,
             selectMessage: 'Select a genbox to check status:',
         });
@@ -259,6 +329,11 @@ exports.statusCommand = new commander_1.Command('status')
         if (!target) {
             return;
         }
+        // Handle local genbox status
+        if (isLocal && localSession) {
+            await displayLocalGenboxStatus(localSession);
+            return;
+        }
         if (!target.ipAddress) {
             console.error(chalk_1.default.yellow(`Genbox '${target.name}' is still provisioning (no IP yet). Please wait.`));
             return;

package/dist/commands/stop.js

@@ -8,9 +8,77 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const confirm_1 = __importDefault(require("@inquirer/confirm"));
 const ora_1 = __importDefault(require("ora"));
+const child_process_1 = require("child_process");
 const api_1 = require("../api");
 const genbox_selector_1 = require("../genbox-selector");
 const ssh_config_1 = require("../ssh-config");
+const local_session_manager_1 = require("../lib/local-session-manager");
+/**
+ * Stop a local genbox (Docker container or VM)
+ */
+async function stopLocalGenbox(session, options) {
+    const log = (msg) => { if (!options.quiet)
+        console.log(msg); };
+    // Confirm
+    let confirmed = options.yes;
+    if (!confirmed) {
+        log('');
+        log(chalk_1.default.blue('Stop will:'));
+        if (session.isolation === 'docker') {
+            log(chalk_1.default.dim('  1. Stop the Docker container'));
+            log(chalk_1.default.dim('  2. Container state is preserved (can restart)'));
+        }
+        else if (session.isolation === 'multipass') {
+            log(chalk_1.default.dim('  1. Stop the Multipass VM'));
+            log(chalk_1.default.dim('  2. VM state is preserved (can restart)'));
+        }
+        log('');
+        confirmed = await (0, confirm_1.default)({
+            message: `Stop local genbox '${session.name}'?`,
+            default: true,
+        });
+    }
+    if (!confirmed) {
+        log(chalk_1.default.dim('Operation cancelled.'));
+        return;
+    }
+    const spinner = options.quiet ? null : (0, ora_1.default)(`Stopping ${session.name}...`).start();
+    try {
+        if (session.isolation === 'docker' && session.containerId) {
+            (0, child_process_1.execSync)(`docker stop ${session.containerId}`, { stdio: 'pipe' });
+        }
+        else if (session.isolation === 'multipass') {
+            (0, child_process_1.execSync)(`multipass stop ${session.name}`, { stdio: 'pipe' });
+        }
+        else if (session.isolation === 'native') {
+            // Native mode - just update status (tmux session stays)
+            log(chalk_1.default.yellow('Native mode sessions cannot be stopped (use gb destroy instead)'));
+            if (spinner)
+                spinner.stop();
+            return;
+        }
+        // Update session status
+        const manager = (0, local_session_manager_1.getLocalSessionManager)();
+        session.status = 'stopped';
+        await manager.updateSession(session);
+        if (spinner) {
+            spinner.succeed(chalk_1.default.green(`Local genbox '${session.name}' stopped`));
+        }
+        else {
+            console.log(session.name);
+        }
+        log('');
+        log(chalk_1.default.dim(`  To resume: ${chalk_1.default.cyan(`gb start ${session.name}`)}`));
+    }
+    catch (error) {
+        if (spinner) {
+            spinner.fail(chalk_1.default.red(`Failed to stop local genbox: ${error.message}`));
+        }
+        else {
+            console.error(chalk_1.default.red(`Failed to stop local genbox: ${error.message}`));
+        }
+    }
+}
 exports.stopCommand = new commander_1.Command('stop')
     .description('Stop a running Genbox (saves state for quick resume)')
     .argument('[name]', 'Name of the Genbox to stop')
@@ -20,7 +88,7 @@ exports.stopCommand = new commander_1.Command('stop')
     const log = (msg) => { if (!options.quiet)
         console.log(msg); };
     try {
-        const { genbox: target, cancelled } = await (0, genbox_selector_1.selectGenbox)(name, {
+        const { genbox: target, cancelled, isLocal, localSession } = await (0, genbox_selector_1.selectGenbox)(name, {
             selectMessage: 'Select a genbox to stop:',
             statusFilter: 'running',
         });
@@ -31,6 +99,11 @@ exports.stopCommand = new commander_1.Command('stop')
         if (!target) {
             return;
         }
+        // Handle local genbox stop
+        if (isLocal && localSession) {
+            await stopLocalGenbox(localSession, options);
+            return;
+        }
         if (target.status !== 'running') {
             console.error(chalk_1.default.red(`Genbox '${target.name}' is not running (status: ${target.status})`));
             return;

package/dist/genbox-selector.js

@@ -12,6 +12,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const select_1 = __importDefault(require("@inquirer/select"));
 const api_1 = require("./api");
 const config_1 = require("./config");
+const local_session_manager_1 = require("./lib/local-session-manager");
 /**
  * Get project name from genbox.yaml if available
  */
@@ -52,47 +53,121 @@ async function getGenboxes(options = {}) {
 function isInProjectContext() {
     return getProjectContext() !== null;
 }
+/**
+ * Convert a LocalSession to a Genbox-compatible object
+ */
+function localSessionToGenbox(session) {
+    // Handle createdAt - it may be a string (from JSON) or a Date object
+    let createdAtStr;
+    if (session.createdAt) {
+        if (typeof session.createdAt === 'string') {
+            createdAtStr = session.createdAt;
+        }
+        else if (session.createdAt instanceof Date) {
+            createdAtStr = session.createdAt.toISOString();
+        }
+    }
+    return {
+        _id: session.id,
+        name: session.name,
+        status: session.status === 'active' ? 'running' : session.status,
+        ipAddress: undefined, // Local genboxes don't have IP
+        size: 'local',
+        project: session.workdir?.split('/').pop() || undefined,
+        createdAt: createdAtStr,
+        _isLocal: true,
+        _localSession: session,
+    };
+}
+/**
+ * Get local genboxes as Genbox objects
+ */
+async function getLocalGenboxes() {
+    try {
+        const manager = (0, local_session_manager_1.getLocalSessionManager)();
+        const sessions = await manager.listSessions();
+        return sessions.map(localSessionToGenbox);
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * Interactive genbox selector with project context awareness
  * - If one genbox: auto-selects it
  * - If multiple: shows interactive select
  * - If none: shows appropriate message
+ * - Now includes local genboxes by default
  */
 async function selectGenbox(name, options = {}) {
     const projectName = getProjectContext();
-    let genboxes = await getGenboxes({
-        all: options.all,
-        includeTerminated: options.includeTerminated,
-    });
+    const includeLocal = options.includeLocal !== false && !options.cloudOnly;
+    const localOnly = options.localOnly === true;
+    // Fetch cloud genboxes (unless localOnly)
+    let genboxes = [];
+    if (!localOnly) {
+        try {
+            genboxes = await getGenboxes({
+                all: options.all,
+                includeTerminated: options.includeTerminated,
+            });
+        }
+        catch (error) {
+            // If we're including local, don't fail on cloud fetch errors
+            if (!includeLocal) {
+                throw error;
+            }
+            // Silently continue with just local genboxes
+        }
+    }
+    // Fetch local genboxes
+    let localGenboxes = [];
+    if (includeLocal || localOnly) {
+        localGenboxes = await getLocalGenboxes();
+    }
+    // Combine cloud and local genboxes
+    const allGenboxes = [...genboxes, ...localGenboxes];
     // Filter by status if specified
+    let filteredGenboxes = allGenboxes;
     if (options.statusFilter) {
-        genboxes = genboxes.filter(g => g.status === options.statusFilter);
+        filteredGenboxes = filteredGenboxes.filter(g => g.status === options.statusFilter);
     }
     // If name is provided, find it directly
     if (name) {
-        const genbox = genboxes.find(g => g.name === name);
-        if (!genbox) {
-            // Check if it exists in all genboxes (might be in different project)
-            if (!options.all && projectName) {
-                const allGenboxes = await getGenboxes({ all: true, includeTerminated: options.includeTerminated });
-                const existsElsewhere = allGenboxes.find(g => g.name === name);
-                if (existsElsewhere) {
-                    console.error(chalk_1.default.yellow(`Genbox '${name}' exists but belongs to a different project.`));
-                    console.error(chalk_1.default.dim(`  Use ${chalk_1.default.cyan('--all')} flag to access it.`));
-                }
-                else {
-                    console.error(chalk_1.default.red(`Genbox '${name}' not found.`));
-                }
+        // First check local genboxes (higher priority for matching names)
+        const localMatch = localGenboxes.find(g => g.name === name);
+        if (localMatch) {
+            return {
+                genbox: localMatch,
+                genboxes: genboxes,
+                isLocal: true,
+                localSession: localMatch._localSession,
+            };
+        }
+        // Then check cloud genboxes
+        const cloudMatch = genboxes.find(g => g.name === name);
+        if (cloudMatch) {
+            return { genbox: cloudMatch, genboxes };
+        }
+        // Check if it exists in all genboxes (might be in different project)
+        if (!options.all && projectName) {
+            const allCloudGenboxes = await getGenboxes({ all: true, includeTerminated: options.includeTerminated });
+            const existsElsewhere = allCloudGenboxes.find(g => g.name === name);
+            if (existsElsewhere) {
+                console.error(chalk_1.default.yellow(`Genbox '${name}' exists but belongs to a different project.`));
+                console.error(chalk_1.default.dim(`  Use ${chalk_1.default.cyan('--all')} flag to access it.`));
             }
             else {
                 console.error(chalk_1.default.red(`Genbox '${name}' not found.`));
             }
-            return { genbox: null, genboxes };
         }
-        return { genbox, genboxes };
+        else {
+            console.error(chalk_1.default.red(`Genbox '${name}' not found.`));
+        }
+        return { genbox: null, genboxes };
     }
     // No name provided - interactive selection
-    if (genboxes.length === 0) {
+    if (filteredGenboxes.length === 0) {
         const emptyMsg = options.emptyMessage || (projectName
             ? `No genboxes found for project '${projectName}'.`
             : 'No genboxes found.');
@@ -103,26 +178,70 @@ async function selectGenbox(name, options = {}) {
         return { genbox: null, genboxes };
     }
     // Only one genbox - auto-select
-    if (genboxes.length === 1) {
-        const genbox = genboxes[0];
-        console.log(chalk_1.default.dim(`Auto-selected: ${chalk_1.default.cyan(genbox.name)}`));
-        return { genbox, genboxes };
+    if (filteredGenboxes.length === 1) {
+        const genbox = filteredGenboxes[0];
+        const isLocal = !!genbox._isLocal;
+        const localLabel = isLocal ? chalk_1.default.magenta(' [local]') : '';
+        console.log(chalk_1.default.dim(`Auto-selected: ${chalk_1.default.cyan(genbox.name)}${localLabel}`));
+        return {
+            genbox,
+            genboxes,
+            isLocal,
+            localSession: genbox._localSession,
+        };
     }
     // Multiple genboxes - interactive select
     try {
-        const choices = genboxes.map(g => {
+        // Build choices with cloud genboxes first, then local
+        const cloudChoices = genboxes
+            .filter(g => options.statusFilter ? g.status === options.statusFilter : true)
+            .map(g => {
             const statusColor = g.status === 'running' ? chalk_1.default.green :
                 g.status === 'terminated' ? chalk_1.default.red : chalk_1.default.yellow;
             return {
                 name: `${g.name} ${statusColor(`(${g.status})`)} ${chalk_1.default.dim(g.ipAddress || 'No IP')}`,
-                value: g,
+                value: { genbox: g, isLocal: false },
             };
         });
+        const localChoices = localGenboxes
+            .filter(g => options.statusFilter ? g.status === options.statusFilter : true)
+            .map(g => {
+            const statusColor = g.status === 'running' ? chalk_1.default.green :
+                g.status === 'stopped' ? chalk_1.default.red : chalk_1.default.yellow;
+            const isolationInfo = g._localSession.isolation || 'docker';
+            return {
+                name: `${g.name} ${statusColor(`(${g.status})`)} ${chalk_1.default.magenta('[local]')} ${chalk_1.default.dim(`(${isolationInfo})`)}`,
+                value: { genbox: g, isLocal: true, localSession: g._localSession },
+            };
+        });
+        const choices = [];
+        // Add cloud section if there are cloud genboxes
+        if (cloudChoices.length > 0) {
+            choices.push(...cloudChoices);
+        }
+        // Add local section if there are local genboxes
+        if (localChoices.length > 0) {
+            if (cloudChoices.length > 0) {
+                // Add separator before local section
+                choices.push({
+                    name: chalk_1.default.dim('── Local ──────────────────────────'),
+                    value: null, // Separator (will be filtered)
+                });
+            }
+            choices.push(...localChoices);
+        }
+        // Filter out separators for selection
+        const selectableChoices = choices.filter(c => c.value !== null);
         const selected = await (0, select_1.default)({
             message: options.selectMessage || 'Select a genbox:',
-            choices,
+            choices: selectableChoices,
         });
-        return { genbox: selected, genboxes };
+        return {
+            genbox: selected.genbox,
+            genboxes,
+            isLocal: selected.isLocal,
+            localSession: selected.localSession,
+        };
     }
     catch (error) {
         // Handle Ctrl+C

package/dist/lib/local-session-manager.js

@@ -323,7 +323,7 @@ class LocalSessionManager {
         }
         const session = {
             id: this.generateId(),
-            name: this.generateName(options.provider),
+            name: options.name || this.generateName(options.provider),
             location: 'local',
             isolation: options.isolation,
             provider: options.provider,
@@ -480,10 +480,10 @@ CMD ["tail", "-f", "/dev/null"]
     getCredentialMounts() {
         const home = os.homedir();
         const mounts = [];
-        // Claude credentials
+        // Claude credentials (needs write access for debug files)
         const claudeDir = path.join(home, '.claude');
         if (fs.existsSync(claudeDir)) {
-            mounts.push(`-v "${claudeDir}:/home/dev/.claude:ro"`);
+            mounts.push(`-v "${claudeDir}:/home/dev/.claude"`);
         }
         // Google credentials (for Gemini)
         const gcloudDir = path.join(home, '.config', 'gcloud');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genbox",
-  "version": "1.0.176",
+  "version": "1.0.177",
   "description": "Genbox CLI - AI-Powered Development Environments",
   "main": "dist/index.js",
   "bin": {