docs: condense CLI reference page to true reference format

[Copilot]

CLI reference page was bloated with tutorials, usage patterns, and troubleshooting that belong elsewhere. Users couldn't quickly find specific options.

Changes

• Added Options Summary table — scannable overview of all 15 CLI options with types, defaults, descriptions
• Streamlined Options Details — brief descriptions with minimal examples, no tutorials
• Added Exit Codes table — quick reference for return values
• Added See Also links — points to quickstart, usage guide, troubleshooting for detailed content
• Removed redundant sections — Basic Examples, Command Argument tips, Common Usage Patterns, Troubleshooting, Environment Variables details (all exist in other docs)

~720 lines → ~148 lines (80% reduction)

Screenshot

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro dev (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro preview (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Condense the CLI reference page to be like a real "reference" page, remove common usage patterns, troubleshooting and others, and people should easily find the reference of exact CLI comand or args.

Custom agent used: technical-doc-writer
AI technical documentation writer for awf library using Astro Starlight

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.