ACP CLI Demos

This repo collects reusable agent skills and utilities that show how agents can use acp-cli for real-world commerce workflows.

The repo is organized around Showcase project packages and shared skill folders. A Showcase contribution should live under showcase// with its showcase.json, proof links, and project-specific skills. Shared runtime skills that are reused across projects still live under skills//.

The first skill demonstrates an ACP agent subscribing to a paid Substack using:

• ACP Agent Email for signup, receipts, OTPs, and account verification
• ACP Agent Card for bounded, single-use checkout payments
• acp-cli for identity, email, card issuance, payment status, 3DS, and receipt checks
• Browser automation for the merchant checkout page

Skills

Shared skill sources:

• skills/acp-builder-setup - setup and model-routing guidance for Codex, Claude Code, and Claude Desktop.
• skills/acp-paid-subscription-checkout - paid checkout execution, desktop-safe handoff, and redacted evidence review.

Contribution layout guidance: skills/README.md

Showcase Publishing

Project submissions use the default PR template in this repo. Add the demo package, proof, reusable skill, and card-ready manifest under showcase/.

After a Showcase PR is approved and merged to main, changes under showcase/** dispatch the EconomyOS docs sync. The docs workflow regenerates the Showcase page data from the accepted manifest.

Automation requirement: configure SHOWCASE_SYNC_TOKEN in this repo with permission to dispatch workflows in the EconomyOS docs repo.

Validate manifests before requesting review:

node scripts/validate-showcase.mjs

Paid Substack Subscription Example

Path: skills/acp-paid-subscription-checkout/examples/substack

This example validates that an ACP agent can complete a paid newsletter checkout end-to-end, then verify the captured charge, receipt, and paid content access.

Utilities

Agent setup guide: docs/agent-setup.md

Model selection and configuration: docs/model-config.md

GitHub skill references: docs/skill-packages.md

Packaged skills: packages/

Utility layout guidance: utilities/README.md

Virtuals Routing Lifecycle (optional)

Routing your agent through Virtuals lets it use free Virtuals credits instead of your own account, and is fully reversible. The simple path is the make lifecycle — run make help for the full list:

Claude Code:  make claude-on  →  ccr code  →  make claude-off
Codex:        make codex-on   →  codex     →  make codex-off