{
  "schemaVersion": "1",
  "id": "agent-analysis",
  "type": "agent-interface",
  "title": "Agent analysis",
  "url": "https://githubnext.github.io/gh-cao/agent-analysis/",
  "description": "Give an agent the dashboard's own pages and named queries through gh cao or a read-only MCP server, with or without shell access.",
  "source": {
    "repository": "githubnext/gh-cao",
    "path": "docs/agent-analysis.md",
    "url": "https://github.com/githubnext/gh-cao/blob/750c4006623d7ae70dd61946505f50a3f731dd1c/docs/agent-analysis.md"
  },
  "links": [
    {
      "rel": "canonical",
      "href": "https://githubnext.github.io/gh-cao/agent-analysis/"
    },
    {
      "rel": "related",
      "href": "https://githubnext.github.io/gh-cao/dashboard-webmcp/index.json"
    },
    {
      "rel": "related",
      "href": "https://githubnext.github.io/gh-cao/cao-cli/index.json"
    }
  ],
  "provenance": {
    "repository": "githubnext/gh-cao",
    "generator": "starlight-agent",
    "generatorVersion": "1",
    "commit": "750c4006623d7ae70dd61946505f50a3f731dd1c",
    "source": "https://github.com/githubnext/gh-cao/blob/750c4006623d7ae70dd61946505f50a3f731dd1c/docs/agent-analysis.md"
  },
  "freshness": {
    "generatedAt": "2026-10-20T23:47:02.679Z",
    "sourceCommittedAt": "2026-10-19T17:06:01.000Z"
  },
  "integrity": {
    "algorithm": "sha256",
    "sourceDigest": "3095d11b7a22d0247c69d7d16010c2b5fad2edef606a7510659956e4e75f23af"
  },
  "interfaces": {
    "cli": [
      {
        "command": "cao",
        "subcommand": "pages",
        "arguments": {
          "positional": [],
          "options": {
            "--json": true
          }
        },
        "purpose": "Discover agent-facing dashboard pages.",
        "readOnly": true
      },
      {
        "command": "cao",
        "subcommand": "queries",
        "arguments": {
          "positional": [],
          "options": {
            "--json": true
          }
        },
        "purpose": "Discover named dashboard queries.",
        "readOnly": true
      }
    ],
    "mcp": [
      {
        "transport": "cli",
        "server": "cao",
        "capability": "cao_catalog",
        "arguments": {
          "kind": "pages"
        },
        "purpose": "Discover dashboard pages.",
        "readOnly": true
      },
      {
        "transport": "cli",
        "server": "cao",
        "capability": "cao_catalog",
        "arguments": {
          "kind": "queries"
        },
        "purpose": "Discover named dashboard queries.",
        "readOnly": true
      }
    ]
  },
  "recommendedInterface": {
    "default": "cli",
    "alternatives": [
      "cli-mcp"
    ],
    "reason": "Use the CLI with shell access; use CLI MCP when only tool access is available."
  }
}