Skip to content

Revamp README, public docs, and CLI positioning for OmniClaw launch#47

Merged
abiorh-claw merged 2 commits intomainfrom
arc-marketplace-showcase
Apr 15, 2026
Merged

Revamp README, public docs, and CLI positioning for OmniClaw launch#47
abiorh-claw merged 2 commits intomainfrom
arc-marketplace-showcase

Conversation

@Abiorh001
Copy link
Copy Markdown
Contributor

Summary

This PR rewrites OmniClaw’s public-facing documentation so it reflects the actual product more clearly and more professionally.

The main goal was to stop underselling the platform and make the repo easier to understand, evaluate, and use within seconds.

What changed

  • rewrote the root README to read like a real product page instead of internal documentation
  • moved the core wedge to the top: OmniClaw as the control layer for agent money
  • surfaced public proof earlier, including Arc settlement proof and competition wins
  • added a clearer first-run path and role-based onboarding flow
  • improved differentiation versus wallets, facilitators, and x402 settlement providers
  • cleaned up duplicated explanations and pushed deep architecture lower in the page
  • clarified prerequisites by path instead of leaving setup requirements implied
  • tightened buyer, seller, and infrastructure positioning across the docs

CLI and seller-path clarification

A key correction in this PR is the positioning of omniclaw-cli serve.

  • omniclaw-cli is the agent-facing surface
  • omniclaw-cli serve can expose paid endpoints for other agents or automation
  • the Python SDK seller path is the default when a vendor or enterprise team is embedding paid routes directly into an application

This distinction is now reflected consistently across the README and docs.

Docs updated

  • README.md
  • docs/README.md
  • docs/operator-cli.md
  • docs/agent-getting-started.md
  • docs/agent-skills.md
  • docs/FEATURES.md
  • docs/facilitators.md
  • docs/erc_804_spec.md
  • docs/production-readiness.md
  • docs/PRODUCTION_HARDENING.md
  • docs/CCTP_USAGE.md
  • docs/omniclaw-cli-skill/SKILL.md

Result

The repo now does a better job of showing that OmniClaw is already a real, shipped platform with:

  • buyer CLI
  • buyer SDK
  • seller SDK
  • ERC-8004 trust checks
  • Circle Gateway nanopayments
  • self-hosted x402 exact facilitator support
  • Arc exact-settlement proof

Testing

Docs-only changes. No code tests were run.

@Abiorh001 Abiorh001 requested a review from abiorh-claw April 15, 2026 14:43
@abiorh-claw abiorh-claw merged commit bab882c into main Apr 15, 2026
5 checks passed
@abiorh-claw abiorh-claw deleted the arc-marketplace-showcase branch April 15, 2026 14:47
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