Skip to content

docs: document always-on az and gh built-in CLIs in README - #1814

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/readme-builtin-clis-92193-17e2bfd4ee23795c
Draft

docs: document always-on az and gh built-in CLIs in README#1814
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/readme-builtin-clis-92193-17e2bfd4ee23795c

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Documented the two "always available" CLI binaries (az and gh) that the agent's bash tool can use without any tools: opt-in — this is a core capability (host-detection + auto-mounting + auth wiring) that was already covered in docs/tools.md and the site's tools.mdx, but was completely absent from README.md, which is the first place human evaluators look for "what can the agent do out of the box."

Changes

  • README.md: added a new "Built-in CLIs (always available)" subsection under MCP Servers, right before "Custom MCP Servers", summarizing:
    • az — runtime detection/mounting behavior, the advisory-prompt gating, and the two auth paths (az devops * auto-authenticated vs. general az/ARM/Graph needing explicit az login), with a pointer to docs/tools.md#azure-cli-az for full detail.
    • gh — shares the same read-only GITHUB_TOKEN as the GitHub MCP integration.

Accuracy checks

  • All claims (network allowlist additions, /usr/bin/az + /opt/az detection, AW_AZ_MOUNTS variable, conditional advisory prompt gated on AW_AZ_MOUNTS, az devops * auto-auth via permissions.read, gh sharing the MCP GITHUB_TOKEN) were verified against docs/tools.md (the existing agent-facing reference for this feature, out of scope to edit here) and the site's tools.mdx, which already documents this identically.

Validation

  • README re-read for valid Markdown, working links (docs/tools.md#azure-cli-az), and consistent formatting with the surrounding section.

Created by the docs-writer workflow.

Generated by Docs Writer · aut00 · 60.2 AIC · ⌖ 12 AIC · ⊞ 11.6K ·

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
2 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions github-actions Bot mentioned this pull request Aug 5, 2026
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.

0 participants