The Sprites ecosystem — set up your coding agent · Fly

Point any agent at

https://sprites.dev/mcp

OAuth in the browser. Nothing to install, nothing to run locally.

Which agent are you using?

Pick one and follow the steps below.

/

Claude Code Anthropic

Plugin marketplace + hosted MCP, browser OAuth, safety hooks.

Codex OpenAI

Marketplace plugin wrapping the hosted MCP server.

Cursor Anysphere

Marketplace plugin, or a two-line MCP entry you paste yourself.

Antigravity Google

One-line install into the agy CLI, with workflow slash commands.

Grok Build xAI

Install and enable from the CLI, then finish OAuth in the browser.

Cortex Code Snowflake

Run Cortex Code builds, tests, and previews in persistent Linux environments, with browser OAuth.

DeepSeek Harness DeepSeek

Adds a layer to the dsh profile you already run.

OpenCode Anomaly

One opencode.json entry; Bun installs it at the next start.

π Pi Pi

First-class Sprites extensions, installed from Git.

VS Code Microsoft

Mount a Sprite's filesystem straight into your workspace.

Herdr Herdr

Each agent pane gets its own Sprite, with the worktree uploaded and a checkpoint to roll back to.

Hermes Agent Nous Research

Run Hermes Agent's shell commands in persistent Sprites with API-token authentication.

Any MCP client Standard

No plugin for your agent yet? Point it at the hosted server.

Agent Plugins v1 Portable

One portable package for clients that speak the v1 format.

No integration matches that — but any MCP client can use the generic path above.

Set up Sprites for Claude Code

superfly/sprites-claude-plugin

Add the marketplace and install the plugin

› /plugin marketplace add superfly/sprites-claude-plugin

Install it

› /plugin install sprites@sprites

Reload so Claude picks up the new tools

› /reload-plugins

Authorize the connector

› /mcp

Pick the plugin-provided sprites server and complete browser OAuth for the Fly.io org you want. Restricted access with a name prefix such as mcp- is the safer default.

Check the integration

› /sprites:status

An empty Sprite list means you're authenticated and working. /sprites:smoke runs the full list → create → exec → cleanup pass.

Prefer the bare MCP server, without the plugin's skills and hooks?

$ claude mcp add --transport http sprites https://sprites.dev/mcp

Set up Sprites for Codex

superfly/sprites-codex-plugin

Install the Sprites plugin from the Codex plugin marketplace

Codex distributes this one through its own marketplace UI, so there's no install one-liner to copy.

Or add this repository as a marketplace from a local checkout

$ codex plugin marketplace add .

Then restart Codex, open the plugin directory, choose the Sprites marketplace, and install Sprites.

Authenticate when Codex prompts you

The plugin talks to the hosted MCP server at https://sprites.dev/mcp.

Ask Codex to prove it's connected

› List my sprites.

An empty list is a successful, authenticated response.

Set up Sprites for Cursor

superfly/sprites-cursor-plugin

Install the Sprites plugin from the Cursor Marketplace

Cursor prompts you to authorize with Sprites over OAuth on first use.

Or wire up the MCP server by hand

~/.cursor/mcp.json

{
     "mcpServers": {
       "sprites": {
         "url": "https://sprites.dev/mcp"
       }
     }
}

Drop this in ~/.cursor/mcp.json for every project, or .cursor/mcp.json for just this one.

Ask the agent to prove it's connected

› List my sprites.

Set up Sprites for Antigravity

superfly/sprites-antigravity-plugin

Install straight from the repository

$ agy plugin install https://github.com/superfly/sprites-antigravity-plugin

Authenticate the sprites server

› /mcp

Use restricted access unless your workflow genuinely needs broader organization control.

List what you've got

› /sprites:list

The plugin also ships /sprites:new, /sprites:run, /sprites:checkpoint, /sprites:service, and /sprites:cleanup.

Set up Sprites for Grok Build

superfly/sprites-grok-plugin

Install the plugin

$ grok plugin install superfly/sprites-grok-plugin --trust

Enable it

$ grok plugin enable sprites

Reload plugins, or restart Grok

› /plugins

Then press r to reload.

Complete browser OAuth

The consent screen defaults to the restricted mcp- name prefix. Full access allows bare names but grants unrestricted access to every sprite in the org.

Run the status check

› /sprites-status

Empty list means you're authenticated. /sprites-smoke does the full list → create → exec → confirm-before-destroy pass, and grok mcp doctor sprites diagnoses a bad install.

