@triclaps/cli 0.0.2 → 0.0.3

package/README.md

@@ -43,20 +43,32 @@ claps-cli register \
   --runtime codex \
   --external-key your-agent-key \
   --name "Your Agent Name" \
-  --save-token \
-  --start-daemon
+  --save-token
 ```
 
-`register` handles the first-time onboarding flow: it registers the agent, saves the returned token locally, and can start the background daemon right away.
+`register` handles the first-time onboarding flow end to end:
+
+- it registers the agent
+- saves the returned token into the default local agent home at `$HOME/.triclaps-agents/<agent-key>`
+- starts the detached worker by default
+- injects the managed CLAPS skills into `$HOME/.triclaps-agents/<agent-key>/skills`
+
+If you need to restart that same agent later, run:
+
+```bash
+claps-cli daemon start --api-base-url http://127.0.0.1:3001 --external-key your-agent-key
+```
+
+`daemon start` replaces any existing process for the same agent key by default, so one key stays mapped to one local worker instance.
 
 ## Common Commands
 
 ```bash
 claps-cli daemon status
-claps-cli run
+claps-cli run --external-key your-agent-key
 claps-cli sync-runtime --runtime codex
 ```
 
 - Use `claps-cli daemon status` to inspect the detached worker.
-- Use `claps-cli run` when you want foreground output for debugging.
+- Use `claps-cli run --external-key ...` when you want foreground output for debugging.
 - Use `claps-cli sync-runtime` when you need to refresh managed runtime assets for a runtime.

package/index.js

@@ -6,6 +6,7 @@ var __export = (target, all) => {
 };
 
 // src/cli.ts
+import os6 from "node:os";
 import { mkdir as mkdir6, readFile as readFile7, writeFile as writeFile7 } from "node:fs/promises";
 import { dirname as dirname3, resolve as resolve2 } from "node:path";
 
@@ -4359,6 +4360,7 @@ var agentSummarySchema = external_exports.object({
   lastSeenAt: external_exports.string().min(1),
   heartbeatStatus: agentHeartbeatStatusSchema.nullable().optional(),
   heartbeatNote: nullableTextSchema.optional(),
+  protocolVersion: nullableTextSchema.optional(),
   notificationEndpoint: external_exports.object({
     endpointType: external_exports.enum(notificationEndpointTypes),
     address: external_exports.string().min(1)
@@ -4392,6 +4394,7 @@ var importedAgentSchema = external_exports.object({
   token: nullableTextSchema,
   heartbeatStatus: agentHeartbeatStatusSchema.nullable().optional(),
   heartbeatNote: nullableTextSchema.optional(),
+  protocolVersion: nullableTextSchema.optional(),
   lastSeenAt: external_exports.string().min(1).nullable().optional(),
   importedAt: external_exports.string().min(1),
   deletedAt: external_exports.string().min(1).nullable().optional()
@@ -7009,13 +7012,16 @@ async function ensureAgentHome(input) {
 }
 async function ensureAgentRuntimeHome(input) {
   const env = input.env ?? process.env;
-  const home = await ensureAgentHome({
-    agentId: input.agentId,
-    agentName: input.agentName ?? null,
-    runtime: input.runtime,
-    env
-  });
-  const runtimeHomePath = path4.join(home.runtimePath, input.runtime);
+  const explicitAgentHomePath = env.CLAPS_AGENT_HOME_PATH?.trim();
+  const runtimeHomePath = explicitAgentHomePath ? path4.resolve(explicitAgentHomePath) : path4.join(
+    (await ensureAgentHome({
+      agentId: input.agentId,
+      agentName: input.agentName ?? null,
+      runtime: input.runtime,
+      env
+    })).runtimePath,
+    input.runtime
+  );
   await mkdir(runtimeHomePath, { recursive: true });
   const sharedRuntimeHomePath = getAgentDriver(input.runtime).resolveHome(env);
   if (path4.resolve(sharedRuntimeHomePath) !== path4.resolve(runtimeHomePath)) {
@@ -7320,7 +7326,8 @@ async function readDiscoveredAgentHomes(env) {
   const homeDir = resolveHomeDirectory(env);
   const candidateRoots = /* @__PURE__ */ new Set([
     path5.join(stateHome, "agents"),
-    path5.join(homeDir, ".claps-agents")
+    path5.join(homeDir, ".claps-agents"),
+    path5.join(homeDir, ".triclaps-agents")
   ]);
   const candidateHomePaths = /* @__PURE__ */ new Set();
   for (const rootPath of candidateRoots) {
@@ -8144,6 +8151,10 @@ function resolveRuntimeHome(runtime, env) {
   if (genericHome) {
     return path6.resolve(genericHome);
   }
+  const agentHomePath = env.CLAPS_AGENT_HOME_PATH?.trim();
+  if (agentHomePath) {
+    return path6.resolve(agentHomePath);
+  }
   return getAgentDriver(runtime).resolveHome(env);
 }
 async function inspectManagedSkillPath(targetPath, expectedSource) {
@@ -12182,6 +12193,10 @@ async function resolveEffectiveWorkspacePath(me, env = process.env) {
   if (configuredWorkspacePath) {
     return configuredWorkspacePath;
   }
+  const configuredAgentHomePath = me.agentHomePath?.trim() || env.CLAPS_AGENT_HOME_PATH?.trim();
+  if (configuredAgentHomePath) {
+    return path10.join(path10.resolve(configuredAgentHomePath), "workspace");
+  }
   return ensureAgentWorkspaceRoot({
     agentId: me.id,
     env
@@ -14822,7 +14837,7 @@ async function processConversationTurnItem(client, me, item, logger = defaultLog
   logger.info(
     `[claps-cli] processing conversation turn: ticketId=${ticketId}, conversationId=${context.conversation.id}, message=${context.requestMessage.content.slice(0, 200)}`
   );
-  const runtimeCwd = me.agent.workspacePath ?? process.cwd();
+  const runtimeCwd = await resolveEffectiveWorkspacePath(me.agent);
   const driver = getAgentDriver(me.agent.runtime);
   const preparedSession = await conversationSessionManager.prepareTurn({
     agentId: me.agent.id,
@@ -15380,9 +15395,15 @@ async function runCli(argv, options = {}) {
     return 0;
   }
   if (parsed.command === "run") {
+    const agentHomeOverride2 = validateNoAgentHomeOverride(parsed.flags);
+    if (!agentHomeOverride2.ok) {
+      stderr.write(`${agentHomeOverride2.message}
+`);
+      return 1;
+    }
     const runEnv = mergeEnvWithDaemonFlags(env, parsed.flags);
     const requestedExternalKey = readStringFlag(parsed.flags, "external-key");
-    const configuredAgentKey = normalizeOptional3(env.CLAPS_AGENT_KEY);
+    const configuredAgentKey = normalizeOptional3((options.env ?? process.env).CLAPS_AGENT_KEY) ?? normalizeOptional3(env.CLAPS_AGENT_KEY);
     if (requestedExternalKey) {
       logger.warn(
         configuredAgentKey && configuredAgentKey !== requestedExternalKey ? `[claps-cli] run still identifies via CLAPS_AGENT_TOKEN from .env.local/env. The current local binding is ${configuredAgentKey}, so --external-key ${requestedExternalKey} does not switch the worker to a different agent by itself.` : `[claps-cli] run uses CLAPS_AGENT_TOKEN to select the agent. --external-key ${requestedExternalKey} does not switch identity by itself.`
@@ -16076,6 +16097,12 @@ ${await buildHelpText(cwd)}
     return 0;
   }
   if (parsed.command === "daemon-start") {
+    const agentHomeOverride2 = validateNoAgentHomeOverride(parsed.flags);
+    if (!agentHomeOverride2.ok) {
+      stderr.write(`${agentHomeOverride2.message}
+`);
+      return 1;
+    }
     const daemonEnv = mergeEnvWithDaemonFlags(env, parsed.flags);
     const daemonLaunchCheck = validateDaemonLaunchEnv(daemonEnv);
     if (!daemonLaunchCheck.ok) {
@@ -16086,7 +16113,7 @@ ${await buildHelpText(cwd)}
     const result = await startBackgroundDaemon({
       cwd,
       env: daemonEnv,
-      replaceExisting: readBooleanFlag(parsed.flags, "replace") === true,
+      replaceExisting: readBooleanFlag(parsed.flags, "replace") !== false,
       ...options.spawnImpl ? { spawnImpl: options.spawnImpl } : {},
       ...options.killImpl ? { killImpl: options.killImpl } : {}
     });
@@ -16095,6 +16122,12 @@ ${await buildHelpText(cwd)}
     return 0;
   }
   if (parsed.command === "daemon-stop") {
+    const agentHomeOverride2 = validateNoAgentHomeOverride(parsed.flags);
+    if (!agentHomeOverride2.ok) {
+      stderr.write(`${agentHomeOverride2.message}
+`);
+      return 1;
+    }
     const daemonEnv = mergeEnvWithDaemonFlags(env, parsed.flags);
     const result = await stopBackgroundDaemon(
       daemonEnv,
@@ -16105,6 +16138,12 @@ ${await buildHelpText(cwd)}
     return 0;
   }
   if (parsed.command === "daemon-status") {
+    const agentHomeOverride2 = validateNoAgentHomeOverride(parsed.flags);
+    if (!agentHomeOverride2.ok) {
+      stderr.write(`${agentHomeOverride2.message}
+`);
+      return 1;
+    }
     const daemonEnv = mergeEnvWithDaemonFlags(env, parsed.flags);
     const result = await readDaemonStatus(daemonEnv, options.killImpl ?? process.kill);
     stdout.write(`${formatDaemonStatus(result)}
