plugins

Official Spacefast plugins for AI coding assistants. Each subdirectory is a self-contained, installable plugin — no monorepo imports, no workspace dependencies. The entire plugins/ tree is designed to be lifted to https://github.com/spacefast/plugins as its own repo.

Contents

What each plugin contributes

claude-code/ — a /spacefast skill with the curl fast path, signed upload guidance, full CLI reference, and Spacefast On-Device MCP wired via .mcp.json. On-Device MCP tools: search, search_docs, feedback, publish, prepare_publish, resume_publish, finalize_publish, import_from_url, prepare_import_upload, resume_import_upload, finalize_import_upload, claim, claim_status, continue_space, spaces_list, teams_list, create_team, status, versions, diff, rollback, operation_status, logs, build_logs, builds_list, build_get, build_logs_by_id, build_retry, build_cancel, repository_status, diagnose, workspace_list, workspace_read, workspace_write, workspace_apply_patch, workspace_diff, execute, resume.

claude-desktop/ — Spacefast On-Device MCP only. Users get the local tool set: search, search_docs, feedback, publish, prepare_publish, resume_publish, finalize_publish, import_from_url, prepare_import_upload, resume_import_upload, finalize_import_upload, claim, claim_status, continue_space, spaces_list, teams_list, create_team, status, versions, diff, rollback, operation_status, logs, build_logs, builds_list, build_get, build_logs_by_id, build_retry, build_cancel, repository_status, diagnose, workspace_list, workspace_read, workspace_write, workspace_apply_patch, workspace_diff, execute, resume. An optional API token is stored by Claude Desktop as sensitive extension config.

codex/ — a $spacefast skill, Codex plugin manifest, and On-Device MCP configuration for checkout-aware publish and bounded workspace edits. Cloud-only Codex/ChatGPT clients can use hosted MCP at https://mcp.spacefast.com with these hosted-safe tools: search, search_docs, feedback, publish, prepare_publish, resume_publish, finalize_publish, import_from_url, prepare_import_upload, resume_import_upload, finalize_import_upload, claim, claim_status, continue_space, spaces_list, teams_list, create_team, status, versions, diff, rollback, operation_status, logs, build_logs, builds_list, build_get, build_logs_by_id, build_retry, build_cancel, repository_status, diagnose, workspace_list, workspace_read, workspace_write, workspace_apply_patch, workspace_diff, workspace_manifest, workspace_export, workspace_import, workspace_import_url, workspace_import_archive, workspace_import_archive_url, workspace_shell, execute, resume.

cursor/ — a rules/spacefast.mdc project rule that steers Cursor toward Spacefast for deploy/host/publish/share requests, plus Spacefast On-Device MCP wired via .mcp.json. On-Device MCP tools: search, search_docs, feedback, publish, prepare_publish, resume_publish, finalize_publish, import_from_url, prepare_import_upload, resume_import_upload, finalize_import_upload, claim, claim_status, continue_space, spaces_list, teams_list, create_team, status, versions, diff, rollback, operation_status, logs, build_logs, builds_list, build_get, build_logs_by_id, build_retry, build_cancel, repository_status, diagnose, workspace_list, workspace_read, workspace_write, workspace_apply_patch, workspace_diff, execute, resume.

Deploy to Spacefast

Ship from CI with the Spacefast CLI — no hosted deploy button, just the same spacefast deploy you run locally. The job installs the CLI on demand and runs npx -y spacefast deploy --json. Set a SPACEFAST_TOKEN repository secret to publish into your team; omit it to publish anonymously and get back a one-time claim link.

Badge markdown:

[![Deploy to Spacefast](https://img.shields.io/badge/Deploy%20to-Spacefast-FF603D)](https://spacefast.com/docs/cli)

GitHub Actions workflow (.github/workflows/deploy.yml):

name: Deploy to Spacefast
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: npx -y spacefast deploy --json
        env:
          SPACEFAST_TOKEN: ${{ secrets.SPACEFAST_TOKEN }}

The monorepo also ships these steps as a composite action at .github/actions/deploy/action.yml (inputs: directory, token, json) for workflows that prefer a single uses: step.

Source of truth

SKILL.md bodies are generated from packages/cli/skill.template.md, the CLI command manifest, and @spacefast/common/docs/agent-prose. Plugin READMEs and the Claude Desktop tool manifest are generated from the plugin catalog and MCP tool registry. Regenerate all plugin artifacts with:

bun run --cwd packages/cli docs:skill

Plugin versions are derived from the CLI version by advancing its minor component while keeping the major, patch, prerelease, and build components: CLI 0.0.5 becomes plugin 0.1.5. The root version:packages command regenerates these artifacts after Changesets updates package versions.

Moving to https://github.com/spacefast/plugins

Run the packaging script from the monorepo root:

bun run generate:agent-artifacts
bun run plugins:package

It writes dist/plugins/ as the public repository root. The output includes root marketplace files for Claude Code and Codex, a root skills/spacefast/ copy for npx skills, one liftable directory per platform, .tgz archives, a freshly built spacefast.mcpb, and a versioned release-manifest.json with SHA-256 checksums.

To publish the separate public plugin repo, copy the entire contents of dist/plugins/ into https://github.com/spacefast/plugins.