Skip to content

docs(profile): reposition as 'the spend layer for AI agents'#8

Merged
achris7 merged 1 commit into
mainfrom
docs/profile-readme-spend-layer
Jun 9, 2026
Merged

docs(profile): reposition as 'the spend layer for AI agents'#8
achris7 merged 1 commit into
mainfrom
docs/profile-readme-spend-layer

Conversation

@achris7

@achris7 achris7 commented Jun 9, 2026

Copy link
Copy Markdown
Member

Rewrites profile/README.md per the new positioning.

What changed

  • New positioning: the spend layer for AI agents — budget-not-a-balance, walletless, context-aware budgets.
  • Quickstart (npm + pip + MCP) with a working x402_fetch example.
  • Vendor Marketplace (27 endpoints), framework matrix (GA/Beta/Preview), and a Repos table with real links.
  • Roadmap section for the credit layer (working capital, portable credit).
  • Kept the existing banner and the npm / pypi / MIT badges.

Placeholders resolved

  • [N]27 (matches the current profile's "27 verified API endpoints"). Swap to "13,000+ reachable" if you prefer that framing.
  • Broken https://a, snippet URL → https://api.exa.ai/search (matches the Python example).
  • Filled (…) repo links + the [npm]/[pypi]/[license] badge placeholders.

⚠️ Heads-up

The MIT license badge links to agentkit-actions/blob/main/LICENSE, but GitHub detects no LICENSE file in any of the four public repos — that link 404s today. Add LICENSE files (or adjust the badge) before merging.

Draft — review the rendered profile, then merge to publish.

Summary by CodeRabbit

  • Documentation
    • Restructured README with improved landing page layout and clearer messaging
    • Enhanced Quickstart examples for improved clarity and usability
    • Added Roadmap section to communicate future direction
    • Updated Vendor Marketplace and framework integration information

Rewrites the org profile around the spend-layer positioning: budget-not-a-balance
framing, walletless onboarding, 27-endpoint marketplace, framework matrix, and a
5-minute quickstart (npm/pip/MCP). Keeps the banner + npm/pypi/MIT badges; credit
features moved to the roadmap.
@coderabbitai

coderabbitai Bot commented Jun 9, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 8d82ba3d-7a8f-4233-9fdb-43e85909e257

📥 Commits

Reviewing files that changed from the base of the PR and between 7373961 and 9e6d756.

📒 Files selected for processing (1)
  • profile/README.md

📝 Walkthrough

Walkthrough

The PR reorganizes the profile README as a marketing and onboarding document, replacing prior how-it-works content with a new banner header, "Why Floe" value section, streamlined Quickstart examples emphasizing the x402_fetch API, updated integration tables, added Roadmap, and refreshed footer contact lines.

Changes

Profile README documentation refresh

Layer / File(s) Summary
Landing header and value proposition
profile/README.md
Banner/header section replaced with "spend layer for AI agents" tagline and new "Why Floe" introductory content positioned before Quickstart.
Quickstart code examples
profile/README.md
TypeScript and Python code examples updated to show only x402_fetch API calls (instant_borrow examples removed), MCP zero-install configuration snippet added and repositioned with updated guidance.
Marketplace and framework integrations
profile/README.md
Vendor Marketplace table wording and entries updated, "Works with your framework" table revised with new adapter references.
Repositories, roadmap, and contact information
profile/README.md
Repos section shortened, new Roadmap section added describing spend-first and credit-in-development approach, footer updated with refreshed early-access contact call-to-action and builder credit.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • Floe-Labs/.github#1: Both PRs modify profile/README.md Quickstart examples and marketing tables, with overlapping changes to code snippets and integration references.
  • Floe-Labs/.github#2: Both PRs update profile/README.md Quickstart snippets, switching between instant_borrow and x402_fetch examples in the same documentation sections.
  • Floe-Labs/.github#7: Both PRs revise the same Quickstart examples by removing instant_borrow and retaining x402_fetch, alongside marketing and table layout edits.

Poem

🐰 A README renewed, bright and clean,
With spend-layer magic in between,
Fresh examples dance, x402 takes the stage,
Roadmap unfolds on a newly written page.
Hop forward together to code and to thought! 🚀

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/profile-readme-spend-layer

Comment @coderabbitai help to get the list of available commands and usage tips.

@achris7 achris7 marked this pull request as ready for review June 9, 2026 03:56
Copilot AI review requested due to automatic review settings June 9, 2026 03:56
@achris7 achris7 merged commit 357f316 into main Jun 9, 2026
1 check was pending

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Refreshes the GitHub profile README marketing copy and quickstart to emphasize Floe’s “spend layer” positioning, simplify onboarding messaging, and re-organize product info.

Changes:

  • Rewrites the intro/CTA and “Why Floe” section with updated positioning and benefits.
  • Simplifies the Quickstart examples (focus on x402_fetch) and updates MCP/config + docs link.
  • Reintroduces structured sections (Vendor Marketplace, framework support, repos, roadmap) in a shorter form.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread profile/README.md
Comment on lines +84 to +92
| Category | Services |
|---|---|
| Compute | Venice AI (chat, responses, embeddings) |
| Voice | Venice AI (TTS, transcription) · dTelecom STT |
| Image | Venice AI (generation, upscale, edit, background removal) |
| Web | Firecrawl (search + scrape) |
| Search | Exa · Parallel AI · Tavily |
| Browser | Hyperbrowser · Browserbase · Anchor Browser |
| Agent tools | AgentMail · Pinata · PostalForm |
Comment thread profile/README.md
Comment on lines +98 to +107
| Framework | Status | How |
|---|---|---|
| Coinbase AgentKit | GA | Native — `floeActionProvider` |
| LangChain | GA | `getLangChainTools` adapter |
| Vercel AI SDK | GA | `getVercelAITools` adapter |
| Claude / Cursor | GA | `floe-mcp-server` |
| CrewAI | Beta | via MCP server |
| OpenAI Agents SDK | Preview | MCP fallback; native adapter in progress |
| ElizaOS | Preview | MCP fallback |
| Plain HTTP/REST | GA | anything that speaks HTTP |
Comment thread profile/README.md
Comment on lines +111 to +116
| Repo | What it does | Install |
|---|---|---|
| [agentkit-actions](https://github.com/Floe-Labs/agentkit-actions) | TypeScript SDK — wallet, x402 payments, spend controls, agent awareness | `npm install floe-agent` |
| [agentkit-actions-py](https://github.com/Floe-Labs/agentkit-actions-py) | Python SDK — full parity | `pip install floe-agentkit-actions` |
| [floe-mcp-server](https://github.com/Floe-Labs/floe-mcp-server) | MCP server for Claude, Cursor, any MCP agent | [Setup](https://github.com/Floe-Labs/floe-mcp-server#readme) |
| [floe-examples](https://github.com/Floe-Labs/floe-examples) | Runnable end-to-end agents | `git clone` |
Comment thread profile/README.md
Comment on lines +74 to +77
{ "mcpServers": { "floe": {
"url": "https://mcp.floelabs.xyz/mcp",
"transport": "streamable-http"
} } }
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