Skip to content

Promote the HTTP Archive agent plugin on the home page and docs - #1380

Merged
max-ostapenko merged 5 commits into
mainfrom
ai-agent-plugin
Oct 23, 2026
Merged

max-ostapenko merged 5 commits into
mainfrom
ai-agent-plugin

Conversation

@max-ostapenko

@max-ostapenko max-ostapenko commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Promotes the new HTTP Archive agent plugin for Claude Code and Codex: BigQuery skills plus the Tech Report MCP server at https://cdn.httparchive.org/mcp.

Changes:

  • New guide docs/guides/ai-agents: install for Claude Code, Codex and other agents; adding only the MCP server; tables of MCP tools and skills; requirements, including a cost caution suggesting a BigQuery custom quota; example prompts. Added to the Guides sidebar.
  • Docs home: "Use with AI Agents" card under Guides & Tutorials.
  • Home page: new "AI Agents · Agents Plugin" section after the BigQuery section, with a terminal-style panel of install commands in place of an illustration (hidden on phones, like the other illustrations), plus buttons to the guide and the GitHub repo.
  • CSS: reusable .terminal, .terminal-comment and .terminal-prompt styles in styles.css.
  • Per-page Markdown: adds starlight-md-txt 0.2.0, so every docs page is also served as Markdown at its URL plus .md (for example /docs/guides/minimizing-costs.md), following the llms.txt convention. absoluteLinks: true makes those files work outside the site: links to other docs pages point to their .md files, other links and images (/_astro/…) are absolute https://httparchive.org URLs. No 404.md is generated, and no <link rel="alternate"> tags are added. Firebase already serves .md as text/markdown, so firebase.json is unchanged.
  • Guide requirements: the BigQuery skills now need only bq; docs are read with the agent's built-in web fetch instead of gh and curl.

Generated files (config/last_updated.json, public/sitemap.xml) are left to the usual generation PRs.

Checked locally: npm run build passes, all internal links are valid, and htmlhint reports no errors on the changed pages.

Related

@tunetheweb tunetheweb left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM with two suggestions to consider. Think we should definitely do the “consider” -> “strongly recommend” suggestion but more open to the the “caution” -> “danger” one.

max-ostapenko and others added 3 commits October 23, 2026 22:42
Co-authored-by: Barry Pollard <barry_pollard@hotmail.com>
Co-authored-by: Barry Pollard <barry_pollard@hotmail.com>
@max-ostapenko

Copy link
Copy Markdown
Contributor Author

Not seeing the parent GCP project for queries still gives me a cold sweat, so I'd say 'danger' for sure.

@max-ostapenko
max-ostapenko merged commit e355682 into main Oct 23, 2026
5 of 6 checks passed
@max-ostapenko
max-ostapenko deleted the ai-agent-plugin branch October 23, 2026 22:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants