Claude Code

Install the Spacefast plugin in Claude Code, what it adds to your session, and the prompts that work

After this page Claude Code can publish your project, read its deployments, domains, and traffic, and manage the rest of your account without you leaving the terminal.

Install

claude plugin marketplace add spacefast/plugins
claude plugin install spacefast@spacefast

The plugin does not assume the sf CLI is installed. You sign in the first time the hosted server is used, through your client’s OAuth flow.

Two other lanes exist. npx -y plugins add spacefast/plugins -t claude-code -y installs the same plugin, and sf setup agent --agent claude-code writes MCP config into ~/.claude.json and installs the skill into ~/.claude/skills/spacefast/ instead. See sf setup agent.

What the plugin adds

MCP servers

Two entries, hosted and local.

{
  "mcpServers": {
    "spacefast": {
      "type": "http",
      "url": "https://mcp.spacefast.com"
    },
    "spacefast-local": {
      "command": "npx",
      "args": ["-y", "spacefast@<version>", "mcp"],
      "env": {}
    }
  }
}

spacefast is the hosted server. spacefast-local runs the same server on your machine over stdio, which is what lets publish read a folder instead of taking inline files. The version in args is stamped at release; the shipped file pins whatever the release built.

The "type": "http" field is load-bearing. Claude Code rejects a bare { "url": ... } entry.

The Spacefast skill

skills/spacefast/ holds SKILL.md, references.md, and seven bash scripts. The skill routes each request to the right tool, sets the publish then poll then report loop, and holds the rules about never printing claim credentials. The scripts are a curl fallback for when MCP is unavailable. See skills.

One SessionStart hook

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "node \"${GROK_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/hooks/session-start.mjs\""
          }
        ]
      }
    ]
  }
}

The script reads .spacefast/space.json in your working directory. If that file names a Space, it writes one line into the session and nothing else.

Spacefast project detected. This directory is linked to <space> at <liveUrl>. Use the Spacefast skill and preserve .spacefast/space.json. Treat .spacefast/state.json as credential material: never print, commit, or archive it.

The live URL is appended only when it starts with https://. If the file is missing or holds no Space, the hook prints nothing. It makes no network calls and sends no telemetry.

Verify it works

Ask the agent to find a documentation page through execute. It should search for the documentation operation, describe it, and call it before attempting a publish.

Use the Spacefast MCP server to search the docs for custom domains.

Use the Spacefast MCP server to search the docs for custom domains.

If the tools are wired up, Claude Code names the tool it called. Then try a publish.

Publish this folder to Spacefast and give me the live URL.

A first publish with no account returns a claim link. Claim it in the browser to keep the Space. See Publish without an account.

Typical prompts

Publish ./dist to Spacefast and tell me the live URL and the version URL.

Ship a new version of this site with the changelog “fix the pricing table”.

Show me the last few deployments for this Space and whether the latest build passed.

Point docs.example.com at this Space and tell me which DNS records to add.

How much traffic did this Space get in the last 30 days?

Roll this Space back to the previous version.

The first five map to typed tools. The rollback goes through execute, which may pause and ask you to approve the write in the browser before it runs. See approvals.

Last updated on September 5, 2026.