Set up Sprites for Cortex Code

superfly/sprites-cortex-plugin

Install from GitHub

$ cortex plugin install superfly/sprites-cortex-plugin

Enable the plugin

$ cortex plugin enable sprites

Reload inside your session, or restart Cortex Code

› /plugin reload

Authorize Sprites when requested

› /mcp

Complete browser OAuth and select the intended Fly.io organization. No Sprites CLI or pasted API token is required.

Check the connection

› /sprites-status

An empty Sprite list still means authentication succeeded.

The plugin includes skills, commands, safety hooks, and a runner for long builds and tests. It does not copy Snowflake credentials or sessions into Sprites.

Set up Sprites for DeepSeek Harness

superfly/sprites-deepseek-plugin

Add the plugin to your profile

$ npx @deepseek-ai/dsh plugin --profile web add github:superfly/sprites-deepseek-plugin

Swap web for whichever profile you actually use.

Start that profile

$ npx @deepseek-ai/dsh --profile web

Complete browser OAuth and pick your Fly.io organization

Restart Harness once if the first tool sync timed out while you were authorizing.

Confirm the layer loaded

$ npx @deepseek-ai/dsh --profile web --dump-config

Output should include the dsh-sprites-plugin layer, sprites-mcp, and sprites-skill-filesystem.

Set up Sprites for OpenCode

superfly/sprites-opencode-plugin

Add the plugin to your OpenCode config

opencode.json

{
     "$schema": "https://opencode.ai/config.json",
     "plugin": ["@flydotio/sprites-opencode-plugin"]
}

OpenCode 1.18.23 or newer. Plugins install automatically with Bun at startup, so restart OpenCode after saving. Until the package lands on npm, clone the repository and use an absolute file:///path/to/sprites-opencode-plugin entry instead.

Complete browser OAuth

› /sprites-status

The first Sprites request starts OpenCode's browser OAuth flow. Pick the Fly.io org you want. If no browser opens, run opencode mcp auth sprites and retry.

Ask OpenCode to prove it's connected

› List my sprites.

An empty list is a successful, authenticated response. /sprites-smoke walks the full list → create → exec pass, and opencode mcp debug sprites diagnoses a bad connection.

π Set up Sprites for Pi

superfly/pi-sprites

Install from GitHub

$ pi install git:github.com/superfly/pi-sprites

Not on npm yet. Node.js 24 or later is required by the Sprites SDK.

Export a Sprites token into Pi's environment

$ export SPRITES_TOKEN='...'

This integration authenticates with a token, not browser OAuth.

Ask Pi to list your environments

› List my sprites.

Set up Sprites for VS Code

superfly/sprites-vscode-ext

Install the Sprites extension

Set your API token

› Sprites: Set API Token

Run it from the Command Palette and paste your Sprites.dev API token.

Open a Sprite

› Sprites: Open Sprite

Its filesystem appears in your workspace, editable in place.

Open a shell on the box

› Sprites: Open Terminal

Sprites: Create Sprite, Sprites: Delete Sprite, and a right-click Download to Local round out the command set.

Set up Sprites for Herdr

superfly/herdr-sprites-plugin

$ sprite login

Linux or macOS, Node.js 22 or newer, Git, and Herdr 0.9.0 or newer. The plugin drives the sprite CLI you just authenticated, so there is no token to paste.

Install the plugin from GitHub

$ herdr plugin install superfly/herdr-sprites-plugin

Find the plugin's config directory

$ herdr plugin config-dir sprites

Choose an organization and an agent

config.json

{
     "org": "your-sprites-organization",
     "agent": "claude"
}

Save it in the directory printed above. agent is claude, codex, or opencode. Add a command array to run a different agent or pass arguments; namePrefix defaults to herdr-.

Start an agent from a Git worktree

$ herdr plugin action invoke start-agent --plugin sprites

Opens a split pane, creates a Sprite, uploads the worktree with its uncommitted edits, checkpoints it, and hands the terminal to the agent. start-claude, start-codex, and start-opencode pick a harness for one launch. Claude Code and Codex reuse your local login when one is available.

Optionally, bind it to a key

config.toml

[[keys.command]]
key = "prefix+shift+s"
type = "plugin_action"
command = "sprites.start-agent"
description = "start agent in a Sprite"

Herdr's own config file, so the action runs from a prefix key instead of the CLI.

Show the pane's Sprite and sessions

$ herdr plugin action invoke info --plugin sprites

