Skip to main content
Set up a minimal connection and explicitly chosen optional guidance for detected agent clients. The example previews installation. Running without --dry-run writes selected skills and supported client configuration. Review conflicts and the installed version’s help before applying. The npm release verified on October 24, 2026 is 0.6.13. The optional saved-key connection prompt describes current source for 0.6.14 or later; see CLI connection for the release boundary.

​
Example

Prints the installation plan for Codex without writing skills, client configuration or a setup receipt. The plan contains no account credential.

​
Options

  • --client ID (repeatable: claude-code, codex, cursor, gemini-cli, hermes)
  • --scope project (default) or user
  • --origin https URL (default https://app.agentlinkops.com)
  • --pack DIR
  • --skill ID and --recipe ID (repeatable)
  • --all-skills (complete pack, exclusive with named selections)
  • --dry-run
  • --json.

​
Exit status

0 on success; 1 when a conflict was reported; 2 on usage or configuration failure or when no client was detected.
CLI 0.6.10 installs the connection skill and its reference by default. Select optional guidance explicitly. --skill adds named skills; --recipe adds selected versioned recipes, their associated skills, catalog and command notes. --all-skills selects the complete pack and cannot be combined with named selections.A connection-only upgrade retains earlier optional payloads. Detects Claude Code, Codex, Cursor, Gemini CLI and Hermes from their configuration directories (or takes --client), copies selected files with SHA-256 verification (installing only missing files and files this command installed before, never a file it did not write), and writes the MCP server entry for the view that client should use from the client table: Claude Code and Hermes get /mcp/all because they defer large catalogs themselves, the others get the bounded /mcp view.JSON configurations are merged, the Codex TOML gets a table appended when absent, and clients whose configuration this command does not edit (Hermes, and Claude Code at user scope) get the exact snippet or command to run. Records project-scope receipts at .agentlinkops/agent-setup.json and user-scope receipts at ~/.agentlinkops/agent-setup-user.json, including selected recipe versions.Skill and MCP installation stores no credential. Current source, intended for CLI 0.6.14 or later, can also offer an optional CLI connection after interactive setup.Pasting a CLI key there verifies and saves it outside the repository. Dry-run and JSON setup do not offer that prompt.Use the client’s OAuth flow for MCP access. --dry-run prints the plan and writes nothing. Exit 1 when a conflict was left for the person.Inspect the installed version’s help before using selectors; CLI 0.6.9 and earlier can install the complete pack. Native-client acceptance remains separate from package checks.Supplied-link checks do not require this setup, a ledger, CRM or publisher recipe.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.