Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript
15.5 KB
Raw Blame
{
  "golden": [
    {
      "argv": "takes list",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "takes extract",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain takes` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain takes extract",
        "Why: takes list/search/scorecard/calibration + add/update/resolve/supersede route to the brain host automatically (takes_* MCP ops). This subcommand (extract/revisit) is host-bound: run it on the host machine.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "takes add alice-example",
      "exitCode": 1,
      "stderr": [
        "Error [invalid_params]: Missing --claim.",
        "Fix: takes add needs --claim \"...\" --kind fact|take|bet|hunch --who HOLDER: gbrain takes add alice-example --claim \"...\" --kind fact|take|bet|hunch --who HOLDER."
      ],
      "stdout": []
    },
    {
      "argv": "cache stats",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "cache clear",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain cache` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain cache clear",
        "Why: `cache stats` routes to the brain host automatically (cache_stats MCP op). clear/prune mutate the host cache — run those on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "quarantine list",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "quarantine scan",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain quarantine` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain quarantine scan",
        "Why: `quarantine list` routes to the brain host automatically (quarantine_list MCP op). scan/clear are host-bound (bulk re-import; the clear trust decision) — run those on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "jobs list",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "jobs get 1",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "jobs stats",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "jobs work",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain jobs` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain jobs work",
        "Why: `jobs list`, `jobs get <id>`, and `jobs stats` are thin-client routable; this subcommand runs against the host queue. Use the submit_job / list_jobs / get_job / get_job_stats MCP tools from your agent, or run on the host with GBRAIN_HOME set.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "search modes",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "search diagnose q",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain search` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain search diagnose",
        "Why: `search modes|stats|tune` route to the brain host automatically (search_modes / search_stats / search_tune MCP ops). The modes reset form, modes with the source flag (the reset dry-run), and tune apply mutate or preview host config, and `diagnose` runs live retrieval — run those on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "sources list",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain sources` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain sources list",
        "Why: sources commands manage local DB + config rows. Per-subcommand thin-client routing lands in v0.31.x. For now: use `sources_list` / `sources_status` MCP tools, or run on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "sources add alice-example",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain sources` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain sources add",
        "Why: sources commands manage local DB + config rows. Per-subcommand thin-client routing lands in v0.31.x. For now: use `sources_list` / `sources_status` MCP tools, or run on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "capture hello",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: Retry the same operation and arguments with request_id <uuid>; do not generate a replacement ID.",
        "Request: <uuid>"
      ],
      "stdout": []
    },
    {
      "argv": "forget fact-1",
      "exitCode": 1,
      "stderr": [
        "Usage: gbrain forget <fact-id> [--reason <text>] [--source <id>] [--request-id <uuid>] [--json]"
      ],
      "stdout": []
    },
    {
      "argv": "call get_page",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain call` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain call",
        "Why: `call` dispatches against a local engine. Use the named CLI command or an authorized MCP tool through your agent, or run `gbrain call` on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "agent register alice-example",
      "exitCode": 1,
      "stderr": [
        "Error: `gbrain agent register` mints credentials into the HOST brain — run it on the brain host (the machine that runs `gbrain serve --http`), then wire this machine with the printed `gbrain init --mcp-only …` block."
      ],
      "stdout": []
    },
    {
      "argv": "eval whoknows",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain eval` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain eval whoknows",
        "Why: `eval` export/prune/replay touch the local engine and have no MCP equivalents. Run `gbrain eval` on the host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "doctor",
      "exitCode": 1,
      "stderr": [
        "[gbrain] reading doctor checks; large brains can take minutes. Progress prints here every 10 s; the result prints on stdout when it is ready."
      ],
      "stdout": [
        "",
        "GBrain Health Check (thin-client)",
        "=================================",
        "Mode:        thin-client",
        "Issuer URL:  http://127.0.0.1:1",
        "MCP URL:     http://127.0.0.1:1/mcp",
        "Client ID:   cid",
        "",
        "  [✓] config_integrity: mcp_url=http://127.0.0.1:1/mcp, issuer_url=http://127.0.0.1:1",
        "  [✓] oauth_credentials: client_id=cid, secret_source=config",
        "  [✗] oauth_discovery: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "",
        "Connectivity check FAILED — see error above.",
        "Common fixes:",
        "  - Confirm the host is reachable + `gbrain serve --http` is running.",
        "  - Confirm OAuth credentials are valid (have the host operator re-mint via `gbrain auth register-client`).",
        "  - Confirm `mcp_url` matches the path the host serves /mcp on (default: <issuer_url>/mcp)."
      ]
    },
    {
      "argv": "think q",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "recall q",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "query q",
      "exitCode": 1,
      "stderr": [
        "Cannot reach http://127.0.0.1:1/mcp. Run `gbrain remote doctor` for details."
      ],
      "stdout": []
    },
    {
      "argv": "get alice-example",
      "exitCode": 1,
      "stderr": [
        "Cannot reach http://127.0.0.1:1/mcp. Run `gbrain remote doctor` for details."
      ],
      "stdout": []
    },
    {
      "argv": "wakeshift watch job 1",
      "exitCode": 1,
      "stderr": [
        "Error [unavailable]: OAuth discovery failed: OAuth discovery network error: ECONNREFUSED: Unable to connect. Is the computer able to access the url?",
        "Fix: gbrain remote doctor",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unavailable"
      ],
      "stdout": []
    },
    {
      "argv": "wakeshift status",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain wakeshift` is not routable (thin-client of http://127.0.0.1:1/mcp); run it on the brain host.",
        "Fix: gbrain wakeshift status",
        "Why: `wakeshift watch job|write|cron` and `wakeshift accept-terms` route to the brain host automatically (watch_job / watch_write_request / watch_cron / accept_wakeshift_terms MCP tools). enable, disable, status and test read or change the brain host's Wakeshift key and settings: run those on the brain host.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "serve --http",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain serve --http` is not routable (thin-client of http://127.0.0.1:1/mcp): it serves a brain over HTTP, so it runs on the brain host.",
        "Fix: gbrain serve --http",
        "Why: HTTP serving hosts the brain database, which lives on the brain host; a thin client has none to serve.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "serve --http --port 3131",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain serve --http --port 3131` is not routable (thin-client of http://127.0.0.1:1/mcp): it serves a brain over HTTP, so it runs on the brain host.",
        "Fix: gbrain serve --http --port 3131",
        "Why: HTTP serving hosts the brain database, which lives on the brain host; a thin client has none to serve.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "serve --access read-only",
      "exitCode": 1,
      "stderr": [
        "Error [requires_local_engine]: `gbrain serve --access read-only` is not routable (thin-client of http://127.0.0.1:1/mcp): it asks this bridge to enforce a restriction, and a thin client cannot enforce one locally.",
        "Fix: gbrain auth register-client '<name>' --grant-types client_credentials --scopes read",
        "Why: The brain host enforces what each client may do; a filter in this process would be advice, not a boundary.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#requires_local_engine"
      ],
      "stdout": []
    },
    {
      "argv": "serve --surface Starter",
      "exitCode": 2,
      "stderr": [
        "Error [invalid_params]: --surface must be one of verbs|starter|full; got 'Starter'.",
        "Fix: Pass one of verbs|starter|full, e.g. --surface verbs.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#invalid_params"
      ],
      "stdout": []
    },
    {
      "argv": "serve --advertise=bogus",
      "exitCode": 2,
      "stderr": [
        "Error [invalid_params]: --advertise must be one of verbs|starter|full; got 'bogus'.",
        "Fix: Pass one of verbs|starter|full, e.g. --advertise verbs.",
        "Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#invalid_params"
      ],
      "stdout": []
    }
  ],
  "normalizer": "cli-thin-client-v1"
}