Info reports the Sprite, its checkpoint, and the remote session list. reconnect reattaches a detached agent, pull brings its edits back into your worktree, and stop, checkpoint, restore, and destroy round out the set.

Git history, .env files, and credentials never leave your machine; the Sprite gets a fresh baseline repository. Pull rejects overlapping local edits before touching anything, and reconnect keeps remote files and authentication in place.

Set up Sprites for Hermes Agent

NousResearch/hermes-plugin-sprites

Use a current Hermes installation with pluggable terminal backends

This plugin needs the terminal-backend extension introduced in Hermes PR #94400. The commands below assume the standard macOS/Linux install and default Hermes home.

Clone the plugin

$ git clone https://github.com/NousResearch/hermes-plugin-sprites.git ~/.hermes/plugins/sprites

Install the supported SDK in Hermes's Python environment

$ uv pip install --python ~/.hermes/hermes-agent/venv/bin/python 'sprites-py>=0.5.0,<0.6'

For a custom installation, use its Python environment instead. Do not install into an unrelated system Python.

Add a Sprites API token to Hermes's local secrets file

~/.hermes/.env

SPRITES_TOKEN=your-sprites-api-token

Create a token at sprites.dev/account for the intended organization. Edit the file locally; do not paste the token into an agent prompt or commit it.

Enable the plugin

$ hermes plugins enable sprites

Select the terminal backend

$ hermes config set terminal.backend sprites

Check configuration, then start a new Hermes session

$ hermes doctor

Doctor checks that the token and SDK are present, not that the API token works. Restart any running Hermes session or gateway before trying the backend.

Ask Hermes to execute a command in the Sprite

› Use the terminal tool to run uname -a and pwd.

Check the actual tool result and the Sprite in your Sprites dashboard. First use creates or resumes a Sprite and can incur usage charges.

Hermes stays on its host; shell commands run remotely. Sprites persist by default, and remote edits are not automatically copied back. Hermes can upload configured credential files, skills, and caches to the Sprite; review those before use.

Set up Sprites for Any MCP client

superfly/sprites-mcp

Add a remote server entry

mcp.json

{
     "mcpServers": {
       "sprites": {
         "url": "https://sprites.dev/mcp"
       }
     }
}

Streamable HTTP over JSON-RPC 2.0, authenticated with OAuth 2.1 (sprites:read / sprites:write). Nothing runs locally.

If your client only speaks stdio, bridge it

mcp.json

{
     "mcpServers": {
       "sprites": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://sprites.dev/mcp"]
       }
     }
}

mcp-remote handles the OAuth flow on the client's behalf.

Authorize in the browser on first use

Ask your agent to prove it's connected

› List my sprites.

Set up Sprites for Agent Plugins v1

superfly/sprites-agent-plugin

Install the package with any Agent Plugins v1 client

The client discovers plugin.json, the children of skills/, and mcp.json at fixed locations. Agent Plugins standardizes package contents, not the install UI, so follow your client's own local, Git, workspace, or marketplace flow.

Complete browser OAuth on first MCP use

Restricted connector tokens may enforce a sprite-name prefix, creation cap, label, or expiry.

Ask your agent to prove it's connected

› List my sprites.

Claude Code, Grok, and Antigravity are not on the current compatible-client list. Use their dedicated packages above, which also carry hooks the portable format has no equivalent for.

Which language are you building in?

The same primitives the plugins are built on — create, exec, services, checkpoints, network policy.

Python Fly.io

The official Python SDK.

JavaScript Fly.io

The official TypeScript/JavaScript SDK.

Go Fly.io

The official Go SDK.

Elixir Fly.io

The official Elixir SDK.

Google ADK Google

Sandboxes as ADK agent tools, with checkpoint/restore.

OpenAI Agents SDK OpenAI

A Sprite as the sandbox an agent run executes its tools inside.

OpenRouter Agent SDK OpenRouter

Experimental workspace adapter. Not published to npm yet.

Build with Python

superfly/sprites-py

Install from PyPI

$ pip install sprites-py

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Build with JavaScript

superfly/sprites-js

Install from npm

$ npm install @fly/sprites

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Build with Go

superfly/sprites-go

Add the module

$ go get github.com/superfly/sprites-go

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Build with Elixir

superfly/sprites-ex

Add the dependency

mix.exs

{:sprites, "~> 0.2"}

Fetch it

$ mix deps.get

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Build with Google ADK

superfly/sprites-adk

Install from PyPI

$ pip install sprites-adk

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Build with OpenAI Agents SDK

superfly/sprites-py

Install from PyPI

