[docs-agent] Add Agent Wallets page to Build with AI section

[JackReacher0807]

Summary

New conceptual page at /docs/agent-wallets that gives a high-level explanation of Alchemy's agent wallets and how they're used in the Alchemy CLI, drawing from the launch blog post and pairing it with the existing CLI command reference.

The page covers:

• What agent wallets are — a Privy-custodied wallet that the user approves a CLI session against from the Alchemy Dashboard, with the wallet's private key never touching the CLI, the agent, or .env.
• Why they replace the old defaults — pasted private keys with full unrestricted access, or custom backends rebuilding auth/signing/revocation logic.
• How it works — the three-party trust model (you / Alchemy / Privy), the on-device P-256 keypair the CLI generates, the two-step signing challenge, and one-click revocation through the dashboard.
• What the agent can do — alchemy evm send, swap, bridge, contract call, approve, all backed by the Wallet APIs so gas sponsorship, batching, retries, and ERC-20 gas payments come along automatically.
• Quickstart — the three-command setup from the blog (npm i, alchemy auth, alchemy wallet connect), plus an example evm send and how to revoke.
• Why it works for coding agents — --json / --no-interactive flags and alchemy agent-prompt so the agent picks up the wallet commands without integration work.

The page links into the CLI doc's #wallets-and-signing section for the full command reference rather than duplicating it, so the two pages have clean roles: agent-wallets is the conceptual intro, alchemy-cli is the command surface.

Changes

• New file: content/tutorials/build-with-ai/agent-wallets.mdx (slug docs/agent-wallets)
• content/docs.yml: sidebar entry added under Build with AI, immediately after Alchemy CLI — pairs the conceptual page with the CLI reference and keeps related content adjacent

Linear

DOCS-76 — Add "Agent Wallets" page to Build with AI section

Requested by

@CodesMcCabe (via Slack thread)

[github-actions]

🔗 Preview Mode

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	May 8, 2026, 9:08 PM

[github-actions]

🔍 Link Check

Status: ❌ Failed

Summary

Status	Count
🔍 Total	8063
✅ Successful	6928
⏳ Timeouts	0
🔀 Redirected	450
👻 Excluded	676
❓ Unknown	0
🚫 Errors	8
⛔ Unsupported	1

Broken links (8) — click to expand

Errors per input

Errors in ./content/api-reference/data/webhooks/custom-webhooks-quickstart/custom-webhooks-quickstart.mdx

• [404] https://replit.com/@AlLuken/ETH-USDC-Custom-Webhook#index.js | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/wallets/wallet-integrations/privy/jwt-auth-migration.mdx

• [404] https://docs.privy.io/wallets/using-wallets/ethereum/create-a-wallet | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

• [404] https://docs.base.org/onchainkit/fund/get-onramp-buy-url | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/tutorials/smart-wallets/learn-account-abstraction/introduction-to-account-abstraction.mdx

• [403] https://www.investopedia.com/terms/k/knowyourclient.asp | Rejected status code: 403 Forbidden (configurable with "accept" option)
• [403] https://www.investopedia.com/terms/a/aml.asp | Rejected status code: 403 Forbidden (configurable with "accept" option)

Errors in ./content/wallets/wallet-integrations/privy/signer-migration-overview.mdx

• [403] https://privy.io/slack | Rejected status code: 403 Forbidden (configurable with "accept" option)

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

• [429] https://docs.arbitrum.io/welcome/arbitrum-gentle-introduction#arbitrum-nova | Rejected status code: 429 Too Many Requests (configurable with "accept" option)

Errors in ./content/api-reference/starknet/starknet-api-faq.mdx

• [ERR] https://www.starknetjs.com/ | Network error: SSL certificate error. Check certificate validity (error sending request for url (https://www.starknetjs.com/))

View workflow run