instar 0.7.15 → 0.7.17

package/.claude/skills/setup-wizard/skill.md

@@ -651,21 +651,29 @@ The greeting should be **in the agent's voice** AND explain how Telegram topics
 
 Adapt the tone and examples to the agent's personality and role. Keep it warm and practical.
 
-### Step 5c: Tell the User
+### Step 5c: Install Auto-Start
 
-After the server is running and the greeting is sent:
+After the server starts, install auto-start so the agent comes back on login:
 
-> "All done! [Agent name] just messaged you in the Lifeline topic on Telegram. From here on, that's your primary channel — just talk to your agent there."
+```bash
+npx instar autostart install --dir <project_dir>
+```
 
-Then explain the connectivity requirement clearly:
+This creates a macOS LaunchAgent or Linux systemd service. The agent will start automatically whenever the user logs in — nothing to remember.
 
-> "One important thing to know: your agent runs on this computer. As long as it's on and awake, your agent is reachable via Telegram."
->
-> "If your computer goes to sleep or shuts down, Telegram messages will queue up. Your agent will pick them up when it wakes back up."
+### Step 5d: Tell the User
+
+After the server is running, auto-start is installed, and the greeting is sent:
+
+> "All done! [Agent name] just messaged you in the Lifeline topic on Telegram. From here on, that's your primary channel — just talk to your agent there."
 >
-> "For always-on access, some users keep a dedicated machine running — but it's not required to get started."
+> "I've set up auto-start — your agent will come back automatically when you log in. As long as your computer is on and awake, Telegram just works."
+
+If auto-start install failed, explain the fallback:
+
+> "Your agent runs on this computer. If your computer restarts, you'll need to run `instar server start` to bring it back."
 
-Keep it matter-of-fact, not alarming. The user should understand the tradeoff without feeling like they need a server farm to use this.
+Keep it matter-of-fact, not alarming.
 
 **Do NOT present a list of CLI commands or next steps.** The setup wizard's job is done. The user's next action is opening Telegram and replying to their agent.
 

package/dist/cli.js

@@ -547,5 +547,82 @@ program
         console.log();
     }
 });
