0101-agents 0.1.0 → 0.1.2

package/bin/cli.js

@@ -10,7 +10,7 @@
 //   0101-agents list
 //   0101-agents help
 
-import { execSync } from 'node:child_process'
+import { execSync, spawn } from 'node:child_process'
 import {
   existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync,
   rmSync, statSync, createWriteStream,
@@ -135,9 +135,11 @@ function unzipInto(zipPath, destDir, { skipPrefix } = {}) {
   // Use the system unzip binary. Available everywhere except bare Windows.
   mkdirSync(destDir, { recursive: true })
   if (skipPrefix) {
-    // unzip with -x excludes paths matching glob patterns.
+    // unzip's -x excludes paths matching glob patterns. `<prefix>/*` catches
+    // every file under the directory; the bare directory entry (e.g. `data/`)
+    // is harmless to re-extract because it just re-creates the dir shell.
     execSync(
-      `unzip -q -o "${zipPath}" -d "${destDir}" -x "${skipPrefix}/*" "${skipPrefix}"`,
+      `unzip -q -o "${zipPath}" -d "${destDir}" -x "${skipPrefix}/*"`,
       { stdio: 'inherit' },
     )
   } else {
@@ -169,10 +171,11 @@ async function prompt(question) {
 async function cmdLogin(args) {
   let key = args[0]
   if (!key) {
+    console.log(dim('Get your license key at https://0101.fyi/account'))
     key = await prompt('Paste your license key: ')
   }
   key = key.trim()
-  if (!key) die('No key provided.')
+  if (!key) die('No key provided. Get one at https://0101.fyi/account')
   writeConfig({ ...readConfig(), license_key: key })
   ok(`Saved license to ${CONFIG_PATH}`)
 }
@@ -222,7 +225,8 @@ async function cmdInstall(args) {
 
   console.log('')
   ok(`Installed ${bold(agent)} ${manifest.latest} → ${installDir}`)
-  info(`Start: cd ${installDir} && claude`)
+  info(`Start: 0101-agents start ${agent}`)
+  info(`   or: cd ${installDir} && claude`)
 }
 
 async function cmdUpdate(args) {
@@ -245,6 +249,7 @@ async function cmdUpdate(args) {
     return
   }
 
+  console.log(dim('Your data/ folder is preserved (memory, projects, custom files).'))
   const ans = await prompt(`Update ${agent} ${current ?? '?'} → ${manifest.latest}? [Y/n] `)
   if (ans && !/^y(es)?$/i.test(ans)) {
     info('Cancelled.')
@@ -281,17 +286,64 @@ function cmdList() {
   }
 }
 
+async function cmdStart(args) {
+  const agent = args[0]
+  if (!agent) die('Usage: 0101-agents start <agent> [-- <claude-args>]')
+  const dir = agentInstallDir(agent)
+  if (!existsSync(dir)) {
+    die(`${agent} is not installed. Try: 0101-agents install ${agent}`)
+  }
+
+  // Best-effort update check. Silently skipped if offline or the server
+  // misbehaves — never blocks the launch.
+  try {
+    const manifest = await fetchManifest(agent)
+    const current = installedVersion(agent)
+    if (current && manifest.latest !== current) {
+      console.log(
+        dim(`⚠ ${agent} ${manifest.latest} available (run: 0101-agents update ${agent})`),
+      )
+    }
+  } catch {
+    // ignore
+  }
+
+  // Everything after the agent name passes through to `claude`. Supports both:
+  //   0101-agents start marketer --resume
+  //   0101-agents start marketer -- --resume  (explicit separator)
+  // The `--` is optional; if present, we drop it.
+  let claudeArgs = args.slice(1)
+  if (claudeArgs[0] === '--') claudeArgs = claudeArgs.slice(1)
+
+  // Hand the terminal over to `claude` with cwd set to the agent dir. When
+  // claude exits, the user returns to their original shell location.
+  const child = spawn('claude', claudeArgs, { cwd: dir, stdio: 'inherit' })
+  child.on('error', (e) => {
+    if (e.code === 'ENOENT') {
+      die('`claude` not found in PATH. Install Claude Code first: https://claude.com/code')
+    }
+    die(`Failed to start claude: ${e.message}`)
+  })
+  child.on('exit', (code) => process.exit(code ?? 0))
+}
+
 function cmdHelp() {
   console.log(`0101-agents — install and update Claude Code agents.
 
 Commands:
-  ${bold('login')} [<key>]            Save your license key
-  ${bold('logout')}                   Forget your license key
-  ${bold('whoami')}                   Show current license
-  ${bold('install')} <agent> [--force]  Install an agent
-  ${bold('update')}  <agent>          Update an installed agent (preserves data/)
-  ${bold('list')}                     List installed agents
-  ${bold('help')}                     Show this message
+  ${bold('login')} [<key>]              Save your license key
+  ${bold('logout')}                     Forget your license key
+  ${bold('whoami')}                     Show current license
+  ${bold('install')} <agent> [--force]    Install an agent
+  ${bold('update')}  <agent>             Update an installed agent (preserves data/)
+  ${bold('start')}   <agent> [-- args]   Open the agent (runs claude inside its dir)
+  ${bold('list')}                       List installed agents
+  ${bold('help')}                       Show this message
+
+Examples:
+  0101-agents start marketer
+  0101-agents start marketer --resume
+  0101-agents start marketer -- -p "audit https://example.com"
 
 Install dir: ${INSTALL_ROOT}
 Config:      ${CONFIG_PATH}`)
@@ -308,6 +360,7 @@ try {
     case 'whoami':   await cmdWhoami(); break
     case 'install':  await cmdInstall(rest); break
     case 'update':   await cmdUpdate(rest); break
+    case 'start':    await cmdStart(rest); break
     case 'list':     cmdList(); break
     case 'help':
     case '-h':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0101-agents",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "",
   "bin": {
     "0101-agents": "./bin/cli.js"