$ pip install sprites-openai-agents

Point it at your Sprites account

$ export SPRITES_API_TOKEN='...'

This adapter reads SPRITES_API_TOKEN rather than SPRITES_TOKEN. The Agents SDK still wants OPENAI_API_KEY of its own.

Know what you're pinning

The Agents SDK's sandbox APIs are beta, so each release of the adapter supports a deliberately narrow openai-agents version range. The source lives in sprites-py under integrations/openai-agents.

Build with OpenRouter Agent SDK

superfly/sprites-openrouter-sdk

Build from the repository

Not on npm yet, and the API may change before the first stable release.

Point it at your Sprites account

$ export SPRITES_TOKEN='...'

Create a token from the Sprites dashboard.

Give your Sprite access to external APIs

Connect through the Sprites API gateway while keeping provider credentials outside your Sprite. Choose a service and grant access in the dashboard.

Available providers can vary by organization during rollout. Your dashboard shows which connectors you can enable.

Meta (Muse Spark) Meta

Connector · BYOK

Call Muse Spark from a Sprite while keeping your Meta API key outside the environment.

OpenAI OpenAI

API key · BYOK

Call OpenAI's Responses, Chat Completions and Embeddings APIs from a Sprite without an OpenAI key inside it.

TypeSafeAI TypeSafeAI

API key · BYOK

Ask Jev typed questions about your data from a Sprite while keeping your TypeSafeAI key outside it.

Anthropic Anthropic

API key · BYOK

Call Claude models from a Sprite without storing your Anthropic API key inside it.

OpenRouter OpenRouter

API key · BYOK or managed

Access models through OpenRouter with your own key or a Sprites-managed connection.

Ollama Cloud Ollama

API key · BYOK

Use Ollama's cloud-hosted models from a Sprite through the gateway.

GitHub GitHub

OAuth

Give Sprites access to GitHub repositories, issues, and pull requests.

Slack (User) Slack

OAuth · user

Let a Sprite read and post in Slack on your behalf.

Slack (Bot) Slack

OAuth · bot

Let a Sprite work in Slack as a bot rather than as your user.

Discourse Discourse

User API key

Read or post on a Discourse forum from a Sprite with your forum permissions.

S3-compatible Object Store S3-compatible

Access key + secret

Access an S3-compatible bucket without keeping its storage credentials in a Sprite.

Fly.io Machines Fly.io

Fly.io token · preset

Call the Fly Machines API from a Sprite using an organization-scoped token.

Custom API Custom

Token + endpoint

Connect a token-authenticated HTTP API through the Sprites gateway.

Steel Browser Tools Steel

API key · BYOK

Stateless scraping, screenshots, and PDFs without storing your key on a Sprite.

Linkup Linkup

API key · BYOK

Search the web and fetch pages without putting your key on a Sprite.

Firecrawl Firecrawl

API key · BYOK

Scrape, search, and map websites without putting your key on a Sprite.

Deepgram Deepgram

API key · BYOK

Prerecorded speech recognition and HTTP text-to-speech with your own Deepgram key.

Fireworks Fireworks

API key · BYOK

OpenAI-compatible inference without storing your Fireworks key on a Sprite.

Parasail Parasail

API key · BYOK

OpenAI-compatible inference without storing your Parasail key on a Sprite.

Depot build insights Depot

API token · BYOK · read-only

Read container-build status and project metadata without storing a Depot token on a Sprite.

Upstash Redis Upstash

REST URL + token · BYOK

Read and write Redis data over HTTP without placing your database token on a Sprite.

Tigris Tigris

Access-key ID + secret · BYOK

Create private Tigris buckets without placing an admin key on your Sprite.

AgentMail AgentMail

API key · BYOK

Send and receive email from a Sprite without exposing your AgentMail key.

Resend Resend

API key · BYOK

Send email from a Sprite through Resend without putting your API key on it.

Neon Neon

API key · BYOK

Create and branch Neon Postgres databases from a Sprite without putting your API key on it.

ElevenLabs ElevenLabs

API key · BYOK

Build and run ElevenLabs voice agents from a Sprite without putting your API key on it.

SenseLab SenseLab

API key · BYOK

Share agent memory, briefings and outcomes across disposable Sprites.

Blotato Blotato

API key · BYOK

Publish to existing social accounts through Blotato without exposing its API key.

Keenable Keenable

API key · BYOK

Search with Keenable without placing its key on a Sprite.

LemonSlice LemonSlice

API key · BYOK

