Config schema — ~/.agentproto/config.json

agentproto config show
agentproto config get adapters
agentproto config set daemon.port 18791

{
  // Runtime adapters loaded by `agentproto run-swarm`. Each entry is an
  // npm package id resolvable from the cli's install location OR the
  // user's cwd. Loaded in array order; last write wins on duplicate
  // adapter kinds.
  "adapters": [
    "@guilde/agentproto-bridge",
    "@acme/agentproto-slack"
  ],

  // Slug → package-name aliases for `agentproto install
  // runtime-profile/<slug>`. Without an alias, the verb defaults to
  // `@agentproto/runtime-profile-<slug>`.
  "profileAliases": {
    "guilde": "@guilde/runtime-profile-guilde"
  },

  // npm packages the `corpus` CLI scans for AIP-10 starter presets.
  // Each must declare `package.json#agentproto-corpus-preset` matching
  // the agentproto/corpus-preset/v1 schema. Defaults to just
  // ["@agentproto/corpus-presets"] when omitted.
  "corpusPresetPackages": [
    "@agentproto/corpus-presets",
    "@vendor/corpus-presets"
  ],

  // Daemon-mode options. Read by `agentproto daemon` and
  // `agentproto serve` when launched without explicit flags.
  "daemon": {
    "port": 18791,
    "bind": "127.0.0.1",
    "allowedOrigins": [
      "https://guilde.work"
    ],
    "turnStallAfterMs": 300000
  },

  // End-to-end pairing over an untrusted rendezvous broker. Read by
  // `agentproto serve` / `pair offer`. See concepts/pairing.md.
  "pairing": {
    // Rendezvous broker WS URL used by `pair offer` and by autoconnect on
    // boot. Mirrors tunnel.host. Three states:
    //   - absent  → offers fall back to the hosted default,
    //               wss://rdv.agentproto.sh/v1 (the broker relays only
    //               ciphertext — see concepts/pairing.md).
    //   - a URL   → route through that broker (self-hosted or otherwise).
    //   - ""      → explicit opt-out: no default, `pair offer` requires
    //               an explicit --rendezvous.
    "rendezvous": "wss://rendezvous.example/v1",
    // Whether the daemon opens standing rendezvous connections for every
    // persisted pairing on boot (so a paired client can reconnect anytime).
    // Mirrors tunnel.autoconnect. Default true when a rendezvous is set.
    "autoconnect": true,
    // Web pair page for `pair offer --qr` (the offer rides in its URL
    // fragment). A template with {fp} in the HOSTNAME (the daemon
    // fingerprint) for one browser origin per daemon, or a plain http(s) URL
    // (one shared origin). Absent → https://{fp}.agentproto.cloud/pair.
    // `--pair-page` overrides it.
    // See concepts/pairing.md ("The phone pair page").
    "pairPage": "https://{fp}.pair.example.com/pair"
  },

  // Global and per-adapter defaults auto-applied to every `agent_start`
  // spawn (CLI, MCP, or HTTP). See "defaults" below.
  "defaults": {
    "skills": ["review-checklist"],
    "options": { "verbose": true },
    "adapters": {
      "hermes": {
        "skills": ["hermes-only-skill"],
        "options": { "model": "z-ai/glm-5.2" },
        "auth": { "mode": "api-key" }
      }
    },
    "defaultRoleDepthCutoff": 1,
    "maxGrantableDelegation": 2,
    "langfuseTracing": false,
    "traceRedactor": "secrets"
  },

  // Generic ACP agents — any CLI that speaks the Agent Client Protocol,
  // connectable with zero adapter code. Keyed by adapter slug; shadows a
  // curated ACP_CATALOG entry of the same slug. Managed via
  // `agentproto acp add|ls|rm`. See "acpAgents" below.
  "acpAgents": {
    "my-agent": {
      "bin": "my-agent",
      "bin_args": ["acp"],
      "resumable": true,
      "install_hint": "npm i -g my-agent"
    }
  },

  // Where `agentproto worktree new` creates worktrees + whether the daemon
  // isolates spawned agents into one. See "worktrees" below.
  "worktrees": {
    "root": "~/.agentproto/worktrees",
    "isolation": "on-request",
    "provisionConcurrency": 2,
    "provisionConcurrencyByRepo": { "~/code/big-monorepo": 1 },
    "provisionLoadFactor": 0
  },

  // Spawn-time policy for `agent_start` (dedupe, attach). See "spawn" below.
  "spawn": {
    "dedupe": "always",
    "attach": "always"
  },

  // Provenance policy — the opt-in `gh` PATH shim. See "provenance" below.
  "provenance": {
    "wrapGh": false
  },

  // Named terminal/TUI launch presets for `agentproto sessions terminal
  // --preset <name>`. See "terminalPresets" below.
  "terminalPresets": {
    "terra": { "argv": ["bash", "-l"], "env": { "TERM": "xterm-256color" } }
  },

  // Session-presence + transcript-storage policy. See "sessions" below.
  "sessions": {
    "attentionDelaySec": 60,
    "eventsDir": "~/.agentproto/sessions"
  },

  // Feature toggles. See "features" below.
  "features": {
    "pty": true,
    "llmEndpoint": false
  },

  // Model-role overrides — which model each built-in job uses.
  // Each key is a dotted role name; the value is a model id string or
  // { model, route?, profile? }. See "models" below.
  "models": {
    "review.small": "claude-sonnet-5-5",
    "review.large": "claude-opus-5-5",
    "review.pr": "openrouter/z-ai/glm-5.3-flash",
    "judge.session": "claude-sonnet-5-5"
  },

  // Jev (TypeSafe System One) judge configuration for the session steward.
  // See "jev" below.
  "jev": {
    "apiKey": "...",
    "model": "jev-latest",
    "baseUrl": "https://api.typesafe.ai/v1/systemone"
  }
}

# Without alias:
agentproto install runtime-profile/guilde \
  --package @guilde/runtime-profile-guilde

# With alias above:
agentproto install runtime-profile/guilde

agentproto config set models.review.small claude-haiku-5
agentproto config set models.judge.session claude-opus-5-5

{
  "activeProfile": "prod",
  "profiles": {
    "prod": {
      "tunnel": { "host": "wss://tunnel.example/connect", "token": "apt_…" },
      "daemon": { "port": 18791 }
    }
  }
}