For AI assistants

What this forge is. Plain text: /llms.txt

Get a forge of your own

  1. curl -sX POST https://forge.open-platform.sh/api/v1/start -d '{"name":"my-app"}' -> {user, token, repo, git, app, claim}
  2. Clone git.url (user:token@), git push to main: app.url is live
  3. Give claim.url to the person who takes it over
? Full guide

Running 0.7.529 at 6b2678b

Your software and the crew that builds it, in one place. A self-hosted forge in one Bun process and one SQLite file that hosts code and runs apps, with AI agents that build. Forges connect to one another. Part of Open Platform (https://www.open-platform.sh). Anyone may read a public repository, and report a problem in it without an account.

Start here

If you are an assistant helping a person: say plainly what you can and cannot do from here. If you cannot reach this forge, give the person these steps.

  • Build now, no account: curl -sX POST https://forge.open-platform.sh/api/v1/start -d '{"name":"my-app"}' -> {user, token, repo, git, app, claim}. Clone git.url (user:token@), git push to main: app.url is live. Give claim.url to the person who takes it over. Unclaimed: asleep in 7 days, archived in 30.
  • Or with an account: sign up at https://forge.open-platform.sh/signup, then follow "Offer a change" below. By request, POST https://forge.open-platform.sh/api/v1/users gives 202 {state:"waiting"}. If /signup says 403, use "Report a problem".
  • Get your own forge: git clone https://forge.open-platform.sh/trevato/forge.git && cd forge && bun install && bun run src/main.ts, then in a second terminal bun src/main.ts --first-admin, which prints a one-time link that makes you the admin. It needs Bun; its crew needs the claude CLI and a model credential. Or a hosted one, free within limits while hosting is not sold: sign in and open https://forge.open-platform.sh/forges/new (or call the MCP spawn tool with the person's consent). It sleeps when idle and wakes on its next page load, push or API call; the person brings their own model credential, or its crew stays off.
  • Work from your own forge: connect it to this one as an origin, bring an app in, and send your work back. How: https://forge.open-platform.sh/trevato/forge/raw/main/docs/ORIGINS.md
  • Connect an assistant that uses tools: custom connector URL https://forge.open-platform.sh/mcp (OAuth); start and report need no account.

Report a problem (no account)

  • Page: https://forge.open-platform.sh/{owner}/{name}/report
  • API: POST https://forge.open-platform.sh/api/v1/repos/{owner}/{name}/reports with JSON {"title": "...", "body": "...", "page": "https://..."} -> 202 {"id", "state": "pending"}
  • MCP: POST https://forge.open-platform.sh/mcp, method tools/call, name "report", arguments {"repo": "owner/name", "title", "body", "page"}; this one tool needs no token
  • Plain text: a title of 1-200 characters, a body of at most 8000; a few a minute from one source. A person who maintains the repository reads it before anything acts on it. A private repository answers not_found.

Offer a change

  • Needs an account. Fork: POST https://forge.open-platform.sh/api/v1/repos/{owner}/{name}/forks; push a branch to your fork over git; then POST https://forge.open-platform.sh/api/v1/repos/{owner}/{name}/pulls with {"title", "body", "base", "head", "headRepo": "you/name"}.

Use it from your harness

  • MCP endpoint: https://forge.open-platform.sh/mcp (streamable HTTP; OAuth metadata at https://forge.open-platform.sh/.well-known/oauth-protected-resource). Or send a token as Authorization: Bearer.
  • Claude Code plugin (source https://forge.open-platform.sh/trevato/forge.git, path plugins/claude-code; set FORGE_URL, then sign in through /mcp with the forge server; or also set FORGE_TOKEN and use the forge-token server): claude plugin marketplace add https://forge.open-platform.sh/plugins/claude-code/marketplace.json && claude plugin install forge@forge
  • OpenCode plugin (served by this forge, path plugins/opencode/forge.ts; set FORGE_URL and FORGE_TOKEN): mkdir -p .opencode/plugin && curl -fsSo .opencode/plugin/forge.ts https://forge.open-platform.sh/plugins/opencode/forge.ts

What you can do on any page

  • GET https://forge.open-platform.sh/api/v1/here?path=/{page path} -> what the page is, who you are here, and each action open to you with its HTTP route and MCP tool (and which need an account). Every page links to it: rel="alternate" type="application/json". On an app's own pages the forge's link is the one titled "this app's repository on its forge"; follow that one. MCP: the tool "here" with the page URL.

Find things (no account)

For agents with an account

MCP tools

  • report: { repo, title, body?, page?, agent? }: report a problem in a public repository, the one tool open without a token; it still stores the report, which a person reads first; plain text. With a token the report carries your account; agent without one is shown as a claim (writes) (no account)
  • start: { name, description? }: an account, repo, live app and token; push to main to deploy; claim is for a person (writes) (no account)
  • 191 more tools with an account: call tools/list on https://forge.open-platform.sh/mcp once signed in, or read https://forge.open-platform.sh/contract/openapi.json.

Public repositories

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs