drobek drobek docs
drobek is an open-source cloud workspace for small web apps that your AI agent builds over MCP: every write compiles into a version with a preview URL, and publishing puts it live. From freema/drobek at v0.5.2, the release drobek.app runs.
Using an AI agent?
Give it this page or this link: it tells the agent how to connect and build.
https://drobek.app/llms.txtStart from a prompt
Read https://drobek.app/llms.txt and connect the drobek MCP server https://drobek.app/mcp. If a step needs me, such as signing in, tell me exactly what to do. Then build me: …your app idea
Agents, do this:
- Read https://drobek.app/llms.txt: the MCP server, every tool and the rules. The full contract: https://drobek.app/llms-full.txt.
- Connect the MCP server
https://drobek.app/mcp(OAuth: the user signs in once in the browser). Claude Code:
then the user runsclaude mcp add --transport http drobek https://drobek.app/mcp/mcp→ drobek → sign in. Or install the plugin, which adds the server and the build skill:
Claude (web, desktop): add a custom connector with the URLclaude plugin marketplace add freema/drobek-plugin claude plugin install drobek@drobekhttps://drobek.app/mcp. Cursor, Codex: connect. - Create the app and write its files. Every write compiles and returns the result: fix what fails, then give the user the preview URL.
- Publish only when the user asks.
Every docs page is also Markdown: /docs/<page>.md, or send Accept: text/markdown.
On drobek.app there is nothing to install: sign in, or add https://drobek.app/mcp to your agent. The self-hosting pages are for running your own server.
Common tasks
- Connect Claude Code, Claude, Cursor or Codex · Agents
- Every MCP tool and the scope it needs · Agents
- Give an app sign-in, data, forms or file uploads · Platform modules
- Run your own drobek: the quickstart · Overview
- Every environment variable · Self-hosting
- Custom domains · Self-hosting
- Upgrades and rollback · Self-hosting
- Report a vulnerability · Security
Use drobek
Overview
What drobek is, the loop, the core concepts, the self-host quickstart and connecting your agent.
Choose where to run itSee what people buildBuild your first appThe loopCore conceptsSelf-host quickstartConnect your agentDevelop locally and 5 more
Agents
Connecting Claude Code, Claude, Cursor or Codex over MCP, the tools and scopes, the briefing, skills and llms.txt.
ConnectScopes and rolesToolsThe briefingSkillsWhere the contract is served
Platform modules
The backend of an app: auth, data, forms, email, files and proxy, their configuration, and writing your own module.
Using modules in an appEnabling modules on your server (operators)Installing an external moduleThe contractSlotsPer-app configurationSkills: skill_infoLimits and the limits provider and 10 more
Run your own drobek
Self-hosting
The quickstart, compose, every environment variable, TLS, backups, upgrades, custom domains and abuse handling.
Quickstart (clean Ubuntu 24.04 + Docker)HostsProduction composeEnvironment referenceBackup and restoreUpgrades and rollbackThird-party modulesImage tags and 7 more
Architecture
One process, origins, versions, the compiler, serving, modules, TLS and jobs.
1. One process, one image2. Workspaces, apps and versions3. The compile step4. Origins and hosts5. Serving6. Platform modules7. TLS8. Background jobs and 1 more
Project
Security
How to report a vulnerability, and the threat model.
Licensing
AGPL-3.0, what it asks of you, and the boundary with the hosted drobek.app.
What the AGPL asks of youThe boundary with drobek-web (the hosted drobek.app)Related repositories
Everything else, the source included, is in the repository on GitHub (AGPL-3.0).