@skrr-ai/cli 0.1.113 → 0.1.114

package/bin/update-npm-runner.cjs

@@ -3,9 +3,11 @@
 // Park before npm executes. The parent publishes this process group's durable
 // mutation ownership before authorizing execution, closing its crash window.
 const fs = require('node:fs');
+const path = require('node:path');
 const { spawn } = require('node:child_process');
 const requestFile = process.argv[2];
 const request = JSON.parse(fs.readFileSync(requestFile, 'utf8'));
+if (request.npmPrefix != null && !path.isAbsolute(request.npmPrefix)) throw new Error('Invalid npm prefix');
 const deadline = Date.now() + 30000;
 const timer = setInterval(() => {
   let authorization;
@@ -16,7 +18,8 @@ const timer = setInterval(() => {
   }
   if (authorization?.pid === process.pid && authorization?.token === request.token) {
     clearInterval(timer);
-    const child = spawn(request.npmPath, ['install', '-g', `@skrr-ai/cli@${request.version}`], {
+    const prefixArgs = request.npmPrefix ? ['--prefix', request.npmPrefix] : [];
+    const child = spawn(request.npmPath, ['install', '-g', ...prefixArgs, `@skrr-ai/cli@${request.version}`], {
       stdio: 'inherit',
       shell: process.platform === 'win32',
     });

package/bin/update-worker.cjs

@@ -41,7 +41,8 @@ async function run(directory, options = {}) {
     if (
       !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(attempt.version) ||
       !path.isAbsolute(attempt.packageRoot) ||
-      !path.isAbsolute(attempt.npmPath)
+      !path.isAbsolute(attempt.npmPath) ||
+      (attempt.npmPrefix != null && !path.isAbsolute(attempt.npmPrefix))
     ) {
       throw new Error('Invalid persisted CLI update request');
     }
@@ -86,7 +87,8 @@ async function run(directory, options = {}) {
       });
       return;
     }
-    const rootResult = await execFileAsync(attempt.npmPath, ['root', '-g'], {
+    const prefixArgs = attempt.npmPrefix ? ['--prefix', attempt.npmPrefix] : [];
+    const rootResult = await execFileAsync(attempt.npmPath, ['root', '-g', ...prefixArgs], {
       timeout: 1500,
       maxBuffer: 64 * 1024,
       shell: process.platform === 'win32',
@@ -117,7 +119,8 @@ async function run(directory, options = {}) {
     await new Promise((resolve, reject) => {
       const requestFile = path.join(directory, `runner-${crypto.randomUUID()}.json`);
       const token = crypto.randomUUID();
-      runtime.writeJson(requestFile, { token, npmPath: attempt.npmPath, version: attempt.version });
+      runtime.writeJson(requestFile, { token, npmPath: attempt.npmPath, version: attempt.version,
+        ...(attempt.npmPrefix ? { npmPrefix: attempt.npmPrefix } : {}) });
       const child = spawn(
         process.execPath,
         [path.join(__dirname, 'update-npm-runner.cjs'), requestFile],

package/dist/commands/followups/remind.js

@@ -12,7 +12,7 @@ const agent_resolver_1 = require("../../lib/agent-resolver");
  * needs an agent context the passive form does not.
  */
 class FollowupsRemind extends base_command_1.BaseCommand {
-    static description = 'Remind the owner at a time — the reminder follow-up';
+    static description = 'Remind the owner at a time. By default, deliver the literal content through owner notifications without an agent turn. Use --active for agent-written delivery.';
     static examples = [
         '<%= config.bin %> followups remind --subject task:OSK-42 --content "pick the deploy up" --in 2h',
         '<%= config.bin %> followups remind --subject conversation:conv_9 --content "ask how the move went" --at 2026-09-20T09:00:00Z --active --agent agent_1',
@@ -34,15 +34,23 @@ class FollowupsRemind extends base_command_1.BaseCommand {
             description: 'Wake the agent to word the reminder (needs an agent context)',
             default: false,
         }),
-        agent: core_1.Flags.string({ description: 'Agent ID (default: bound session agent)' }),
-        endpoint: core_1.Flags.string({ description: 'Delivery endpoint id (EndpointRegistry)' }),
-        'endpoint-target': core_1.Flags.string({ description: 'Channel target for channel endpoints' }),
-        pin: core_1.Flags.string({ description: 'Conversation id the reminder was authored in' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (default: bound session agent). Attribution only unless --active is set' }),
+        endpoint: core_1.Flags.string({ description: 'Active only: delivery endpoint id; requires --active' }),
+        'endpoint-target': core_1.Flags.string({ description: 'Active only: channel target for a channel endpoint; requires --active' }),
+        pin: core_1.Flags.string({ description: 'Active only: deliver into this conversation; requires --active. Do not combine with --endpoint other than pinned' }),
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
     };
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(FollowupsRemind);
+        if (!flags.active && (flags.endpoint || flags['endpoint-target'] || flags.pin)) {
+            this.failWithCliError({
+                message: '--endpoint, --endpoint-target and --pin require --active. For a passive reminder, remove these flags; the literal content is delivered through owner notifications without an agent turn. --agent alone records attribution.',
+                code: 'FOLLOWUP_INVALID_ENDPOINT',
+                exit: 2,
+                retryable: false,
+            });
+        }
         const at = flags.at ?? flags.in;
         if (!at) {
             this.failWithCliError({

package/dist/commands/followups/watch.js

@@ -83,9 +83,9 @@ class FollowupsWatch extends base_command_1.BaseCommand {
             description: 'SLA backstop — required for --wait event (an event may never arrive), optional for poll_until',
         }),
         // delivery
-        endpoint: core_1.Flags.string({ description: 'Delivery endpoint id (EndpointRegistry)' }),
+        endpoint: core_1.Flags.string({ description: 'Delivery endpoint id (defaults to main). Use --pin to deliver into a specific conversation' }),
         'endpoint-target': core_1.Flags.string({ description: 'Channel target for channel endpoints' }),
-        pin: core_1.Flags.string({ description: 'Conversation id the watch was authored in' }),
+        pin: core_1.Flags.string({ description: 'Deliver into this conversation. Do not combine with --endpoint other than pinned' }),
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
     };
     async run() {

package/dist/lib/update-check.d.ts

@@ -1,4 +1,9 @@
 export type CliInstallKind = 'npm-global' | 'npm-local' | 'dev' | 'bundled' | 'image' | 'homebrew' | 'other';
+export interface CliInstallDescriptor {
+    kind: CliInstallKind;
+    writable?: boolean;
+    npmPrefix?: string;
+}
 export interface CliUpdateAttempt {
     status: 'queued' | 'running' | 'succeeded' | 'failed';
     version: string;
@@ -10,6 +15,7 @@ export interface CliUpdateAttempt {
     message?: string;
     packageRoot?: string;
     npmPath?: string;
+    npmPrefix?: string;
     coordinationVersion?: number;
     workerPid?: number;
     interrupted?: boolean;
@@ -19,10 +25,7 @@ export interface CheckCache {
     latest: string | null;
     npmPackage: string | null;
     baseURL: string;
-    install?: {
-        kind: CliInstallKind;
-        writable?: boolean;
-    };
+    install?: CliInstallDescriptor;
     packageRoot?: string;
     npmGlobalRoot?: string | null;
     autoUpdate?: {
@@ -45,6 +48,7 @@ export interface CliUpdateStatus {
     installedVersion: string | null;
     offeredVersion: string | null;
     owner: CliInstallKind;
+    npmPrefix?: string;
     state: 'up-to-date' | 'update-available' | 'pending' | 'restart-pending' | 'failed' | 'managed' | 'unknown' | 'check-failed';
     autoUpdateAllowed: boolean;
     autoUpdateReason: string | null;
@@ -76,12 +80,9 @@ export declare function resolveCliPackageDir(argv?: readonly string[]): string |
  * dir beside `dist` exists only in a checkout — published packages ship
  * `dist` and no `src`.
  */
-export declare function classifyCliInstall(env: NodeJS.ProcessEnv, argv: readonly string[], npmGlobalRoot: string | null, probeWritable?: boolean): {
-    kind: CliInstallKind;
-    writable?: boolean;
-};
-export declare function cliUpdateCommand(owner: CliInstallKind): string;
-export declare function buildNudgeLine(currentVersion: string, latest: string | null, _npmPackage: string | null, installKind?: CliInstallKind): string | null;
+export declare function classifyCliInstall(env: NodeJS.ProcessEnv, argv: readonly string[], npmGlobalRoot: string | null, probeWritable?: boolean): CliInstallDescriptor;
+export declare function cliUpdateCommand(owner: CliInstallKind, npmPrefix?: string): string;
+export declare function buildNudgeLine(currentVersion: string, latest: string | null, _npmPackage: string | null, installKind?: CliInstallKind, npmPrefix?: string): string | null;
 export type CliUpdateAction = {
     type: 'nudge';
     line: string;

package/dist/lib/update-check.js

@@ -207,6 +207,20 @@ function classifyCliInstall(env, argv, npmGlobalRoot, probeWritable = true) {
         return { kind: 'other' };
     }
     const nodeModulesDir = path.dirname(path.dirname(packageDir)); // …/node_modules
+    const npmPrefix = process.platform !== 'win32' && path.basename(path.dirname(nodeModulesDir)) === 'lib'
+        ? path.dirname(path.dirname(nodeModulesDir)) : undefined;
+    // npm's current default may differ from the prefix that installed this
+    // executable. A project directory named `lib` is insufficient evidence:
+    // the prefix's public bin must resolve to this exact installed entry.
+    let linkedGlobalPrefix = false;
+    if (npmPrefix) {
+        try {
+            linkedGlobalPrefix = !fs.existsSync(path.join(npmPrefix, 'package.json')) &&
+                fs.realpathSync(path.join(npmPrefix, 'bin', 'skrr')) ===
+                    fs.realpathSync(path.join(packageDir, 'bin', 'run.js'));
+        }
+        catch { /* no executable ownership proof */ }
+    }
     if (npmGlobalRoot) {
         let resolvedGlobal = npmGlobalRoot;
         try {
@@ -222,15 +236,13 @@ function classifyCliInstall(env, argv, npmGlobalRoot, probeWritable = true) {
         catch {
             /* compare the raw form */
         }
-        if (resolvedNodeModules !== resolvedGlobal)
+        if (resolvedNodeModules !== resolvedGlobal && !linkedGlobalPrefix)
             return { kind: 'npm-local' };
     }
-    else if (!/[/\\](lib|npm)[/\\]node_modules$/.test(nodeModulesDir)) {
+    else if (!linkedGlobalPrefix) {
         // `npm root -g` gave no answer, so prove the global shape from the path
-        // instead: npm's unix global root is always `<prefix>/lib/node_modules`
-        // (incl. nvm/volta) and on Windows `%APPDATA%\npm\node_modules`. A
-        // project-local `<project>/node_modules` never matches either — without
-        // proof we must not treat it as ours to auto-update.
+        // and matching public executable instead. Without ownership proof we
+        // must not treat a project's dependency as ours to auto-update.
         return { kind: 'npm-local' };
     }
     let writable = false;
@@ -245,7 +257,7 @@ function classifyCliInstall(env, argv, npmGlobalRoot, probeWritable = true) {
             /* read-only */
         }
     }
-    return { kind: 'npm-global', writable };
+    return { kind: 'npm-global', writable, ...(npmPrefix ? { npmPrefix } : {}) };
 }
 /**
  * Resolve `npm root -g` for install classification. Runs ONLY inside the
@@ -269,12 +281,14 @@ async function resolveNpmGlobalRoot(env = process.env) {
         return null;
     }
 }
-function cliUpdateCommand(owner) {
+function cliUpdateCommand(owner, npmPrefix) {
     switch (owner) {
         case 'npm-global':
-            return `npm install -g ${CLI_PACKAGE}@latest`;
+            return npmPrefix
+                ? `npm install --global --prefix '${npmPrefix.replace(/'/g, "'\\''")}' ${CLI_PACKAGE}@latest`
+                : `npm install -g ${CLI_PACKAGE}@latest`;
         case 'npm-local':
-            return `npm update ${CLI_PACKAGE}`;
+            return `Use npm in the project that owns ${CLI_PACKAGE}`;
         case 'dev':
             return 'npm --prefix cli run build';
         case 'bundled':
@@ -287,16 +301,18 @@ function cliUpdateCommand(owner) {
             return 'Update via your install method — see https://skrr.ai';
     }
 }
-function buildNudgeLine(currentVersion, latest, _npmPackage, installKind = 'npm-global') {
+function buildNudgeLine(currentVersion, latest, _npmPackage, installKind = 'npm-global', npmPrefix) {
     if (!latest || !isOlderVersion(currentVersion, latest))
         return null;
-    const command = installKind === 'npm-global' ? `npm update -g ${CLI_PACKAGE}` : cliUpdateCommand(installKind);
-    const context = installKind === 'npm-local'
-        ? ' in the owning project'
-        : installKind === 'dev'
-            ? ' to rebuild your checkout'
-            : '';
-    return `[skrr] Update available: ${currentVersion} → ${latest}. Run \`${command}\`${context}. Silence with OVERSKY_NO_UPDATE_NUDGE=1.\n`;
+    const command = installKind === 'npm-global' && !npmPrefix
+        ? `npm update -g ${CLI_PACKAGE}` : cliUpdateCommand(installKind, npmPrefix);
+    const context = installKind === 'dev'
+        ? ' to rebuild your checkout'
+        : '';
+    const advice = installKind === 'npm-local'
+        ? `Update ${CLI_PACKAGE} using the project that owns ${CLI_PACKAGE}.`
+        : `Run \`${command}\`${context}.`;
+    return `[skrr] Update available: ${currentVersion} → ${latest}. ${advice} Silence with OVERSKY_NO_UPDATE_NUDGE=1.\n`;
 }
 function decideCliUpdateAction(args) {
     const { currentVersion, cache, env, isTTY } = args;
@@ -327,10 +343,10 @@ function decideCliUpdateAction(args) {
         if (attempt?.status === 'failed')
             return {
                 type: 'nudge',
-                line: `[skrr] CLI update to ${cache.latest} failed. Inspect \`skrr update --status\` or run \`${cliUpdateCommand(install.kind)}\`.\n`,
+                line: `[skrr] CLI update to ${cache.latest} failed. Inspect \`skrr update --status\` or run \`${cliUpdateCommand(install.kind, install.npmPrefix)}\`.\n`,
             };
     }
-    const line = buildNudgeLine(currentVersion, cache.latest, CLI_PACKAGE, install.kind);
+    const line = buildNudgeLine(currentVersion, cache.latest, CLI_PACKAGE, install.kind, install.npmPrefix);
     return line ? { type: 'nudge', line } : null;
 }
 function readCache(env = process.env) {
@@ -462,10 +478,11 @@ function readCliUpdateStatus(opts) {
         installedVersion,
         offeredVersion,
         owner: install.kind,
+        ...(install.npmPrefix ? { npmPrefix: install.npmPrefix } : {}),
         state,
         autoUpdateAllowed: autoUpdateReason === null,
         autoUpdateReason,
-        command: cliUpdateCommand(install.kind),
+        command: cliUpdateCommand(install.kind, install.npmPrefix),
         lastCheckAt: matchingCache?.lastCheckAt ?? null,
         lastAttempt,
         logPath: path.join(directory, 'update.log'),
@@ -591,7 +608,7 @@ async function performCliUpdate(opts) {
         env.SKRR_CLI_UPDATE_SESSION_UNAVAILABLE === '1') {
         return {
             ...status,
-            message: `This CLI is owned by ${install.kind}${install.kind === 'npm-global' ? ' in a shared or external prefix' : ''}. ${cliUpdateCommand(install.kind)}.`,
+            message: `This CLI is owned by ${install.kind}${install.kind === 'npm-global' ? ' in a shared or external prefix' : ''}. ${cliUpdateCommand(install.kind, install.npmPrefix)}.`,
         };
     }
     const recoverableAttempt = status.lastAttempt && ['queued', 'running'].includes(status.lastAttempt.status);
@@ -620,6 +637,7 @@ async function performCliUpdate(opts) {
                 attemptedAt: Date.now(),
                 packageRoot: packageRoot(argv),
                 npmPath,
+                ...(install.npmPrefix ? { npmPrefix: install.npmPrefix } : {}),
                 coordinationVersion: api.COORDINATION_VERSION,
                 message: 'Waiting for active CLI sessions to exit; the next invocation uses the new version.',
             });
@@ -649,7 +667,7 @@ async function maybeWarnOutdatedCli(opts) {
             currentVersion: opts.currentVersion,
             cache: {
                 ...cache,
-                install: { kind: status.owner, writable: status.autoUpdateAllowed },
+                install: { kind: status.owner, writable: status.autoUpdateAllowed, npmPrefix: status.npmPrefix },
                 autoUpdate: status.lastAttempt
                     ? {
                         attemptedAt: status.lastAttempt.attemptedAt,

package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/firstPartyHarness.d.ts

@@ -2,7 +2,7 @@
  * The first-party harness identity — the ONLY place its product name is written.
  *
  * "First-party harness" is the harness provider this platform builds, signs,
- * distributes and installs itself: today a fork of OpenCode sold as skrr Code.
+ * distributes and installs itself: today a fork of OpenCode sold as Skrr Code.
  * It is a different axis from trust Tier 1 in `harnessTrust.ts`, whose
  * "first-party" means an audited VENDOR harness such as Claude Code.
  *
@@ -68,7 +68,7 @@
  * both bundles at a distance.
  */
 export interface FirstPartyHarnessIdentity {
-    /** What a person reads. Lowercase brand inside a compound (naming map §1). */
+    /** What a person reads, with the product's proper-name capitalization. */
     readonly displayName: string;
     /** The command a person types, as it appears in prose. */
     readonly command: string;
@@ -93,7 +93,7 @@ export interface FirstPartyHarnessIdentity {
  * release or a stored value written before the rename is looked for.
  */
 declare const IDENTITY: {
-    readonly displayName: "skrr Code";
+    readonly displayName: "Skrr Code";
     readonly command: "skrr code";
     readonly provider: "skrr-code";
     readonly aliases: readonly [];

package/dist/node_modules/@skrr-ai/auth-core/dist/cjs/firstPartyHarness.js

@@ -3,7 +3,7 @@
  * The first-party harness identity — the ONLY place its product name is written.
  *
  * "First-party harness" is the harness provider this platform builds, signs,
- * distributes and installs itself: today a fork of OpenCode sold as skrr Code.
+ * distributes and installs itself: today a fork of OpenCode sold as Skrr Code.
  * It is a different axis from trust Tier 1 in `harnessTrust.ts`, whose
  * "first-party" means an audited VENDOR harness such as Claude Code.
  *
@@ -138,7 +138,7 @@ const PROVIDER = 'skrr-code';
  * release or a stored value written before the rename is looked for.
  */
 const IDENTITY = {
-    displayName: 'skrr Code',
+    displayName: 'Skrr Code',
     command: 'skrr code',
     provider: PROVIDER,
     aliases: [],

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/firstPartyHarness.d.ts

@@ -2,7 +2,7 @@
  * The first-party harness identity — the ONLY place its product name is written.
  *
  * "First-party harness" is the harness provider this platform builds, signs,
- * distributes and installs itself: today a fork of OpenCode sold as skrr Code.
+ * distributes and installs itself: today a fork of OpenCode sold as Skrr Code.
  * It is a different axis from trust Tier 1 in `harnessTrust.ts`, whose
  * "first-party" means an audited VENDOR harness such as Claude Code.
  *
@@ -68,7 +68,7 @@
  * both bundles at a distance.
  */
 export interface FirstPartyHarnessIdentity {
-    /** What a person reads. Lowercase brand inside a compound (naming map §1). */
+    /** What a person reads, with the product's proper-name capitalization. */
     readonly displayName: string;
     /** The command a person types, as it appears in prose. */
     readonly command: string;
@@ -93,7 +93,7 @@ export interface FirstPartyHarnessIdentity {
  * release or a stored value written before the rename is looked for.
  */
 declare const IDENTITY: {
-    readonly displayName: "skrr Code";
+    readonly displayName: "Skrr Code";
     readonly command: "skrr code";
     readonly provider: "skrr-code";
     readonly aliases: readonly [];

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/firstPartyHarness.js

@@ -2,7 +2,7 @@
  * The first-party harness identity — the ONLY place its product name is written.
  *
  * "First-party harness" is the harness provider this platform builds, signs,
- * distributes and installs itself: today a fork of OpenCode sold as skrr Code.
+ * distributes and installs itself: today a fork of OpenCode sold as Skrr Code.
  * It is a different axis from trust Tier 1 in `harnessTrust.ts`, whose
  * "first-party" means an audited VENDOR harness such as Claude Code.
  *
@@ -103,7 +103,7 @@ const PROVIDER = 'skrr-code';
  * release or a stored value written before the rename is looked for.
  */
 const IDENTITY = {
-    displayName: 'skrr Code',
+    displayName: 'Skrr Code',
     command: 'skrr code',
     provider: PROVIDER,
     aliases: [],

package/oclif.manifest.json

@@ -23343,7 +23343,7 @@
       "aliases": [],
       "args": {
         "state": {
-          "description": "Whether personal stored balance may pay for skrr Code overage",
+          "description": "Whether personal stored balance may pay for Skrr Code overage",
           "name": "state",
           "options": [
             "enabled",
@@ -23352,7 +23352,7 @@
           "required": true
         }
       },
-      "description": "Enable or disable personal skrr Code overage after included allowance is exhausted",
+      "description": "Enable or disable personal Skrr Code overage after included allowance is exhausted",
       "examples": [
         "<%= config.bin %> balance overage enabled",
         "<%= config.bin %> balance overage disabled",
@@ -23420,7 +23420,7 @@
     "balance:plan": {
       "aliases": [],
       "args": {},
-      "description": "Show your skrr Code plan, renewal state, available tiers, and the matching lifecycle page",
+      "description": "Show your Skrr Code plan, renewal state, available tiers, and the matching lifecycle page",
       "examples": [
         "<%= config.bin %> balance plan",
         "<%= config.bin %> balance plan --json"
@@ -23720,7 +23720,7 @@
     "balance:usage:breakdown": {
       "aliases": [],
       "args": {},
-      "description": "Aggregate settled skrr Code usage by model, surface, agent and member",
+      "description": "Aggregate settled Skrr Code usage by model, surface, agent and member",
       "examples": [
         "<%= config.bin %> balance usage breakdown",
         "<%= config.bin %> balance usage breakdown --json",
@@ -23812,7 +23812,7 @@
     "balance:usage:events": {
       "aliases": [],
       "args": {},
-      "description": "List the skrr Code charges and run/session attribution behind aggregate allowance usage",
+      "description": "List the Skrr Code charges and run/session attribution behind aggregate allowance usage",
       "examples": [
         "<%= config.bin %> balance usage events",
         "<%= config.bin %> balance usage events --limit 20 --json",
@@ -26995,7 +26995,7 @@
       "pluginName": "@skrr-ai/cli",
       "pluginType": "core",
       "strict": false,
-      "summary": "Start the skrr Code interactive coding agent in this directory",
+      "summary": "Start the Skrr Code interactive coding agent in this directory",
       "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
@@ -27008,7 +27008,7 @@
     "code:acp": {
       "aliases": [],
       "args": {},
-      "description": "Run the skrr Code ACP server over stdio (used by the skrr daemon)",
+      "description": "Run the Skrr Code ACP server over stdio (used by the skrr daemon)",
       "examples": [
         "<%= config.bin %> code acp"
       ],
@@ -27032,7 +27032,7 @@
     "code:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose the local skrr Code engine, config sources, and trust posture",
+      "description": "Diagnose the local Skrr Code engine, config sources, and trust posture",
       "examples": [
         "<%= config.bin %> code doctor",
         "<%= config.bin %> code doctor --json"
@@ -27194,7 +27194,7 @@
     "code:install": {
       "aliases": [],
       "args": {},
-      "description": "Install the local skrr Code signed release; use --daemon to install on another machine",
+      "description": "Install the local Skrr Code signed release; use --daemon to install on another machine",
       "examples": [
         "<%= config.bin %> code install",
         "<%= config.bin %> code install --daemon <daemon-id>",
@@ -27743,7 +27743,7 @@
           ]
         }
       },
-      "description": "Migrate an existing OpenCode configuration into skrr Code",
+      "description": "Migrate an existing OpenCode configuration into Skrr Code",
       "examples": [
         "<%= config.bin %> code migrate opencode",
         "<%= config.bin %> code migrate opencode --apply",
@@ -27760,7 +27760,7 @@
           "dependsOn": [
             "apply"
           ],
-          "description": "Replace existing skrr Code files, moving each aside to a timestamped .bak first",
+          "description": "Replace existing Skrr Code files, moving each aside to a timestamped .bak first",
           "name": "overwrite",
           "allowNo": false,
           "type": "boolean"
@@ -27798,7 +27798,7 @@
     "code:rollback": {
       "aliases": [],
       "args": {},
-      "description": "Restore the previous verified local skrr Code release",
+      "description": "Restore the previous verified local Skrr Code release",
       "flags": {
         "json": {
           "description": "Emit the result as JSON",
@@ -27826,7 +27826,7 @@
     "code:run": {
       "aliases": [],
       "args": {},
-      "description": "Run skrr Code headlessly on a single prompt",
+      "description": "Run Skrr Code headlessly on a single prompt",
       "examples": [
         "<%= config.bin %> code run \"add a regression test for the parser\"",
         "<%= config.bin %> code run --json \"summarize the diff\"",
@@ -27853,7 +27853,7 @@
     "code:skrr-agent": {
       "aliases": [],
       "args": {},
-      "description": "Show or set the skrr agent a managed skrr Code session is attributed to",
+      "description": "Show or set the skrr agent a managed Skrr Code session is attributed to",
       "examples": [
         "<%= config.bin %> code skrr-agent",
         "<%= config.bin %> code skrr-agent --set Engineer",
@@ -27931,7 +27931,7 @@
     "code:update": {
       "aliases": [],
       "args": {},
-      "description": "Check or update the local skrr Code signed release; use --daemon to update another machine",
+      "description": "Check or update the local Skrr Code signed release; use --daemon to update another machine",
       "examples": [
         "<%= config.bin %> code update",
         "<%= config.bin %> code update --check",
@@ -46066,7 +46066,7 @@
     "followups:remind": {
       "aliases": [],
       "args": {},
-      "description": "Remind the owner at a time — the reminder follow-up",
+      "description": "Remind the owner at a time. By default, deliver the literal content through owner notifications without an agent turn. Use --active for agent-written delivery.",
       "examples": [
         "<%= config.bin %> followups remind --subject task:OSK-42 --content \"pick the deploy up\" --in 2h",
         "<%= config.bin %> followups remind --subject conversation:conv_9 --content \"ask how the move went\" --at 2026-09-20T09:00:00Z --active --agent agent_1",
@@ -46156,28 +46156,28 @@
           "type": "boolean"
         },
         "agent": {
-          "description": "Agent ID (default: bound session agent)",
+          "description": "Agent ID (default: bound session agent). Attribution only unless --active is set",
           "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "endpoint": {
-          "description": "Delivery endpoint id (EndpointRegistry)",
+          "description": "Active only: delivery endpoint id; requires --active",
           "name": "endpoint",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "endpoint-target": {
-          "description": "Channel target for channel endpoints",
+          "description": "Active only: channel target for a channel endpoint; requires --active",
           "name": "endpoint-target",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "pin": {
-          "description": "Conversation id the reminder was authored in",
+          "description": "Active only: deliver into this conversation; requires --active. Do not combine with --endpoint other than pinned",
           "name": "pin",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -46687,7 +46687,7 @@
           "type": "option"
         },
         "endpoint": {
-          "description": "Delivery endpoint id (EndpointRegistry)",
+          "description": "Delivery endpoint id (defaults to main). Use --pin to deliver into a specific conversation",
           "name": "endpoint",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -46701,7 +46701,7 @@
           "type": "option"
         },
         "pin": {
-          "description": "Conversation id the watch was authored in",
+          "description": "Deliver into this conversation. Do not combine with --endpoint other than pinned",
           "name": "pin",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -137226,5 +137226,5 @@
       ]
     }
   },
-  "version": "0.1.113"
+  "version": "0.1.114"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/cli",
-  "version": "0.1.113",
+  "version": "0.1.114",
   "description": "Command-line interface for skrr",
   "license": "ISC",
   "author": "skrr",