@notis_ai/cli 0.2.18 → 0.2.20

package/skills/notis-spaces/cli.md

@@ -0,0 +1,540 @@
+# Notis CLI: Space Development Workflow
+
+When running outside the Notis container, use the `notis` CLI to build Notis Spaces locally. Space views are
+Vite + React source using `@notis/sdk`. The product `notis-spaces` skill and its release guide own the workflow;
+this file lists the commands generated from the CLI's own help.
+
+Create and edit requests authorize delivery to the installed Space after checks; explicit read-only, preview-only
+or no-deploy requests stop at local artifacts without remote mutation. Store publication requires separate approval.
+
+## Core workflow
+
+1. `spaces pull` the exact existing Space (source, resource list, Skill folders and lock file), or `spaces init`
+   a new collection view.
+2. `spaces build` and `spaces verify` the selected source with fictional fixtures.
+3. `spaces deploy`, or `spaces preview` then `spaces promote`, within the user's authorization. Changed Skill
+   folders and resource links commit with the source release.
+4. Read back the published revision, then `views find` and `views render` its live view link.
+
+## Reports and HTML
+
+Interactive reports are independent Space views. Save self-contained HTML pages and reports in Notis Notes with its Save HTML Skill; pages and reports saved before Spaces open there too. See the canonical product guidance for build, revision, native file and view-link rules.
+
+## Commands
+
+### `npx --package @notis_ai/cli@latest -- notis doctor`
+
+Run a quick CLI health check for config, auth, and API reachability.
+
+When to use: Use this before relying on the CLI in automation or after changing environments.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis doctor`
+- `npx --package @notis_ai/cli@latest -- notis doctor --json`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history list <space-id>`
+
+Read a Space’s saved view versions, newest first.
+
+When to use: Inspect when and by whom a view changed, before restoring or undoing a change.
+
+Options:
+- `--before <revision>` — Read versions before this cursor.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history list <space-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history restore <space-id>`
+
+Republish a saved view and its settings as a new version; records stay unchanged.
+
+When to use: Restore a chosen version, or undo your last change using the version immediately before it.
+
+Options:
+- `--target-revision <revision>` — The saved version to restore.
+- `--revision <revision>` — Current Space metadata revision from history list.
+- `--request-id <id>` — Stable restore request ID; reuse on retry.
+- `--dry-run` — Check current access, bindings and saved source without publishing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history restore <space-id> --target-revision 2 --revision 5 --request-id undo-last-change --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history read <space-id>`
+
+Read the files of one saved Space version.
+
+When to use: See exactly what a saved version contained, before comparing or restoring it. Editors only.
+
+Options:
+- `--revision <revision>` — The saved version from history list.
+- `--path <path>` — Read only this file or folder.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history read <space-id> --revision 3 --path app/page.tsx`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history diff <space-id>`
+
+Compare two saved Space versions, or one with the current version.
+
+When to use: See what changed between versions. Prints the unified diff; pass --json for the full comparison.
+
+Options:
+- `--from <revision>` — The older saved version.
+- `--to <revision>` — The newer saved version, or current (default).
+- `--path <path>` — Compare only this file or folder.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history diff <space-id> --from 3`
+- `npx --package @notis_ai/cli@latest -- notis spaces history diff <space-id> --from 3 --to 5 --json`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history name <space-id>`
+
+Name a saved Space version, or clear its name.
+
+When to use: Mark a version worth keeping, such as a launch. Named versions are kept past the usual retention.
+
+Options:
+- `--revision <revision>` — The saved version from history list.
+- `--name <name>` — The version name.
+- `--clear` — Remove the version name.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history name <space-id> --revision 3 --name "Launch"`
+- `npx --package @notis_ai/cli@latest -- notis spaces history name <space-id> --revision 3 --clear`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces history delete <space-id>`
+
+Delete one saved Space version for good.
+
+When to use: Only when the user asked to delete this version. It cannot be restored afterwards.
+
+Options:
+- `--revision <revision>` — The saved version from history list.
+- `--yes` — Confirm the user asked to delete this version for good.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces history delete <space-id> --revision 3 --yes`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces screenshot <url>`
+
+Capture a full-height PNG of a live view with your current access.
+
+When to use: Check the actual deployed view; writes are blocked and current access is checked again before any output is saved.
+
+Options:
+- `--width <pixels>` — 1440 (default) or 390.
+- `--output-dir <path>` — New output directory; defaults to a unique .notis/renders directory. Existing files are never overwritten.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces screenshot <view-link> --width 390`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces init <name> [dir]`
+
+Scaffold an editable collection view with first-party record components.
+
+When to use: Start a local Space collection source for an existing linked database. Does not create or deploy remote resources.
+
+Options:
+- `--database-key <key>` — Portable key of the database this Space links.
+- `--path <path>` — Descriptive view path; defaults to records.
+- `--title-property <id>` — Canonical title/number property ID, or the title column (default).
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces init Notes ./notes --database-key notes --path notes`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces navigation bind <space-id>`
+
+Bind a named destination for the next source publication without granting target access.
+
+When to use: Connect a portable navigation alias to an existing Space or exact record before building and publishing.
+
+Options:
+- `--alias <name>` — Declared portable navigation alias.
+- `--target <json>` — Exact {space_id,document_id?}, or null to remove the draft binding.
+- `--revision <number>` — Current source Space metadata revision.
+- `--dry-run` — Check current source/target access and revision without changing anything.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces navigation bind <space-id> --alias history --target '{"space_id":"<history-id>"}' --revision 2 --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces resources name <space-id> <binding-id>`
+
+Give an included resource a portable alias before the first source revision.
+
+When to use: Prepare staged resources for source authoring without replacing their IDs, scope or owners.
+
+Options:
+- `--alias <name>` — Stable lowercase alias to use in source.
+- `--revision <number>` — Current Space metadata revision.
+- `--dry-run` — Check naming, current access and revision without changing metadata.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces resources name <space-id> <binding-id> --alias weekly-report --revision 0 --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces links list <space-id>`
+
+List the databases, Skills, automations and records linked into one Space.
+
+When to use: Find a link binding and its revision before removing it, including a link left behind by a deleted Skill.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces links list <space-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces links remove <space-id> <binding-id>`
+
+Remove one database, Skill or automation link from a Space by its binding.
+
+When to use: Unlist a resource from a Space you edit, including a link whose Skill was deleted. The resource keeps its ID; removing the last available link of a live resource keeps it as its owner's standalone resource.
+
+Options:
+- `--revision <number>` — Current binding revision from spaces links list.
+- `--request-id <key>` — Stable intent key; reuse it unchanged when retrying this removal.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces links remove <space-id> <binding-id> --revision 1 --request-id remove-link-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces aliases list`
+
+List the old App page links you manage and the Space each one opens.
+
+When to use: Find an old App page link that opens a binned Space (trashed: true) before repointing it.
+
+Options:
+- `--legacy-id <id>` — Old App ID the links belong to.
+- `--kind <kind>` — app (default), report or html.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces aliases list --legacy-id <app-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces aliases repoint`
+
+Point one old App page link at a live Space you edit.
+
+When to use: Repair an old App page link whose Space was binned. You must own the old App or edit the Space the link opens now, and edit the new Space; everyone who opens the link still needs their own access to it.
+
+Options:
+- `--legacy-id <id>` — Old App ID the link belongs to.
+- `--route <slug>` — Old App page route from spaces aliases list.
+- `--space <space-id>` — Live Space the old link should open.
+- `--expected-space <space-id>` — Space the link opens now; the change is refused if it moved since you listed it.
+- `--selection-param <name>` — Declared view parameter that receives the old page selection, if any.
+- `--request-id <key>` — Stable intent key; reuse it unchanged when retrying this change.
+- `--dry-run` — Check authority and the new Space without changing the link.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces aliases repoint --legacy-id <app-id> --route pages --space <space-id> --expected-space <binned-space-id> --request-id repoint-pages --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces pull <space-id> [dir]`
+
+Pull one editable Space source snapshot, its resource list and its Skill folders into an empty directory.
+
+When to use: Edit a Space you can administer: the source, its links (resources.json) and every editable linked Skill (skills/<alias>/) arrive together, with a local lock file so a later deploy sends only what you changed.
+
+Options:
+- `--revision <number>` — Exact published source revision; defaults to the current one.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces pull <space-id> ./space-source`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces verify [dir]`
+
+Render one frozen Space with offline fixtures and validate its current action authorizations.
+
+When to use: Check immutable build bytes and authoring compatibility without executing actions or publishing.
+
+Options:
+- `--space <key>` — Exact source key from the workspace index.
+- `--space-id <id>` — Exact existing destination Space.
+- `--reuse-grants <json>` — Explicit action-key to saved-grant-ID map. Otherwise your own connections are used.
+- `--reuse-grants-only` — Never authorize new actions. Reuse only the supplied saved grants; other declarations remain unavailable. Requires existing bound databases.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces verify . --space overview --space-id <space-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces preview [dir]`
+
+Seal a checked unpublished revision of the same Space and return its authenticated preview link.
+
+When to use: Review a checked candidate using current Editor access without changing live source or cloning the Space.
+
+Options:
+- `--space <key>` — Exact source key from the workspace index.
+- `--space-id <id>` — Exact existing destination Space.
+- `--reuse-grants <json>` — Explicit action-key to saved-grant-ID map. Otherwise your own connections are used.
+- `--reuse-grants-only` — Never authorize new actions. Reuse only the supplied saved grants; other declarations remain unavailable. Requires existing bound databases.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Validate without uploading or publishing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces preview . --space overview --space-id <space-id> --request-id release-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces deploy [dir]`
+
+Publish one built Space with a retry-safe, independent source revision.
+
+When to use: Update only the selected existing Space; this does not publish to the Store or change siblings.
+
+Options:
+- `--space <key>` — Exact source key from the workspace index.
+- `--space-id <id>` — Exact existing destination Space.
+- `--reuse-grants <json>` — Explicit action-key to saved-grant-ID map. Otherwise your own connections are used.
+- `--reuse-grants-only` — Never authorize new actions. Reuse only the supplied saved grants; other declarations remain unavailable. Requires existing bound databases.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Validate without uploading or publishing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces deploy . --space overview --space-id <space-id> --request-id release-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces promote <release-id> [dir]`
+
+Publish the exact sealed Space revision, with its pending Skill and link changes, after current permission and concurrency checks.
+
+When to use: Finish a reviewed preview without rebuilding or substituting a different candidate. The Skill edits, new Skills and list changes the preview carried go live in the same transaction.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces promote <release-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces abandon <release-id>`
+
+Close an unpublished Space preview without changing its live source, Skills or links, or deleting action history.
+
+When to use: Stop using a candidate while preserving live source and completed effects.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces abandon <release-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces list`
+
+List Spaces currently available to your account.
+
+When to use: Discover accessible Spaces without exposing an issuer-wide resource catalogue.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces list`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces get <space-id>`
+
+Read one accessible Space and its scoped resources.
+
+When to use: Inspect the current published revision and named capabilities before executing.
+
+Options:
+- `--record <record-key>` — Fixed record context, when this is a record-scoped Space.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces get <space-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces action <space-id> <action-id>`
+
+Execute a declared action using its saved authorization.
+
+When to use: Use Space capabilities as the actual actor, with the saved issuer connection and payer.
+
+Options:
+- `--revision <number>` — Exact published source revision.
+- `--preview-release <id>` — Exact sealed candidate ID; requires current Editor access.
+- `--schema-revision <number>` — Native schema revision; required for native row writes.
+- `--inputs <json>` — Declared action input values; defaults to {}.
+- `--record <record-key>` — Fixed record context, when this is a record-scoped Space.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Validate current access and action inputs without executing or billing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces action <space-id> refresh --revision 1 --inputs '{}' --request-id refresh-1 --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces viewer-read <space-id> <operation>`
+
+Run one declared viewer read as yourself.
+
+When to use: Check what an explorer Space shows you: the databases or Skills you can open, with your own access and never an issuer grant.
+
+Options:
+- `--revision <number>` — Exact published source revision.
+- `--preview-release <id>` — Exact sealed candidate ID; requires current Editor access.
+- `--input <json>` — Read input, e.g. {"database_id":"<id>"}; defaults to {}.
+- `--record <record-key>` — Fixed record context, when this is a record-scoped Space.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces viewer-read <space-id> list_databases --revision 3`
+- `npx --package @notis_ai/cli@latest -- notis spaces viewer-read <space-id> query_database --revision 3 --input '{"database_id":"<id>","request":{"page_size":20}}'`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces grants list <space-id>`
+
+Inspect authorization records for a Space you can edit.
+
+When to use: Inspect issuers and exact constraints without exposing connection secrets.
+
+Options:
+- `--record <record-key>` — Fixed record context, when this is a record-scoped Space.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces grants list <space-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces grants create <space-id>`
+
+Authorize an exact template using your current connection.
+
+When to use: Create a Space-bound authorization; the server resolves the signed-in issuer connection.
+
+Options:
+- `--template <file>` — Canonical action template JSON file.
+- `--record <record-key>` — Fixed record context, when this is a record-scoped Space.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Validate the template and Editor access without creating a grant.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces grants create <space-id> --template action.json --request-id grant-1 --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces grants revoke <grant-id>`
+
+Revoke one saved Space authorization.
+
+When to use: Stop future dispatches for an authorization you issued or can administer.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces grants revoke <grant-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store list`
+
+List Space Store listings you can see.
+
+When to use: Find Space templates published to your team or approved for everyone, and your own listings.
+
+Options:
+- `--channel <team|public>` — Only one channel.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store list --channel team`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store get <listing-id>`
+
+Read one Store listing with its versions and your installs.
+
+When to use: Check what a listing contains, its review state and whether your copies have an update.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store get <listing-id>`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store installs`
+
+List the Spaces you installed from the Store.
+
+When to use: See which installed copies have an update or conflicts to resolve.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store installs`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store publish <space-id>`
+
+Publish a Space and its sub-Spaces as the next Store version.
+
+When to use: Share a Space you own as an installable template: team listings publish at once, public ones wait for review. Notis runs the same safety scan and Owner check as the submission page and explains any refusal.
+
+Options:
+- `--channel <team|public>` — Where to publish.
+- `--metadata <json>` — Listing name, tagline, description, category, icon, accent.
+- `--starter <json>` — Starter row IDs per database ({"<database-id>":["<record-key>"]}).
+- `--notes <text>` — Release notes for this version.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Show the package counts and review diff without publishing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store publish <space-id> --channel team --request-id publish-1 --dry-run`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store install <listing-id>`
+
+Install a Store listing as your own independent copy.
+
+When to use: Add a published Space template to your account; your copy keeps your changes on later updates.
+
+Options:
+- `--name <name>` — Name of the installed top Space.
+- `--parent <space-id>` — Install under one of your Spaces.
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Show what the copy contains without installing.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store install <listing-id> --request-id install-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store update <install-id>`
+
+Update an installed copy, keeping your changes, or resolve its conflicts.
+
+When to use: Take a newer Store version: unchanged parts update, your edits stay, and parts both sides changed become conflicts you resolve.
+
+Options:
+- `--resolve <json>` — Per conflict key: "keep_mine" or "take_theirs".
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+- `--dry-run` — Show the three-way plan without changing anything.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store update <install-id> --request-id update-1 --dry-run`
+- `npx --package @notis_ai/cli@latest -- notis spaces store update <install-id> --resolve '{"skill:<key>":"keep_mine"}' --request-id resolve-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces store unpublish <listing-id>`
+
+Stop new installs of a Store listing.
+
+When to use: Withdraw a listing: existing copies keep working and a version waiting for review is withdrawn.
+
+Options:
+- `--request-id <key>` — Stable intent key. Reuse after timeouts or lost replies.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces store unpublish <listing-id> --request-id unpublish-1`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces build [dir]`
+
+Build one independent Space and save its frozen source/artifact snapshot.
+
+When to use: Prepare a selected Space for verification without publishing it or changing siblings.
+
+Options:
+- `--space <key>` — Exact source key from the workspace Space index.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces build . --space overview`
+
+### `npx --package @notis_ai/cli@latest -- notis spaces inspect [dir]`
+
+Inspect one local Space definition and its declared capabilities.
+
+When to use: Read the selected source definition without loading sibling definitions or account resources.
+
+Options:
+- `--space <key>` — Exact source key from the workspace Space index.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis spaces inspect . --space overview`
+
+### `npx --package @notis_ai/cli@latest -- notis views find`
+
+Find the views you can open for a record, database, view link, Space or search.
+
+When to use: Get fresh view-qualified links and declared URL parameters before citing or opening a view.
+
+Options:
+- `--record-key <id>` — Find views that show this exact native record.
+- `--database-id <id>` — Find views over this database.
+- `--url <url>` — Resolve this view link and its current parameters.
+- `--space-id <id>` — Describe this Space view.
+- `--query <text>` — Search accessible view names, descriptions and readable context.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis views find --record-key <record-key>`
+- `npx --package @notis_ai/cli@latest -- notis views find --url <view-link>`
+- `npx --package @notis_ai/cli@latest -- notis views find --query inbox`
+
+### `npx --package @notis_ai/cli@latest -- notis views render <url>`
+
+Render a live view as Markdown and a full-height PNG with your current access.
+
+When to use: Check the actual deployed view; writes are blocked and current access is checked again before any output is saved.
+
+Options:
+- `--outputs <kinds>` — Comma-separated markdown,screenshot (default both).
+- `--width <pixels>` — 1440 (default) or 390.
+- `--output-dir <path>` — New output directory; defaults to a unique .notis/renders directory. Existing files are never overwritten.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis views render <view-link> --outputs markdown,screenshot`

