{
  "markdown": "# xhostd SDK\n\nClaude Code and Codex plugin for [xhostd](https://xhostd.com) — deploy applications, sites, and services. Push code, get HTTPS URLs.\n\n## Install\n\n```\n/plugin marketplace add xhostd/xhost-sdk\n/plugin install xhost@xhost-sdk\n```\n\nInstalling the plugin registers both the xhost skill and the remote MCP server (`https://mcp.xhostd.com/mcp/`).\n\n## Codex\n\nThis repository also includes the Codex plugin manifest at `plugins/xhost/.codex-plugin/plugin.json`, its OAuth MCP declaration at `plugins/xhost/.mcp.json`, and a repo-local marketplace at `.agents/plugins/marketplace.json`. The MCP server uses browser-based Google OAuth; do not paste an API token into the plugin configuration.\n\nAfter installing, reload plugins in your current session:\n\n```\n/reload-plugins\n```\n\n## Connect\n\nRun `/mcp`, select **xhost**, and choose **Authenticate**. Your browser opens for Google sign-in — no token needed.\n\n## Usage\n\nJust use `/xhost` — it handles everything:\n\n```\n\"deploy my website\"          → signs up, creates app, pushes, deploys\n\"check my app status\"        → shows apps, channels, URLs, deploy state\n\"create a preview for this branch\" → pushes branch, creates preview URL\n```\n\nOr invoke it explicitly:\n\n```\n/xhost\n```\n\nThe single `/xhost` skill handles account setup, app creation, deploys, previews, and status checks. Claude figures out what you need from context.\n\nIn Codex, describe the task normally or mention the xhost skill; slash-command syntax is client-specific.\n\n## Example use cases\n\n- Deploy the current website or API to xhostd and return its live HTTPS URL.\n- Create a preview channel for the current branch and report its URL and deploy status.\n- Inspect apps, channels, runtime logs, environment metadata, domains, or deployment history.\n\n## What xhostd supports\n\n- **Static sites** — nginx serves your HTML/CSS/JS\n- **Node.js apps** — Express, Next.js, Fastify, Vite (give `install.sh` + `launch.sh`)\n- **Python apps** — FastAPI, Flask, Django (give `install.sh` + `launch.sh`)\n- **Docker apps** — any runtime, from a `Dockerfile` that you write\n- **Background workers** — processes that run without end, not web servers\n\n## Recipes\n\n<https://docs.xhostd.com/guides> holds one complete recipe for each shape of app: every file, the exact calls, and the failure modes of that shape. Read the recipe for your shape before you write the code. The plugin carries the same recipes offline, under `plugins/xhost/skills/xhost/references/`.\n\n## How it works\n\n1. You push code to xhostd's git server\n2. You trigger a deploy (explicitly, via `/xhost` or the API)\n3. xhostd runs your `install.sh` (install the dependencies) then `launch.sh` (start the app on `$XHOST_HTTP_PORT`)\n4. Your app is live over HTTPS with a wildcard cert\n\nA Docker app runs the `CMD` in your `Dockerfile` in place of the two scripts. A static site needs no script, because nginx serves the committed files.\n\n## Requirements\n\n- Git installed locally\n- An API token (from [console.xhostd.com/tokens](https://console.xhostd.com/tokens)) only if you push over git or call the API with raw curl — the MCP connection itself uses OAuth, no token\n\n## License\n\nMIT\n",
  "bytes": 3150,
  "sha": "c953268123eada5bfc9643d2fca495f2931be0069ed327051fe1eee7a50a2eb2",
  "repo_slug": "yairl/xhost-sdk",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_xhostd_mcp_e516d6cf/readme"
}