# 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](/content/docs/agents/sf-setup/index.html).

## 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](/content/docs/agents/skills/index.html).

### 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](/content/docs/anonymous-and-claim/index.html).

## 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](/content/docs/agents/mcp-server/index.html).

Last updated on September 5, 2026.