teleportation-cli 1.0.0 → 1.0.2

package/teleportation-cli.cjs

@@ -207,6 +207,7 @@ function commandHelp() {
 
   console.log(c.yellow('Authentication:'));
   console.log('  ' + c.green('login') + '            Authenticate with API key or token');
+  console.log('  ' + c.green('github connect') + '   Save GitHub token for repo access (used by remote sessions)');
   console.log('  ' + c.green('logout') + '           Clear saved credentials\n');
 
   console.log(c.yellow('Setup Commands:'));
@@ -248,6 +249,14 @@ function commandHelp() {
   console.log('  ' + c.green('config edit') + '      Open config in editor');
   console.log('  ' + c.green('env') + '              Show environment variables\n');
   
+  console.log(c.yellow('Remote Sessions:'));
+  console.log('  ' + c.green('remote start') + '       Start a remote AI agent session');
+  console.log('  ' + c.green('remote list') + '        List all remote sessions');
+  console.log('  ' + c.green('remote status') + '      Show remote session details');
+  console.log('  ' + c.green('remote logs') + '        View logs from remote session');
+  console.log('  ' + c.green('remote pull') + '        Pull results from remote session');
+  console.log('  ' + c.green('remote help') + '        Show remote commands help\n');
+
   console.log(c.yellow('Session Isolation:'));
   console.log('  ' + c.green('worktree create') + '  Create isolated worktree for a session');
   console.log('  ' + c.green('worktree list') + '    List all session worktrees');
@@ -385,7 +394,7 @@ async function commandSetup() {
     }
 
     // Step 1: Authentication
-    console.log('\n' + c.purple('Step 1 of 4: Authentication\n'));
+    console.log('\n' + c.purple('Step 1 of 5: Authentication\n'));
     console.log('  You\'ll need to sign in to get an API key.\n');
 
     // Try to open browser
@@ -437,7 +446,7 @@ async function commandSetup() {
     console.log(c.green('  ✅ API key validated successfully!'));
 
     // Step 2: Configuration
-    console.log('\n' + c.purple('Step 2 of 4: Configuration\n'));
+    console.log('\n' + c.purple('Step 2 of 5: Configuration\n'));
     console.log(`  Relay URL: ${c.cyan(relayUrl)}`);
 
     // Test relay connectivity
@@ -484,7 +493,7 @@ async function commandSetup() {
     }
 
     // Step 3: Install Hooks
-    console.log('\n' + c.purple('Step 3 of 4: Installing Hooks\n'));
+    console.log('\n' + c.purple('Step 3 of 5: Installing Hooks\n'));
     console.log('  Installing Claude Code hooks to ~/.claude/hooks/');
 
     try {
@@ -510,12 +519,37 @@ async function commandSetup() {
       return;
     }
 
-    // Step 4: Verification
-    console.log('\n' + c.purple('Step 4 of 4: Verification\n'));
+    // Step 4: Start Daemon
+    console.log('\n' + c.purple('Step 4 of 5: Starting Daemon\n'));
+    console.log('  Starting the teleportation daemon for remote commands...');
+
+    try {
+      const lifecyclePath = path.join(TELEPORTATION_DIR, 'lib', 'daemon', 'lifecycle.js');
+      const { access } = await import('fs/promises');
+      try {
+        await access(lifecyclePath);
+      } catch {
+        throw new Error('Daemon module not found. Please reinstall: npm install -g teleportation-cli');
+      }
+      const { startDaemon } = await import('file://' + lifecyclePath);
+      const result = await startDaemon({ detached: true, silent: true });
+      console.log(c.green(`  ✅ Daemon started (PID: ${result.pid})`));
+    } catch (e) {
+      if (e.message && e.message.includes('already running')) {
+        console.log(c.green('  ✅ Daemon already running'));
+      } else {
+        console.log(c.yellow(`  ⚠️  Could not start daemon: ${e.message}`));
+        console.log(c.cyan('  You can start it manually with: teleportation daemon start'));
+      }
+    }
+
+    // Step 5: Verification
+    console.log('\n' + c.purple('Step 5 of 5: Verification\n'));
     console.log(c.green('  ✅ Credentials saved'));
     console.log(c.green('  ✅ Configuration saved'));
     console.log(c.green('  ✅ Hooks installed'));
     console.log(c.green('  ✅ Relay connectivity confirmed'));
+    console.log(c.green('  ✅ Daemon running'));
 
     // Success!
     console.log('\n' + c.cyan('╭─────────────────────────────────────────────────────╮'));
@@ -1545,7 +1579,8 @@ async function commandLogin(args) {
 
   // Check for existing credentials
   const existing = await manager.load();
-  if (existing) {
+  const hasRelayCreds = !!(existing && (existing.relayApiKey || existing.apiKey || existing.accessToken));
+  if (hasRelayCreds) {
     console.log(c.yellow('⚠️  You are already logged in.'));
     console.log(c.cyan('   Run "teleportation logout" to clear existing credentials.\n'));
     
@@ -1608,7 +1643,9 @@ async function performLogin(manager, flags, positional) {
       }
       
       // Save credentials
+      const existingCredsForMerge = await manager.load().catch(() => null);
       const credentials = {
+        ...(existingCredsForMerge && typeof existingCredsForMerge === 'object' ? existingCredsForMerge : {}),
         apiKey: apiKey,
         relayApiUrl: relayApiUrl,
         authenticatedAt: Date.now(),
@@ -1629,6 +1666,29 @@ async function performLogin(manager, flags, positional) {
 
       console.log(c.green('✅ Successfully authenticated with API key!\n'));
       console.log(c.cyan('Credentials saved to ~/.teleportation/credentials\n'));
+
+      // Auto-start daemon
+      console.log(c.cyan('Starting daemon for remote commands...'));
+      try {
+        const lifecyclePath = path.join(TELEPORTATION_DIR, 'lib', 'daemon', 'lifecycle.js');
+        const { access } = await import('fs/promises');
+        try {
+          await access(lifecyclePath);
+        } catch {
+          throw new Error('Daemon module not found. Please reinstall: npm install -g teleportation-cli');
+        }
+        const { startDaemon } = await import('file://' + lifecyclePath);
+        const result = await startDaemon({ detached: true, silent: true });
+        console.log(c.green(`✅ Daemon started (PID: ${result.pid})\n`));
+      } catch (e) {
+        if (e.message && e.message.includes('already running')) {
+          console.log(c.green('✅ Daemon already running\n'));
+        } else {
+          console.log(c.yellow(`⚠️  Could not start daemon: ${e.message}`));
+          console.log(c.cyan('You can start it manually with: teleportation daemon start\n'));
+        }
+      }
+
       console.log(c.yellow('⚠️  Restart Claude Code to apply changes to current session.\n'));
       return;
     } catch (error) {
@@ -1643,7 +1703,9 @@ async function performLogin(manager, flags, positional) {
     
     try {
       // Save credentials with token
+      const existingCredsForMerge = await manager.load().catch(() => null);
       const credentials = {
+        ...(existingCredsForMerge && typeof existingCredsForMerge === 'object' ? existingCredsForMerge : {}),
         accessToken: token,
         relayApiUrl: relayApiUrl,
         authenticatedAt: Date.now(),
@@ -1664,6 +1726,29 @@ async function performLogin(manager, flags, positional) {
 
       console.log(c.green('✅ Successfully authenticated with token!\n'));
       console.log(c.cyan('Credentials saved to ~/.teleportation/credentials\n'));
+
+      // Auto-start daemon
+      console.log(c.cyan('Starting daemon for remote commands...'));
+      try {
+        const lifecyclePath = path.join(TELEPORTATION_DIR, 'lib', 'daemon', 'lifecycle.js');
+        const { access } = await import('fs/promises');
+        try {
+          await access(lifecyclePath);
+        } catch {
+          throw new Error('Daemon module not found. Please reinstall: npm install -g teleportation-cli');
+        }
+        const { startDaemon } = await import('file://' + lifecyclePath);
+        const result = await startDaemon({ detached: true, silent: true });
+        console.log(c.green(`✅ Daemon started (PID: ${result.pid})\n`));
+      } catch (e) {
+        if (e.message && e.message.includes('already running')) {
+          console.log(c.green('✅ Daemon already running\n'));
+        } else {
+          console.log(c.yellow(`⚠️  Could not start daemon: ${e.message}`));
+          console.log(c.cyan('You can start it manually with: teleportation daemon start\n'));
+        }
+      }
+
       console.log(c.yellow('⚠️  Restart Claude Code to apply changes to current session.\n'));
       return;
     } catch (error) {
@@ -1709,7 +1794,9 @@ async function performLogin(manager, flags, positional) {
         }
         
         // Save credentials
+        const existingCredsForMerge = await manager.load().catch(() => null);
         const credentials = {
+          ...(existingCredsForMerge && typeof existingCredsForMerge === 'object' ? existingCredsForMerge : {}),
           apiKey: apiKey,
           relayApiUrl: relayApiUrl,
           authenticatedAt: Date.now(),
@@ -1719,6 +1806,29 @@ async function performLogin(manager, flags, positional) {
         await manager.save(credentials);
         console.log(c.green('✅ Successfully authenticated!\n'));
         console.log(c.cyan('Credentials saved to ~/.teleportation/credentials\n'));
+
+        // Auto-start daemon
+        console.log(c.cyan('Starting daemon for remote commands...'));
+        try {
+          const lifecyclePath = path.join(TELEPORTATION_DIR, 'lib', 'daemon', 'lifecycle.js');
+          const { access } = await import('fs/promises');
+          try {
+            await access(lifecyclePath);
+          } catch {
+            throw new Error('Daemon module not found. Please reinstall: npm install -g teleportation-cli');
+          }
+          const { startDaemon } = await import('file://' + lifecyclePath);
+          const result = await startDaemon({ detached: true, silent: true });
+          console.log(c.green(`✅ Daemon started (PID: ${result.pid})\n`));
+        } catch (e) {
+          if (e.message && e.message.includes('already running')) {
+            console.log(c.green('✅ Daemon already running\n'));
+          } else {
+            console.log(c.yellow(`⚠️  Could not start daemon: ${e.message}`));
+            console.log(c.cyan('You can start it manually with: teleportation daemon start\n'));
+          }
+        }
+
         resolve();
       } catch (error) {
         console.log(c.red(`❌ Error: ${error.message}\n`));
@@ -1880,6 +1990,128 @@ async function commandLogout() {
   });
 }
 
+async function validateGitHubToken(token) {
+  const response = await fetch('https://api.github.com/user', {
+    headers: {
+      'Authorization': `Bearer ${token}`,
+      'User-Agent': 'teleportation-cli'
+    }
+  });
+
+  if (!response.ok) {
+    let message = response.statusText;
+    try {
+      const body = await response.json();
+      message = body?.message || message;
+    } catch {
+      // ignore
+    }
+    throw new Error(`GitHub token validation failed (${response.status}): ${message}`);
+  }
+
+  return response.json();
+}
+
+async function commandGithub(args) {
+  const subCommand = args[0] || 'help';
+  const { flags } = parseFlags(args.slice(1));
+
+  const manager = await loadCredentialManager();
+  if (!manager) {
+    console.log(c.red('❌ Failed to load credential manager'));
+    process.exit(1);
+  }
+
+  if (subCommand === 'connect') {
+    let token = flags.token || flags.t;
+
+    if (!token) {
+      const readline = require('readline').createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      token = await new Promise((resolve) => {
+        readline.question('Enter your GitHub token (fine-grained PAT recommended): ', (answer) => {
+          readline.close();
+          resolve(answer?.trim() || '');
+        });
+      });
+    }
+
+    if (!token) {
+      console.log(c.yellow('Connect cancelled.\n'));
+      return;
+    }
+
+    try {
+      console.log(c.yellow('Validating GitHub token...\n'));
+      const user = await validateGitHubToken(token);
+
+      const existing = await manager.load().catch(() => null);
+      const next = {
+        ...(existing && typeof existing === 'object' ? existing : {}),
+        githubToken: token,
+        githubUser: user?.login || '',
+        githubConnectedAt: Date.now()
+      };
+
+      await manager.save(next);
+      loadedCredentials = next;
+
+      console.log(c.green('✅ GitHub connected!\n'));
+      if (user?.login) {
+        console.log(c.cyan(`GitHub user: ${user.login}`));
+      }
+      console.log(c.cyan('GitHub token saved to ~/.teleportation/credentials\n'));
+      return;
+    } catch (error) {
+      console.log(c.red(`❌ Error: ${error.message}\n`));
+      process.exit(1);
+    }
+  }
+
+  if (subCommand === 'status') {
+    const existing = await manager.load().catch(() => null);
+    const token = existing?.githubToken;
+    console.log(c.yellow('GitHub Credentials:\n'));
+    console.log('  Connected:', token ? c.green('yes') : c.red('no'));
+    if (token) {
+      console.log('  Token:', '***' + token.slice(-4));
+    }
+    if (existing?.githubUser) {
+      console.log('  User:', existing.githubUser);
+    }
+    console.log();
+    return;
+  }
+
+  if (subCommand === 'disconnect') {
+    const existing = await manager.load().catch(() => null);
+    if (!existing || !existing.githubToken) {
+      console.log(c.yellow('⚠️  No GitHub token saved.\n'));
+      return;
+    }
+
+    const next = { ...(existing && typeof existing === 'object' ? existing : {}) };
+    delete next.githubToken;
+    delete next.githubUser;
+    delete next.githubConnectedAt;
+
+    await manager.save(next);
+    loadedCredentials = next;
+
+    console.log(c.green('✅ GitHub disconnected.\n'));
+    return;
+  }
+
+  console.log(c.purple('Teleportation GitHub\n'));
+  console.log(c.yellow('Usage:'));
+  console.log('  teleportation github connect --token <token>');
+  console.log('  teleportation github status');
+  console.log('  teleportation github disconnect\n');
+}
+
 // Worktree/Snapshot/Session command handlers
 async function commandWorktree(args) {
   const cliPath = path.join(TELEPORTATION_DIR, 'lib', 'cli', 'index.js');
@@ -1920,6 +2152,170 @@ async function commandSession(args) {
   await routeCommand(parsed);
 }
 
+/**
+ * Handle remote session commands
+ */
+async function commandRemote(args) {
+  const subCommand = args[0] || 'help';
+
+  // Parse flags
+  const { flags, positional } = parseFlags(args.slice(1));
+
+  try {
+    // Dynamically import remote commands
+    const remoteCommandsPath = path.join(TELEPORTATION_DIR, 'lib', 'cli', 'remote-commands.js');
+    const {
+      commandRemoteStart,
+      commandRemoteList,
+      commandRemoteStatus,
+      commandRemoteLogs,
+      commandRemotePull,
+      commandRemoteStop,
+      commandRemoteResume,
+      commandRemoteDestroy
+    } = await import('file://' + remoteCommandsPath);
+
+    switch (subCommand) {
+      case 'start':
+        // Parse command: teleportation remote start --task "description" --branch "branch-name" [--provider fly|daytona]
+        const task = flags.task;
+        const branch = flags.branch;
+        const provider = flags.provider;
+        const noPr = flags['no-pr'] || false;
+
+        await commandRemoteStart({
+          task,
+          branch,
+          provider,
+          noPr
+        });
+        break;
+
+      case 'list':
+      case 'ls':
+        // Parse command: teleportation remote list [--status running|paused|completed|failed] [--provider fly|daytona]
+        await commandRemoteList({
+          status: flags.status,
+          provider: flags.provider
+        });
+        break;
+
+      case 'status':
+        // Parse command: teleportation remote status <session-id>
+        const statusSessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!statusSessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote status <session-id>\n'));
+          process.exit(1);
+        }
+        await commandRemoteStatus(statusSessionId);
+        break;
+
+      case 'logs':
+        // Parse command: teleportation remote logs <session-id> [--follow] [--tail N]
+        const logsSessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!logsSessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote logs <session-id> [--follow] [--tail N]\n'));
+          process.exit(1);
+        }
+        await commandRemoteLogs(logsSessionId, {
+          follow: flags.follow || false,
+          tail: flags.tail ? parseInt(flags.tail, 10) : undefined
+        });
+        break;
+
+      case 'pull':
+        // Parse command: teleportation remote pull <session-id>
+        const pullSessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!pullSessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote pull <session-id>\n'));
+          process.exit(1);
+        }
+        await commandRemotePull(pullSessionId);
+        break;
+
+      case 'stop':
+        // Parse command: teleportation remote stop <session-id>
+        const stopSessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!stopSessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote stop <session-id>\n'));
+          process.exit(1);
+        }
+        await commandRemoteStop(stopSessionId);
+        break;
+
+      case 'resume':
+        // Parse command: teleportation remote resume <session-id>
+        const resumeSessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!resumeSessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote resume <session-id>\n'));
+          process.exit(1);
+        }
+        await commandRemoteResume(resumeSessionId);
+        break;
+
+      case 'destroy':
+        // Parse command: teleportation remote destroy <session-id> --confirm
+        const destroySessionId = positional[0] || flags['session-id'] || flags.id;
+        if (!destroySessionId) {
+          console.log(c.red('❌ Error: Session ID is required\n'));
+          console.log(c.cyan('Usage: teleportation remote destroy <session-id> --confirm\n'));
+          process.exit(1);
+        }
+        await commandRemoteDestroy(destroySessionId, {
+          confirm: flags.confirm || false
+        });
+        break;
+
+      case 'help':
+      case '--help':
+      case '-h':
+        console.log(c.purple('Remote Session Commands\n'));
+        console.log(c.cyan('Manage remote AI agent sessions running on cloud infrastructure\n'));
+        console.log(c.yellow('Session Management:'));
+        console.log('  ' + c.green('remote start --task "description"') + '     Start a new remote session');
+        console.log('  ' + c.green('remote list') + '                              List all remote sessions');
+        console.log('  ' + c.green('remote status <session-id>') + '              Show session details');
+        console.log('  ' + c.green('remote logs <session-id>') + '                View session logs');
+        console.log('  ' + c.green('remote pull <session-id>') + '                Pull results from remote\n');
+        console.log(c.yellow('Session Control:'));
+        console.log('  ' + c.green('remote stop <session-id>') + '                Pause a running session');
+        console.log('  ' + c.green('remote resume <session-id>') + '              Resume a paused session');
+        console.log('  ' + c.green('remote destroy <session-id> --confirm') + '   Destroy session and cleanup\n');
+        console.log(c.yellow('Options:'));
+        console.log('  ' + c.green('--task "description"') + '    Task for the AI agent to work on');
+        console.log('  ' + c.green('--branch "name"') + '          Git branch to use (optional)');
+        console.log('  ' + c.green('--provider fly|daytona') + '   Force specific provider');
+        console.log('  ' + c.green('--no-pr') + '                  Skip PR creation on completion');
+        console.log('  ' + c.green('--status running|paused') + '  Filter by status');
+        console.log('  ' + c.green('--follow') + '                 Stream logs in real-time');
+        console.log('  ' + c.green('--tail N') + '                 Show last N log lines\n');
+        console.log(c.purple('Examples:'));
+        console.log('  teleportation remote start --task "Implement feature X" --branch feature/x');
+        console.log('  teleportation remote list --status running');
+        console.log('  teleportation remote logs remote-abc123 --follow');
+        console.log('  teleportation remote pull remote-abc123');
+        console.log('  teleportation remote destroy remote-abc123 --confirm\n');
+        break;
+
+      default:
+        console.log(c.red(`Unknown remote command: ${subCommand}\n`));
+        console.log(c.cyan('Run "teleportation remote help" for available commands\n'));
+        process.exit(1);
+    }
+  } catch (error) {
+    console.log(c.red(`❌ Remote command failed: ${error.message}\n`));
+    if (process.env.DEBUG) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
 async function commandDaemon(args) {
   const subCommand = args[0] || 'status';
 
@@ -2807,7 +3203,9 @@ const command = process.argv[2] || 'help';
 const args = process.argv.slice(3);
 
 // Handle async commands that need to complete before exit
-const asyncCommands = ['login', 'logout', 'status', 'test', 'env', 'config', 'daemon', 'away', 'back', 'daemon-status', 'command', 'inbox', 'inbox-ack', 'install-hooks', 'update'];
+const asyncCommands = ['login', 'logout', 'status', 'test', 'env', 'config', 'daemon', 'away', 'back', 'daemon-status', 'command', 'inbox', 'inbox-ack', 'install-hooks', 'update', 'remote'];
+// Keep this list in sync with switch cases below
+asyncCommands.push('github');
 if (asyncCommands.includes(command)) {
   // These commands handle their own async execution
 }
@@ -2898,6 +3296,12 @@ try {
         process.exit(1);
       });
       break;
+    case 'github':
+      commandGithub(args).catch(err => {
+        console.error(c.red('❌ Error:'), err.message);
+        process.exit(1);
+      });
+      break;
     case 'daemon':
       commandDaemon(args).catch(err => {
         console.error(c.red('❌ Error:'), err.message);
@@ -2964,6 +3368,12 @@ try {
         process.exit(1);
       });
       break;
+    case 'remote':
+      commandRemote(args).catch(err => {
+        console.error(c.red('❌ Error:'), err.message);
+        process.exit(1);
+      });
+      break;
     case 'version':
     case '--version':
     case '-v':