@@ -16112,6 +16151,12 @@ ${await buildHelpText(cwd)}
     return result.status === "running" ? 0 : 1;
   }
   if (parsed.command === "daemon-logs") {
+    const agentHomeOverride2 = validateNoAgentHomeOverride(parsed.flags);
+    if (!agentHomeOverride2.ok) {
+      stderr.write(`${agentHomeOverride2.message}
+`);
+      return 1;
+    }
     const daemonEnv = mergeEnvWithDaemonFlags(env, parsed.flags);
     const lineCount = readNumberFlag(parsed.flags, "lines");
     const result = await readDaemonLog(daemonEnv, lineCount ? { lines: lineCount } : {});
@@ -16150,6 +16195,12 @@ ${await buildHelpText(cwd)}
       return 1;
     }
   }
+  const agentHomeOverride = validateNoAgentHomeOverride(parsed.flags);
+  if (!agentHomeOverride.ok) {
+    stderr.write(`${agentHomeOverride.message}
+`);
+    return 1;
+  }
   const registration = buildRegisterCommandConfig(parsed.flags, env, cwd);
   if (!registration.ok) {
     stderr.write(`${registration.message}
@@ -16163,7 +16214,10 @@ ${await buildHelpText(cwd)}
       const syncResult = await syncRuntimeAssets({
         runtime: registration.config.request.runtime,
         cwd,
-        env
+        env: {
+          ...env,
+          ...registration.config.request.agentHomePath ? { CLAPS_AGENT_HOME_PATH: registration.config.request.agentHomePath } : {}
+        }
       });
       if (syncResult.status === "check_failed") {
         stderr.write(`${formatRuntimeAssetSyncResult(syncResult)}
@@ -16177,11 +16231,14 @@ ${await buildHelpText(cwd)}
     const response = await registerAgentWithApi(registration.config, options.fetchImpl ?? fetch);
     if (registration.config.saveToken) {
       await saveRuntimeEnv(registration.config.envFilePath, {
+        ...registration.config.request.capabilitySummary ? { CLAPS_AGENT_CAPABILITY_SUMMARY: registration.config.request.capabilitySummary } : {},
         CLAPS_AGENT_KEY: registration.config.request.externalKey,
         CLAPS_AGENT_NAME: registration.config.request.name,
         CLAPS_AGENT_RUNTIME: registration.config.request.runtime,
         CLAPS_AGENT_HOME_PATH: registration.config.request.agentHomePath ?? dirname3(registration.config.envFilePath),
+        CLAPS_AGENT_DANGEROUSLY_BYPASS_SANDBOX: registration.config.request.dangerouslyBypassSandbox ? "1" : "0",
         ...registration.config.request.workspacePath ? { CLAPS_AGENT_WORKSPACE_PATH: registration.config.request.workspacePath } : {},
+        ...registration.config.request.protocolVersion ? { CLAPS_AGENT_PROTOCOL_VERSION: registration.config.request.protocolVersion } : {},
         CLAPS_AGENT_AUTH_MODE: response.outcome === "registered" ? response.session.authMode : response.bootstrapSession.authMode,
         ...registration.config.request.orgSlug ? { CLAPS_ORG_SLUG: registration.config.request.orgSlug } : {},
         CLAPS_AGENT_TOKEN: response.outcome === "registered" ? response.session.token : response.bootstrapSession.token,
@@ -16200,7 +16257,9 @@ ${await buildHelpText(cwd)}
         CLAPS_AGENT_NAME: registration.config.request.name,
         CLAPS_AGENT_RUNTIME: registration.config.request.runtime,
         CLAPS_AGENT_HOME_PATH: registration.config.request.agentHomePath ?? dirname3(registration.config.envFilePath),
+        CLAPS_AGENT_DANGEROUSLY_BYPASS_SANDBOX: registration.config.request.dangerouslyBypassSandbox ? "1" : "0",
         ...registration.config.request.workspacePath ? { CLAPS_AGENT_WORKSPACE_PATH: registration.config.request.workspacePath } : {},
+        ...registration.config.request.protocolVersion ? { CLAPS_AGENT_PROTOCOL_VERSION: registration.config.request.protocolVersion } : {},
         ...registration.config.request.orgSlug ? { CLAPS_ORG_SLUG: registration.config.request.orgSlug } : {}
       };
       daemonResult = await startBackgroundDaemon({
@@ -16498,10 +16557,8 @@ function buildRegisterCommandConfig(flags, env, cwd) {
     capabilitySummary: readStringFlag(flags, "capability-summary") ?? normalizeNullable(env.CLAPS_AGENT_CAPABILITY_SUMMARY),
     channelRef: readStringFlag(flags, "channel-ref") ?? normalizeNullable(env.CLAPS_AGENT_CHANNEL_REF),
     workspacePath: readStringFlag(flags, "workspace-path") ?? normalizeNullable(env.CLAPS_AGENT_WORKSPACE_PATH),
-    agentHomePath: normalizePathLike(
-      readStringFlag(flags, "agent-home-path") ?? normalizeOptional3(env.CLAPS_AGENT_HOME_PATH),
-      cwd
-    ) ?? resolve2(cwd),
+    agentHomePath: null,
+    dangerouslyBypassSandbox: readBooleanFlag(flags, "dangerously-bypass-sandbox") ?? normalizeOptional3(env.CLAPS_AGENT_DANGEROUSLY_BYPASS_SANDBOX) === "1",
     protocolVersion: readStringFlag(flags, "protocol-version") ?? normalizeNullable(env.CLAPS_AGENT_PROTOCOL_VERSION)
   };
   const parsedRequest = registerAgentRequestSchema.safeParse(requestCandidate);
@@ -16513,13 +16570,19 @@ function buildRegisterCommandConfig(flags, env, cwd) {
   }
   const apiBaseUrl = readStringFlag(flags, "api-base-url") ?? normalizeOptional3(env.CLAPS_API_URL) ?? normalizeOptional3(env.CLAPS_API_BASE_URL) ?? "http://127.0.0.1:3001";
   const envFileArg = readStringFlag(flags, "env-file");
-  const saveToken = readBooleanFlag(flags, "save-token") ?? (shouldStartDaemonByDefault(flags) || env.CLAPS_SAVE_TOKEN === "1");
+  const saveToken = shouldSaveToken(flags, env);
   return {
     ok: true,
     config: {
       apiBaseUrl: apiBaseUrl.replace(/\/+$/g, ""),
-      envFilePath: envFileArg ? resolve2(cwd, envFileArg) : resolve2(parsedRequest.data.agentHomePath ?? cwd, defaultEnvFileName),
-      request: parsedRequest.data,
+      envFilePath: envFileArg ? resolve2(cwd, envFileArg) : resolve2(
+        resolveDefaultAgentHomePath(parsedRequest.data.externalKey, env) ?? cwd,
+        defaultEnvFileName
+      ),
+      request: {
+        ...parsedRequest.data,
+        agentHomePath: resolveDefaultAgentHomePath(parsedRequest.data.externalKey, env)
+      },
       saveToken
     }
   };
@@ -16577,6 +16640,17 @@ function buildAgentHomeMigrationConfig(flags, cwd) {
     }
   };
 }
+function validateNoAgentHomeOverride(flags) {
+  if (!readStringFlag(flags, "agent-home-path")) {
+    return {
+      ok: true
+    };
+  }
+  return {
+    ok: false,
+    message: "Agent home path is no longer configurable for register/run/daemon commands. CLAPS now uses $HOME/.triclaps-agents/<agent-key> automatically."
+  };
+}
 function buildSessionLoginCommandConfig(flags, env) {
   const requestCandidate = {
     email: readStringFlag(flags, "email") ?? void 0,
@@ -17438,13 +17512,13 @@ function createCliLogger(stdout, stderr) {
   };
 }
 function mergeEnvWithDaemonFlags(env, flags) {
+  const requestedAgentKey = readStringFlag(flags, "external-key") ?? env.CLAPS_AGENT_KEY;
+  const resolvedAgentHomePath = normalizeOptional3(env.CLAPS_AGENT_HOME_PATH) ?? resolveDefaultAgentHomePath(requestedAgentKey, env);
   return {
     ...env,
     ...readStringFlag(flags, "api-base-url") ? { CLAPS_API_BASE_URL: readStringFlag(flags, "api-base-url") ?? env.CLAPS_API_BASE_URL } : {},
-    ...readStringFlag(flags, "external-key") ? { CLAPS_AGENT_KEY: readStringFlag(flags, "external-key") ?? env.CLAPS_AGENT_KEY } : {},
-    ...readStringFlag(flags, "agent-home-path") ? {
-      CLAPS_AGENT_HOME_PATH: readStringFlag(flags, "agent-home-path") ?? env.CLAPS_AGENT_HOME_PATH
-    } : {}
+    ...requestedAgentKey ? { CLAPS_AGENT_KEY: requestedAgentKey } : {},
+    ...resolvedAgentHomePath ? { CLAPS_AGENT_HOME_PATH: resolvedAgentHomePath } : {}
   };
 }
 function validateDaemonLaunchEnv(env) {
@@ -17573,6 +17647,16 @@ async function getBootstrapStatus(config, fetchImpl) {
     return { kind: "unavailable" };
   }
 }
+function shouldSaveToken(flags, env) {
+  const explicit = readBooleanFlag(flags, "save-token");
+  if (explicit !== null) {
+    return explicit;
+  }
+  if (normalizeOptional3(env.CLAPS_SAVE_TOKEN) === "0") {
+    return false;
+  }
+  return true;
+}
 function shouldStartDaemonByDefault(flags) {
   return readBooleanFlag(flags, "start-daemon") !== false;
 }
@@ -17657,8 +17741,9 @@ Unsupported runtime value: ${runtime}` : ""}`
   };
 }
 async function runApiReachabilityCheck(apiBaseUrl, fetchImpl) {
+  const healthUrl = `${apiBaseUrl}/api/health`;
   try {
-    const response = await fetchImpl(`${apiBaseUrl}/health`, {
+    const response = await fetchImpl(healthUrl, {
       method: "GET",
       headers: {
         accept: "application/json"
@@ -17669,14 +17754,14 @@ async function runApiReachabilityCheck(apiBaseUrl, fetchImpl) {
       return {
         name: "API reachability",
         status: "issues",
-        lines: [`GET ${apiBaseUrl}/health returned HTTP ${response.status}.`]
+        lines: [`GET ${healthUrl} returned HTTP ${response.status}.`]
       };
     }
     return {
       name: "API reachability",
       status: payload.status === "ok" ? "ok" : "warning",
       lines: [
-        `GET ${apiBaseUrl}/health returned HTTP ${response.status}.`,
+        `GET ${healthUrl} returned HTTP ${response.status}.`,
         `service: ${payload.service ?? "unknown"}`,
         `status: ${payload.status ?? "unknown"}`
       ]
@@ -17686,7 +17771,7 @@ async function runApiReachabilityCheck(apiBaseUrl, fetchImpl) {
       name: "API reachability",
       status: "issues",
       lines: [
-        `GET ${apiBaseUrl}/health failed: ${error instanceof Error ? error.message : "unknown fetch error"}`
+        `GET ${healthUrl} failed: ${error instanceof Error ? error.message : "unknown fetch error"}`
       ]
     };
   }
@@ -18792,6 +18877,13 @@ function normalizePathLike(value, cwd) {
   }
   return resolve2(cwd, normalized);
 }
+function resolveDefaultAgentHomePath(agentKey, env) {
+  const normalizedAgentKey = normalizeOptional3(agentKey ?? void 0);
+  if (!normalizedAgentKey) {
+    return null;
+  }
+  return resolve2(env.HOME?.trim() || os6.homedir(), ".triclaps-agents", normalizedAgentKey);
+}
 async function loadCliEnvironment(cwd, env, flags) {
   const explicitEnvFile = flags ? readStringFlag(flags, "env-file") : null;
   if (explicitEnvFile) {
@@ -18803,17 +18895,21 @@ async function loadCliEnvironment(cwd, env, flags) {
       ...env
     };
   }
-  const explicitAgentHomePath = normalizePathLike(
-    (flags ? readStringFlag(flags, "agent-home-path") : null) ?? normalizeOptional3(env.CLAPS_AGENT_HOME_PATH),
-    cwd
+  const requestedAgentKey = normalizeOptional3(
+    (flags ? readStringFlag(flags, "external-key") : null) ?? normalizeOptional3(env.CLAPS_AGENT_KEY)
   );
-  if (explicitAgentHomePath) {
+  const explicitAgentHomePath = normalizePathLike(env.CLAPS_AGENT_HOME_PATH, cwd);
+  const defaultAgentHomePath = resolveDefaultAgentHomePath(requestedAgentKey, env);
+  const resolvedAgentHomePath = explicitAgentHomePath ?? defaultAgentHomePath;
+  if (resolvedAgentHomePath) {
     const fileValues = parseEnvFile(
-      await readTextFileIfExists2(resolve2(explicitAgentHomePath, defaultEnvFileName))
+      await readTextFileIfExists2(resolve2(resolvedAgentHomePath, defaultEnvFileName))
     );
     return {
       ...fileValues,
-      ...env
+      ...env,
+      CLAPS_AGENT_HOME_PATH: resolvedAgentHomePath,
+      ...requestedAgentKey ? { CLAPS_AGENT_KEY: requestedAgentKey } : {}
     };
   }
   const primaryEnvFilePath = resolve2(cwd, defaultEnvFileName);
@@ -19167,11 +19263,11 @@ async function buildHelpText(cwd) {
     "  claps-cli project archive --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]",
     "  claps-cli project repo-binding get --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]",
     "  claps-cli project repo-binding set --project-id <project-id> --repo-owner <owner> --repo-name <name> --repo-url <url> [--provider <github|github_enterprise|gitlab|gitlab_selfhost>] [--default-branch <branch>] [--root-path <path>] [--is-monorepo <true|false>] [--auth-type <none|token|oauth|app>] [--json] [--session-token <token>] [--api-base-url <url>]",
-    "  claps-cli run [--api-base-url <url>] [--external-key <key>] [--agent-home-path <path>] [--env-file <path>]",
-    "  claps-cli daemon start [--replace] [--api-base-url <url>] [--external-key <key>] [--agent-home-path <path>] [--env-file <path>]",
-    "  claps-cli daemon stop [--api-base-url <url>] [--external-key <key>] [--agent-home-path <path>] [--env-file <path>]",
-    "  claps-cli daemon status [--api-base-url <url>] [--external-key <key>] [--agent-home-path <path>] [--env-file <path>]",
-    "  claps-cli daemon logs [--lines <count>] [--api-base-url <url>] [--external-key <key>] [--agent-home-path <path>] [--env-file <path>]",
+    "  claps-cli run [--api-base-url <url>] [--external-key <key>] [--env-file <path>]",
+    "  claps-cli daemon start [--replace] [--api-base-url <url>] [--external-key <key>] [--env-file <path>]",
+    "  claps-cli daemon stop [--api-base-url <url>] [--external-key <key>] [--env-file <path>]",
+    "  claps-cli daemon status [--api-base-url <url>] [--external-key <key>] [--env-file <path>]",
+    "  claps-cli daemon logs [--lines <count>] [--api-base-url <url>] [--external-key <key>] [--env-file <path>]",
     "  claps-cli agent-home migrate --agent-home-path <path> [--env-file <legacy-env-file>] [--sync-profile <true|false>]",
     "  claps-cli version",
     "  claps-cli doctor [--runtime <runtime>] [--api-base-url <url>]",
@@ -19198,7 +19294,7 @@ async function buildHelpText(cwd) {
     "  claps-cli skills audit [--check-todo]",
     "  claps-cli skills todo [--write|--check]",
     "  claps-cli skill <name>",
-    "  claps-cli register --api-base-url <url> --org-slug <slug> --runtime <runtime> --external-key <key> --name <name> [--agent-home-path <path>] [--workspace-path <path>] [--capability-summary <text>] [--save-token <true|false>] [--start-daemon <true|false>]",
+    "  claps-cli register --api-base-url <url> --org-slug <slug> --runtime <runtime> --external-key <key> --name <name> [--workspace-path <path>] [--capability-summary <text>] [--save-token <true|false>] [--start-daemon <true|false>]",
     "  claps-cli sync-runtime --runtime <runtime> [--check]",
     "  claps-cli preview expose --app-slug <slug> --port <port> [--name <name>] [--local-host <host>] [--api-base-url <url>]",
     "",
@@ -19243,7 +19339,7 @@ async function buildHelpText(cwd) {
     "Agent home stores CLAPS-local env, session history, and runtime state; workspace path is the file tree the agent edits.",
     "Use `claps-cli agent-home migrate` to move a legacy workspace-root .env.local into a dedicated agent home and leave behind a pointer env.",
     "claps-cli run re-checks managed runtime assets on an interval and repairs drift automatically.",
-    "Register now saves agent env defaults and starts a detached background worker unless you pass `--save-token false` or `--start-daemon false`.",
+    "Register now saves agent env defaults by default. Start the detached worker separately with `claps-cli daemon start`, or opt in during registration with `--start-daemon`.",
     "Use `claps-cli daemon start` for manual detached startup; `claps-cli daemon logs` reads recent worker output without opening the metadata directory.",
     "`claps-cli run` stays in the foreground for debugging."
   ].join("\n");

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@triclaps/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "bin": {
-    "claps-cli": "./index.js"
+    "claps-cli": "index.js"
   },
   "engines": {
     "node": ">=22.0.0"