AgentConfigHub CLI

Pull immutable releases from a self-hosted AgentConfigHub server and install them transactionally into native coding-agent configuration directories.

Requirements

• Node.js 24 or newer
• An AgentConfigHub server
• A browser-approved device token or a pull-only automation token

Login

npx --yes agent-config-hub@latest login \
  --server https://agent-config-hub.example.com \
  --name "$(hostname)"

Open the verification URL printed by the CLI and approve the displayed user code in the server's Devices page.

Pull a release

List available configuration groups:

npx --yes agent-config-hub@latest config-sets

Preview changes before writing files:

npx --yes agent-config-hub@latest pull \
  --profile main \
  --agent omp \
  --dry-run

Install the latest immutable release:

npx --yes agent-config-hub@latest pull \
  --profile main \
  --agent omp

The adapter supplies each Agent's default destination. Override a root for one invocation when needed:

npx --yes agent-config-hub@latest pull \
  --profile main \
  --agent omp \
  --target-root "omp-home=$HOME/.omp/agent"

Inspect the installed state:

npx --yes agent-config-hub@latest status --profile main

Automation

Keep pull tokens out of command arguments:

export AGENT_CONFIG_HUB_SERVER='https://agent-config-hub.example.com'
export AGENT_CONFIG_HUB_TOKEN='agch_auto_...'
npx --yes agent-config-hub@latest pull --profile main --agent omp

Safety model

The CLI validates the immutable manifest, streams and hashes downloads, stages replacements on the destination filesystem, backs up overwritten and deleted managed files, rejects unsafe links, and commits through a crash-recoverable journal. It refuses to delete locally modified managed files unless --force-remove-modified is explicitly supplied.

Commands:

agent-config-hub login --server <url> [--name <device>]
agent-config-hub logout
agent-config-hub config-sets
agent-config-hub pull --profile <slug> [--agent <id>...] [--dry-run]
  [--target-root <root>=<path>] [--replace-symlink] [--force-remove-modified]
agent-config-hub status --profile <slug>
agent-config-hub backups list|restore <id>|delete <id>
agent-config-hub roots list|set <root-id> <absolute-path>|reset <root-id>

Server deployment and architecture documentation: AgentConfigHub.