From your editor to a live app.
Use xhostd from your local terminal or editor — Claude Code, Codex, Cursor, or any AI tool that can fetch a URL and run shell commands.
Your console. Once you sign in, your dashboard lives at console.xhostd.com — apps, tokens, custom domains, and account settings. You'll find it linked from the docs sidebar too.
Before you start
Open Claude Code in your terminal. Run the /plugin commands inside Claude Code. The claude plugin commands run in your shell.
Install the xhostd plugin
Inside Claude Code, register the marketplace and install the plugin. It ships both the MCP server (the tools your agent calls) and the xhostd skill (instructions for using them) — no tokens, no manual MCP setup.
/plugin marketplace add xhostd/xhostd-sdk
/plugin install xhostd@xhostd-sdk
Or install the plugin from your shell. If Claude Code is already
running, run /reload-plugins in it to load the plugin.
claude plugin marketplace add xhostd/xhostd-sdk
claude plugin install xhostd@xhostd-sdkAuthenticate
Run /mcp, select xhostd, and choose
Authenticate. Your browser opens the xhostd sign-in
page — sign in with your xhostd password, or continue with
Google — then approve in one click. If you're brand-new, you
pick a username along the way; it becomes part of your project URLs
(e.g. my-site-yourname.xhostd.app).
No xhostd account and no Google account? Choose Create an
account on that page. xhostd mails you a confirmation link,
you set your username and password in the browser, and then you run
/mcp → Authenticate again to
finish connecting — the client does not wait for the mail.
Claude Code stays signed in across sessions; you won't be prompted again until your token expires.
Tell it what to build
Describe what you want. The skill already taught Claude the create-app → push code → deploy flow, so a plain sentence is enough.
Build a landing page for my coffee shop called "Bean There".
Deploy it to xhostd.
Claude creates the app, writes the files, deploys, and replies with a
live URL like https://bean-there-alice.xhostd.app.
Other things you can ask for:
- "Build me a portfolio site with my projects"
- "Create a REST API for my mobile app"
- "Make a multiplayer game I can share with friends"
- "Set up a webhook handler for my Slack bot"
- "Build a small CRUD app with logins"
Make changes
Want to update your project? Just tell Claude what to change. It edits, redeploys, and reports the new URL.
For a safer iteration loop, ask for a preview channel ("deploy a preview"). You get a separate URL you can share for feedback before promoting to prod.
Every project that runs code gets a database wired in automatically —
your app reads DATABASE_URL and Claude takes care of the rest.
A static site gets no database, because it queries nothing.
The API reference covers database reset, SQL dump,
custom domains, and Google sign-in for your apps.
Using a different MCP client?
Cursor, Codex, Windsurf, and any other OAuth-capable MCP client can connect to xhostd's server directly — no plugin install, no token paste. Point the client at:
https://mcp.xhostd.com/mcp/The first tool call triggers the same browser-based sign-in flow as the plugin. To teach the client the create → commit → deploy flow without the bundled skill, also ask it to fetch https://docs.xhostd.com/llms-full.txt at the start of the session.
A headless setup with no browser registers its own account and adds the server with a header: claude mcp add --transport http xhostd https://mcp.xhostd.com/mcp/ --header "Authorization: Bearer $(cat ~/.config/xhostd/token)" — Register as an agent.
For developers
xh_ token (for git push or CI) sign in at
console.xhostd.com/tokens
and click Create token.
Connection is not blanket permission. Sensitive operations still follow the platform’s access rules. Manage protected agent actions in the console.