0101-agents 0.1.6 → 0.1.8

package/README.md

@@ -0,0 +1,12 @@
+# 0101-agents
+
+CLI to install, update, and run 0101 Claude Code agents.
+
+```bash
+npm i -g 0101-agents
+0101-agents login <key>
+0101-agents install <agent>
+0101-agents start <agent>
+```
+
+See https://0101.fyi

package/bin/cli.js

@@ -336,15 +336,25 @@ async function cmdStart(args) {
     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.
+  // Best-effort update nag. Needs a saved key (the releases API is gated);
+  // no key, offline, or any non-200 (revoked, lapsed, agent not on the
+  // server) → skip silently. Launching NEVER depends on this — deliberately
+  // not fetchManifest(), whose die() on HTTP errors would kill 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})`),
-      )
+    const key = readConfig().license_key
+    if (key) {
+      const res = await fetch(`${apiBase()}/api/releases/${encodeURIComponent(agent)}`, {
+        headers: { Authorization: `Bearer ${key}` },
+      })
+      if (res.ok) {
+        const manifest = await res.json()
+        const current = installedVersion(agent)
+        if (current && manifest.latest !== current) {
+          console.log(
+            dim(`⚠ ${agent} ${manifest.latest} available (run: 0101-agents update ${agent})`),
+          )
+        }
+      }
     }
   } catch {
     // ignore
@@ -353,9 +363,46 @@ async function cmdStart(args) {
   // Artifacts can declare how `start` launches via manifest.start. The runner
   // sets "npm start"; agents leave it unset and fall through to launching
   // Claude Code below.
+  //
+  // For the runner specifically we accept an optional `[slug] [cli]` so
+  // power users can run multiple bots in parallel terminals without touching
+  // .env. The runner derives STATE_DIR from AGENT_DIR, so per-agent state is
+  // automatic — we only need to override AGENT_DIR here.
+  //
+  //   start runner                    → npm start                  (Telegram, AGENT_DIR from .env)
+  //   start runner cli                → npm start -- --cli         (CLI, AGENT_DIR from .env)
+  //   start runner marketer           → npm start                  (Telegram, AGENT_DIR=~/0101/marketer)
+  //   start runner marketer cli       → npm start -- --cli         (CLI, AGENT_DIR=~/0101/marketer)
+  //   start runner --cli              → same as `start runner cli` (long-form flag)
+  //   start runner -- --cli           → same                        (explicit separator)
   const startCmd = readManifest(agent).start
   if (startCmd) {
-    const child = spawn(startCmd, { cwd: dir, stdio: 'inherit', shell: true })
+    let extra = args.slice(1)
+    if (extra[0] === '--') extra = extra.slice(1)
+
+    // Optional [slug] [mode] positionals — `cli` is a reserved mode keyword
+    // (no real agent will ever be named "cli"). Anything else that doesn't
+    // start with `-` is treated as a slug. Verified installed before we spawn.
+    let slug = null
+    if (extra[0] && extra[0] !== 'cli' && !extra[0].startsWith('-')) {
+      slug = extra.shift()
+      if (!existsSync(agentInstallDir(slug))) {
+        die(`${slug} is not installed. Try: 0101-agents install ${slug}`)
+      }
+    }
+    extra = extra.map(a => (a === 'cli' ? '--cli' : a))
+
+    // Override AGENT_DIR per invocation when a slug is given. The runner's
+    // config.ts derives STATE_DIR from basename(AGENT_DIR), so the per-agent
+    // state/lockfile/incoming dirs follow automatically.
+    const childEnv = { ...process.env }
+    if (slug) {
+      childEnv.AGENT_DIR = agentInstallDir(slug)
+      info(`runner: agent=${slug}`)
+    }
+
+    const full = extra.length > 0 ? `${startCmd} -- ${extra.join(' ')}` : startCmd
+    const child = spawn(full, { cwd: dir, stdio: 'inherit', shell: true, env: childEnv })
     child.on('error', (e) => die(`Failed to start: ${e.message}`))
     child.on('exit', (code) => process.exit(code ?? 0))
     return
@@ -410,10 +457,13 @@ Commands:
   ${bold('help')}                       Show this message
 
 Examples:
-  0101-agents start marketer
-  0101-agents start marketer --tg
-  0101-agents start marketer --resume
-  0101-agents start marketer -- -p "audit https://example.com"
+  0101-agents start marketer                    Open in Claude Code
+  0101-agents start marketer --tg               Run as a Telegram channel bot via Claude Code
+  0101-agents start marketer --resume           Resume the last Claude Code session
+  0101-agents start runner                      Telegram bot via 0101-runner (uses .env)
+  0101-agents start runner cli                  Chat with the agent in this terminal
+  0101-agents start runner marketer             Run a Telegram bot for marketer (multi-bot)
+  0101-agents start runner marketer cli         Terminal chat for marketer
 
 Install dir: ${INSTALL_ROOT}
 Config:      ${CONFIG_PATH}`)

package/package.json

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