0101-agents 0.1.6 → 0.1.7

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

@@ -353,9 +353,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 +447,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.7",
   "description": "",
   "bin": {
     "0101-agents": "./bin/cli.js"