1 Home
mitosis edited this page 2026-07-29 08:11:35 -05:00

Everything on this platform runs through the Forgejo you are reading right now — this page shows you the loop and hands you three doors into it.

Not a developer? Start with The Big Idea — the whole platform in plain language, no jargon, and everything you need to build your first thing. The technical pages below will still be here when you're curious.

The loop

You describe software in issues. An AI crew builds it in PRs, each with a real preview environment — its own database, its own URL, its own TLS. A validator signs into the preview with a real browser and posts one verdict. On ✅ Ship it, the PR merges and your app releases to a public URL. You steer the whole time with plain comments and labels: comment on a PR to redirect the agent mid-build, add the agent-work label to any issue to queue it. That is the entire interface — no dashboards to learn before your first ship.

What lives where

Surface What it is
https://git.espoautos.com Everything. Repos, issues, PRs, CI, packages, secrets, this wiki — Forgejo is the whole control plane.
https://mcp.espoautos.com/mcp Your agent's door. Point any MCP client (Claude Code, Cursor, ...) here and it can build on this platform through tool calls.
https://grafana.espoautos.com The meters and levers — every platform ships them: fleet allocation, spend burn, and the flow-control forms. Admin login is on your YOUR PLATFORM card.
https://<app>-<org>.espoautos.com Your software. Every released app gets this URL; every open PR gets https://pr-<N>-<app>-<org>.espoautos.com.

Start here

  1. Build Your First App — click "Use this template" on plat/_app-template; the repo name and description ARE the spec, and the first pull request opens within a minute. Ten minutes to a live URL.
  2. Create an org and let it plancreate an org whose description is a product brief, then arm the plan-org label on the seed issue the platform files for you; a planner designs an integrated suite with an ownership map and a dependency-wired roadmap, then the crew builds it in waves.
  3. Connect Your Agentclaude mcp add --transport http plat https://mcp.espoautos.com/mcp, authenticate through Forgejo when prompted, and your own harness gets the full tool surface: create apps, file issues, release, query logs.

The rest of the wiki

This wiki grows on the platform it describes

This platform can clone itself onto new hardware, and this wiki ships inside the seed. When a platform reproduces, the daughter is born with her own copy of these pages, every link rewritten to her own domain. The flagship instance is open-platform.sh, run with support from espodev; the one you are reading belongs to whoever grew it. Documentation here is an organ of the organism, not an appendix — see Grow Your Own Platform.