+// ── Auto-Start ───────────────────────────────────────────────────
+const autostartCmd = program
+    .command('autostart')
+    .description('Manage auto-start on login (agent starts when you log into your computer)');
+autostartCmd
+    .command('install')
+    .description('Install auto-start so your agent starts on login')
+    .option('-d, --dir <path>', 'Project directory')
+    .action(async (opts) => {
+    const { loadConfig } = await import('./core/Config.js');
+    const { installAutoStart } = await import('./commands/setup.js');
+    const config = loadConfig(opts.dir);
+    const hasTelegram = config.messaging?.some((m) => m.type === 'telegram') ?? false;
+    const installed = installAutoStart(config.projectName, config.projectDir, hasTelegram);
+    if (installed) {
+        console.log(pc.green(`Auto-start installed for "${config.projectName}".`));
+        console.log(pc.dim('Your agent will start automatically when you log in.'));
+    }
+    else {
+        console.log(pc.red('Failed to install auto-start.'));
+        console.log(pc.dim(`Platform: ${process.platform} — auto-start supports macOS and Linux.`));
+    }
+});
+autostartCmd
+    .command('uninstall')
+    .description('Remove auto-start')
+    .option('-d, --dir <path>', 'Project directory')
+    .action(async (opts) => {
+    const { loadConfig } = await import('./core/Config.js');
+    const { uninstallAutoStart } = await import('./commands/setup.js');
+    const config = loadConfig(opts.dir);
+    const removed = uninstallAutoStart(config.projectName);
+    if (removed) {
+        console.log(pc.green(`Auto-start removed for "${config.projectName}".`));
+    }
+    else {
+        console.log(pc.yellow('No auto-start found to remove.'));
+    }
+});
+autostartCmd
+    .command('status')
+    .description('Check if auto-start is installed')
+    .option('-d, --dir <path>', 'Project directory')
+    .action(async (opts) => {
+    const { loadConfig } = await import('./core/Config.js');
+    const config = loadConfig(opts.dir);
+    const os = await import('node:os');
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    if (process.platform === 'darwin') {
+        const label = `ai.instar.${config.projectName}`;
+        const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+        if (fs.existsSync(plistPath)) {
+            console.log(pc.green(`Auto-start is installed (macOS LaunchAgent: ${label})`));
+            console.log(pc.dim(`  Plist: ${plistPath}`));
+        }
+        else {
+            console.log(pc.yellow('Auto-start is not installed.'));
+            console.log(pc.dim('  Install with: instar autostart install'));
+        }
+    }
+    else if (process.platform === 'linux') {
+        const serviceName = `instar-${config.projectName}.service`;
+        const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', serviceName);
+        if (fs.existsSync(servicePath)) {
+            console.log(pc.green(`Auto-start is installed (systemd user service: ${serviceName})`));
+            console.log(pc.dim(`  Service: ${servicePath}`));
+        }
+        else {
+            console.log(pc.yellow('Auto-start is not installed.'));
+            console.log(pc.dim('  Install with: instar autostart install'));
+        }
+    }
+    else {
+        console.log(pc.yellow(`Auto-start is not supported on ${process.platform}.`));
+    }
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/commands/setup.d.ts

@@ -21,4 +21,16 @@
 export declare function runSetup(opts?: {
     classic?: boolean;
 }): Promise<void>;
+/**
+ * Install auto-start so the agent's lifeline process starts on login.
+ * macOS: LaunchAgent plist in ~/Library/LaunchAgents/
+ * Linux: systemd user service in ~/.config/systemd/user/
+ *
+ * Returns true if auto-start was installed successfully.
+ */
+export declare function installAutoStart(projectName: string, projectDir: string, hasTelegram: boolean): boolean;
+/**
+ * Remove auto-start for a project.
+ */
+export declare function uninstallAutoStart(projectName: string): boolean;
 //# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.js

@@ -17,6 +17,7 @@
 import { execFileSync, spawn } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import pc from 'picocolors';
 import { input, confirm, select, number } from '@inquirer/prompts';
@@ -449,6 +450,12 @@ async function runClassicSetup() {
     console.log(pc.dim('  Starting server...'));
     const { startServer } = await import('./server.js');
     await startServer({ foreground: false });
+    // ── Auto-start on login ──────────────────────────────────────────
+    const hasTelegram = !!telegramConfig?.chatId;
+    const autoStartInstalled = installAutoStart(projectName, projectDir, hasTelegram);
+    if (autoStartInstalled) {
+        console.log(pc.green('  ✓ Auto-start installed — your agent will start on login.'));
+    }
     if (telegramConfig?.chatId) {
         // Create the Lifeline topic — the always-available channel
         let lifelineThreadId = null;
@@ -520,9 +527,15 @@ async function runClassicSetup() {
         console.log(pc.bold(`  All done! ${projectName} just messaged you${topicNote} on Telegram.`));
         console.log(pc.dim('  That\'s your primary channel from here on — no terminal needed.'));
         console.log();
-        console.log(pc.dim('  Your agent runs on this computer. As long as it\'s on and awake,'));
-        console.log(pc.dim('  your agent is reachable via Telegram. If your computer sleeps or'));
-        console.log(pc.dim('  shuts down, messages will queue and be picked up when it wakes.'));
+        if (autoStartInstalled) {
+            console.log(pc.dim('  Your agent starts automatically when you log in — nothing to remember.'));
+            console.log(pc.dim('  As long as your computer is on and awake, Telegram just works.'));
+        }
+        else {
+            console.log(pc.dim('  Your agent runs on this computer. As long as it\'s on and awake,'));
+            console.log(pc.dim('  your agent is reachable via Telegram. You\'ll need to run'));
+            console.log(pc.dim(`  ${pc.cyan('instar server start')} after a reboot.`));
+        }
     }
     else {
         console.log();
@@ -588,6 +601,208 @@ function isInstarGlobal() {
         return false;
     }
 }
+// ── Auto-Start on Login ─────────────────────────────────────────
+/**
+ * Install auto-start so the agent's lifeline process starts on login.
+ * macOS: LaunchAgent plist in ~/Library/LaunchAgents/
+ * Linux: systemd user service in ~/.config/systemd/user/
+ *
+ * Returns true if auto-start was installed successfully.
+ */
+export function installAutoStart(projectName, projectDir, hasTelegram) {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        return installMacOSLaunchAgent(projectName, projectDir, hasTelegram);
+    }
+    else if (platform === 'linux') {
+        return installLinuxSystemdService(projectName, projectDir, hasTelegram);
+    }
+    else {
+        // Windows or other — no auto-start support yet
+        return false;
+    }
+}
+/**
+ * Remove auto-start for a project.
+ */
+export function uninstallAutoStart(projectName) {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        const label = `ai.instar.${projectName}`;
+        const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+        // Unload if loaded
+        try {
+            execFileSync('launchctl', ['bootout', `gui/${process.getuid?.() ?? 501}`, plistPath], { stdio: 'ignore' });
+        }
+        catch { /* not loaded */ }
+        // Remove file
+        try {
+            fs.unlinkSync(plistPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    else if (platform === 'linux') {
+        const serviceName = `instar-${projectName}.service`;
+        const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', serviceName);
+        try {
+            execFileSync('systemctl', ['--user', 'disable', serviceName], { stdio: 'ignore' });
+            execFileSync('systemctl', ['--user', 'stop', serviceName], { stdio: 'ignore' });
+        }
+        catch { /* not loaded */ }
+        try {
+            fs.unlinkSync(servicePath);
+            execFileSync('systemctl', ['--user', 'daemon-reload'], { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+function findNodePath() {
+    try {
+        return execFileSync('which', ['node'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return '/usr/local/bin/node';
+    }
+}
+function findInstarCli() {
+    // Find the actual instar CLI entry point
+    try {
+        const globalPath = execFileSync('which', ['instar'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (globalPath && !globalPath.includes('.npm/_npx')) {
+            return globalPath;
+        }
+    }
+    catch { /* not global */ }
+    // Fallback: use the dist/cli.js from the npm package
+    const cliPath = new URL('../cli.js', import.meta.url).pathname;
+    if (fs.existsSync(cliPath)) {
+        return cliPath;
+    }
+    return 'instar';
+}
+function installMacOSLaunchAgent(projectName, projectDir, hasTelegram) {
+    const label = `ai.instar.${projectName}`;
+    const launchAgentsDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
+    const plistPath = path.join(launchAgentsDir, `${label}.plist`);
+    const logDir = path.join(projectDir, '.instar', 'logs');
+    const nodePath = findNodePath();
+    const instarCli = findInstarCli();
+    // Determine what to start: lifeline if Telegram configured, otherwise just the server
+    const command = hasTelegram ? 'lifeline' : 'server';
+    const args = hasTelegram
+        ? [instarCli, 'lifeline', 'start', '--dir', projectDir]
+        : [instarCli, 'server', 'start', '--foreground', '--dir', projectDir];
+    // If instar CLI is a node script (not a binary), prepend node
+    const isNodeScript = instarCli.endsWith('.js') || instarCli.endsWith('.mjs');
+    const programArgs = isNodeScript ? [nodePath, ...args] : args;
+    // Build the plist XML
+    const argsXml = programArgs.map(a => `      <string>${escapeXml(a)}</string>`).join('\n');
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${escapeXml(label)}</string>
+    <key>ProgramArguments</key>
+    <array>
+${argsXml}
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${escapeXml(projectDir)}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${escapeXml(path.join(logDir, `${command}-launchd.log`))}</string>
+    <key>StandardErrorPath</key>
+    <string>${escapeXml(path.join(logDir, `${command}-launchd.err`))}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>${escapeXml(process.env.PATH || '/usr/local/bin:/usr/bin:/bin')}</string>
+    </dict>
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+</dict>
+</plist>`;
+    try {
+        fs.mkdirSync(launchAgentsDir, { recursive: true });
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.writeFileSync(plistPath, plist);
+        // Load the agent
+        try {
+            // Unload first if already loaded
+            execFileSync('launchctl', ['bootout', `gui/${process.getuid?.() ?? 501}`, plistPath], { stdio: 'ignore' });
+        }
+        catch { /* not loaded yet — fine */ }
+        execFileSync('launchctl', ['bootstrap', `gui/${process.getuid?.() ?? 501}`, plistPath], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function installLinuxSystemdService(projectName, projectDir, hasTelegram) {
+    const serviceName = `instar-${projectName}.service`;
+    const serviceDir = path.join(os.homedir(), '.config', 'systemd', 'user');
+    const servicePath = path.join(serviceDir, serviceName);
+    const nodePath = findNodePath();
+    const instarCli = findInstarCli();
+    const command = hasTelegram ? 'lifeline' : 'server';
+    const args = hasTelegram
+        ? `${instarCli} lifeline start --dir ${projectDir}`
+        : `${instarCli} server start --foreground --dir ${projectDir}`;
+    const isNodeScript = instarCli.endsWith('.js') || instarCli.endsWith('.mjs');
+    const execStart = isNodeScript ? `${nodePath} ${args}` : args;
+    const service = `[Unit]
+Description=Instar Agent - ${projectName}
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${execStart}
+WorkingDirectory=${projectDir}
+Restart=always
+RestartSec=10
+Environment=PATH=${process.env.PATH || '/usr/local/bin:/usr/bin:/bin'}
+
+[Install]
+WantedBy=default.target
+`;
+    try {
+        fs.mkdirSync(serviceDir, { recursive: true });
+        fs.writeFileSync(servicePath, service);
+        execFileSync('systemctl', ['--user', 'daemon-reload'], { stdio: 'ignore' });
+        execFileSync('systemctl', ['--user', 'enable', serviceName], { stdio: 'ignore' });
+        execFileSync('systemctl', ['--user', 'start', serviceName], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
 // ── Prompt Helpers ───────────────────────────────────────────────
 /**
  * Full Telegram walkthrough. Returns config or null if skipped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.7.15",
+  "version": "0.7.17",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/.vercel/README.txt

@@ -1,11 +0,0 @@
-> Why do I have a folder named ".vercel" in my project?
-The ".vercel" folder is created when you link a directory to a Vercel project.
-
-> What does the "project.json" file contain?
-The "project.json" file contains:
-- The ID of the Vercel project that you linked ("projectId")
-- The ID of the user or team your Vercel project is owned by ("orgId")
-
-> Should I commit the ".vercel" folder?
-No, you should not share the ".vercel" folder with anyone.
-Upon creation, it will be automatically added to your ".gitignore" file.

package/.vercel/project.json

@@ -1 +0,0 @@
-{"projectId":"prj_evM5LcItYL3IAmw8zNvEPGrHeaya","orgId":"team_dHctwIDcV3X9ydapQlCPHFGI","projectName":"claude-agent-kit"}