package/src/cli.js

@@ -10,6 +10,7 @@ import { reportCliCommand } from './runtime/telemetry.js';
 import { reconcileBaseSkillsBestEffort } from './runtime/base-skills.js';
 import { detectedAgentIds } from './runtime/agent-setup.js';
 import { withSkillSyncLock } from './runtime/sync-skills.js';
+import { maybeInstallSkillSyncService } from './runtime/skill-sync-service.js';
 import {
   CHANNEL_SWITCH_ENV,
   resolveChannelSwitch,
@@ -81,15 +82,10 @@ function ensureParentCommand(program, parentMap, parentPath) {
 
 function buildRuntime(globalOptions, spec) {
   const localBackendTypes = new Set(['local', 'local_config', 'local_registry']);
-  const commandName = spec.command_path.join(' ');
-  const liveAppHarness = (
-    commandName === 'apps verify' || commandName === 'apps screenshot'
-  ) && globalOptions.mode === 'live';
   const runtime = resolveRuntimeProfile(globalOptions, {
     requireAuth: spec.require_auth !== false,
     allowUnknownProfile: spec.allow_unknown_profile === true,
-    allowUnavailableWorktree:
-      localBackendTypes.has(spec.backend_call?.type) && !liveAppHarness,
+    allowUnavailableWorktree: localBackendTypes.has(spec.backend_call?.type),
   });
   // A stopped local-only worktree may keep executing commands whose backend is
   // entirely local, but it must not carry a shared live credential into those
@@ -188,6 +184,9 @@ function attachSpec(program, parentMap, spec, specs, launchContext = {}) {
         ...launchContext,
       });
       process.exitCode = typeof exitCode === 'number' ? exitCode : 0;
+      if (process.exitCode === 0 && !['logout', 'agent-context', 'agent-capture'].includes(spec.command_path[0])) {
+        await maybeInstallSkillSyncService(runtime).catch(() => undefined);
+      }
       await reportCliCommand({
         spec,
         runtime,
@@ -219,7 +218,7 @@ export function createProgram(launchContext = {}) {
 
   program
     .name('notis')
-    .description('Agent-first Notis CLI for apps and generic tool execution')
+    .description('Agent-first Notis CLI for Spaces and generic tool execution')
     .version(CLI_VERSION)
     .showHelpAfterError()
     .option('--json', 'Shortcut for --output json')
@@ -233,8 +232,9 @@ export function createProgram(launchContext = {}) {
     // `notis profile use`, pinning all commands to the default profile.
     .option('--profile <name>', 'CLI profile to run as (defaults to the active profile)')
     .option('--api-base <url>', 'Override the API base URL for this invocation')
-    .option('--timeout-ms <n>', 'HTTP timeout in milliseconds')
+    .option('--timeout-ms <n>', 'Time limit in milliseconds for each call, automatic retries included')
     .option('--idempotency-key <key>', 'Override the generated idempotency key for mutating commands')
+    .option('--no-retry', 'Turn off automatic retries of interrupted calls that are safe to repeat (or set NOTIS_NO_RETRY=1)')
     .addOption(new Option('--notis-managed-agent-hook').hideHelp());
 
   const parentMap = new Map([['', program]]);