Read the history and status of existing LemonSlice sessions.

Mnemom Mnemom

API key · BYOK

Read Mnemom trust and agent information without storing the API key on a Sprite.

Era Era

API key · BYOK

Read linked banking data through Era without exposing a banking API key.

Composio Tools Composio Tools

API key · BYOK

Discover and execute tools against existing Composio connected accounts.

Supabase Database Supabase Database

Project URL + secret key · BYOK

Access a hosted Supabase project's REST database API without exposing its secret key.

Usable Usable

API key · BYOK

Use your Usable workspace knowledge through its authenticated MCP service.

Exa Exa

API key · BYOK

Search the web and retrieve page contents without storing your Exa key on a Sprite.

Integration	Ships	Auth	Repository
Claude Code	MCP Skills Hooks	Browser OAuth	superfly/sprites-claude-plugin
Codex	MCP Skills	Browser OAuth	superfly/sprites-codex-plugin
Cursor	MCP Skills	Browser OAuth	superfly/sprites-cursor-plugin
Antigravity	MCP Skills Commands Hooks	Browser OAuth	superfly/sprites-antigravity-plugin
Grok Build	MCP Skills	Browser OAuth	superfly/sprites-grok-plugin
Cortex Code	MCP Skills Commands Hooks	Browser OAuth	superfly/sprites-cortex-plugin
DeepSeek Harness	MCP Skills	Browser OAuth	superfly/sprites-deepseek-plugin
OpenCode	MCP Skills Commands Hooks	Browser OAuth	superfly/sprites-opencode-plugin
π Pi	SDK Skills	API token	superfly/pi-sprites
VS Code	Filesystem	API token	superfly/sprites-vscode-ext
Herdr	Sandbox Commands Filesystem	Sprite CLI	superfly/herdr-sprites-plugin
Hermes Agent	Sandbox	API token	NousResearch/hermes-plugin-sprites
Any MCP client	MCP	Browser OAuth	superfly/sprites-mcp
Agent Plugins v1	MCP Skills	Browser OAuth	superfly/sprites-agent-plugin

Which agent are you using?

Set up Sprites for Claude Code

Set up Sprites for Codex

Set up Sprites for Cursor

Set up Sprites for Antigravity

Set up Sprites for Grok Build

Set up Sprites for Cortex Code

Set up Sprites for DeepSeek Harness

Set up Sprites for OpenCode

π Set up Sprites for Pi

Set up Sprites for VS Code

Set up Sprites for Herdr

Set up Sprites for Hermes Agent

Set up Sprites for Any MCP client

Set up Sprites for Agent Plugins v1

Which language are you building in?

Build with Python

Build with JavaScript

Build with Go

Build with Elixir

Build with Google ADK

Build with OpenAI Agents SDK

Build with OpenRouter Agent SDK

Give your Sprite access to external APIs

Use Sprites with Meta (Muse Spark)

Use Sprites with OpenAI

Use Sprites with TypeSafeAI

Use Sprites with Anthropic

Use Sprites with OpenRouter

Use Sprites with Ollama Cloud

Use Sprites with GitHub

Use Sprites with Slack (User)

Use Sprites with Slack (Bot)

Use Sprites with Discourse

Use Sprites with S3-compatible Object Store

Use Sprites with Fly.io Machines

Use Sprites with Custom API

Use Sprites with Steel Browser Tools

Use Sprites with Linkup

Use Sprites with Firecrawl

Use Sprites with Deepgram

Use Sprites with Fireworks

Use Sprites with Parasail

Use Sprites with Depot build insights

Use Sprites with Upstash Redis

Use Sprites with Tigris

Use Sprites with AgentMail

Use Sprites with Resend

Use Sprites with Neon

Use Sprites with ElevenLabs

Use Sprites with SenseLab

Use Sprites with Blotato

Use Sprites with Keenable

Use Sprites with LemonSlice

Use Sprites with Mnemom

Use Sprites with Era

Use Sprites with Composio Tools

Use Sprites with Supabase Database

Use Sprites with Usable

Use Sprites with Exa

Use Sprites with your platform

Use Sprites with TanStack AI

Use Sprites with Claude Managed Agents

Use Sprites with Anthropic Connectors Directory

QM Use Sprites with QM

Use Sprites with Cursor Cloud Agents

Straight to the source

What your agent can do with it

Run the risky stuff somewhere else

Checkpoint before it breaks things

Keep services running between sessions

Confirm before anything destructive

$30 in trial credits. Create, like, 500 Sprites free.