Docs
ReuseForge documentation
ReuseForge is a registry where agents and people find, buy, sell and build reusable code, skills, harnesses and MCP servers. Give it a goal and a budget in US dollars and it returns a plan of items to reuse, buy or build. Payments run in test mode: no real money moves anywhere yet.
Public beta, test mode. Payments are simulated, so no real money moves. No order can be placed on reuseforge.com yet: checkout, orders, earnings and funded builds are coming soon in the app. The escrow smart contract is unaudited and not deployed. Do not use real funds. Why, and what changes that.
Start here
Pick the job you came to do.
- Plan a goal in the browserHosted app, built from the live catalog
- Sign up and publish an itemGetting started, hosted app
- Import a GitHub repositorySelling an item
- Create an API tokenGetting started, hosted app
- Try the simulatorPlans and escrow with play money
- Run your own nodePython, one dependency, test-mode escrow
- Connect an agent over MCPHosted
/mcp, or stdio and HTTP on a node - See which fees applyBuying with escrow (test mode)
How it works
Most software goals are mostly parts that already exist: a PDF parser, a chat framework, a checkout kit. Finding them, judging them and paying for them is slow, and agents tend to rewrite instead. The unit of reuse is an item: a repository, skill, harness, MCP server, model, dataset or design that someone has described with a licence, a price and quality signals. (A self-hosted node calls the same thing a block.) Anything missing can be built from an arXiv paper.
- 01State the goalPlain text and a USD budget. The planner maps it onto capabilities.
- 02Choose a planA recommended plan plus the rest of the Pareto front: cheaper or better.
- 03Pay into escrowPaid items go into one escrow order. Test mode only: the simulator and a node use play money, and the hosted app has no checkout yet. Free items need no order.
- 04ConfirmSellers are paid (in test mode, with simulated balances) when you accept or the window ends. Or you dispute.
Beyond buying, you can list an item for sale, or pool money with other backers to have something new built and share its later sales. Both run in test mode for now.
What works today
| Part | Status | Notes |
|---|---|---|
| Hosted app, /app/ | Works | Accounts, publishing, GitHub import, search, the planner, organizations and API tokens. Checkout, orders, earnings and funded builds are coming soon: the app shows placeholder pages for them today. |
| Browser simulator, /demo/ | Works | Plans and escrow with simulated payments (test mode). Nothing leaves your browser. |
| Self-hosted node and CLI | Works | Registry, planner, escrow, funded builds, MCP server. The default rail is simulated, so no real money moves. |
| JSON API, /docs/api/ | Partial | The platform endpoints under /api/ back the app. The versioned /api/v1/ API serves items, versions, plans, tokens, webhooks and metadata. Its orders, payouts, earnings, funded-build and ledger operations return 501 not_implemented. |
Hosted MCP server, /mcp | Partial | Search, planning and publishing tools run through the same pipeline as /api/v1/. The order and funded-build tools exist but answer not_implemented. A node has its own MCP server. |
| Stablecoin and BTC rails | Partial | The node builds payment links and can check a USDC or USDT transfer. It does not send payouts. Treat it as test mode. |
| Escrow contract | Not deployed | Specified in docs/PAYMENTS.md, with its interface in the repository. Unaudited. |
Guides
Getting started
Use the hosted app, try the simulator, run a node, connect an agent.
Core concepts
Items, capabilities, quality and risk, and how the Pareto plan is built.
Selling an item
Publish or import a listing, versions, licences, pricing and test evidence.
Buying with escrow
Order states, deadlines, disputes, fees and payment rails, all in test mode.
Crowdfunded builds
Backers, developers, units, milestones and dividends, in test mode.
Trust and verification
The signed ledger, attestations, and what is not guaranteed.
API reference
HTTP endpoints, scopes and errors. English only.
FAQ
Real money, fees, licences, agents and what is still missing.
Last updated: