🍡 mochi

SSR framework for Svelte 5 + Bun with islands-based selective hydration

On this page

LLM integrations

Mochi provides several different ways of integrating LLMs to improve your development experience. We primarily recommend to use either the Agent skill or the MCP server. Both will augment your development experience with up-to-date documentation and how-to’s on how to do various tasks in Mochi. You can also use the older llms.txt format.

Mochi publishes a SKILL.md — agent guidance that tells a coding assistant to fetch the relevant docs and demos from /llms.txt before writing framework code. Pull the latest copy into your project with the CLI:

bunx mochi-framework update-skill [agent]

This fetches https://mochi.fast/SKILL.md and writes it into your project, creating the file if it does not exist or overwriting it if it does. Run it again whenever you upgrade the framework to keep the guidance in sync.

The optional agent argument controls where the skill is written (default: claude-code):

AgentDestination
claude-code.claude/skills/mochi/SKILL.md
opencode.opencode/skills/mochi/SKILL.md
antigravity (agy).agents/skills/mochi/SKILL.md
codex.agents/skills/mochi/SKILL.md

Mochi runs an official remote MCP server at https://mochi.fast/mcp (HTTP transport). It exposes the same docs and demos as the skill — get_documentation_sections to list everything and get_section to read specific pages — so an assistant can pull exactly the context it needs. Add it to your tool of choice below.

Claude Code

Run:

claude mcp add -t http -s project mochi https://mochi.fast/mcp

This adds the server at project scope (shared via .mcp.json); pass -s user or -s local instead to change that. (For the skill-based alternative, see Agent skill above.)

Claude Desktop
  1. Open Settings > Connectors
  2. Click Add Custom Connector
  3. Name it mochi
  4. Set the remote MCP server URL to https://mochi.fast/mcp
  5. Click Add
Codex CLI

Add to ~/.codex/config.toml:

experimental_use_rmcp_client = true
[mcp_servers.mochi]
url = "https://mochi.fast/mcp"
Copilot CLI

Run /mcp add, or edit ~/.copilot/mcp-config.json:

{ "mcpServers": { "mochi": { "url": "https://mochi.fast/mcp" } } }
Antigravity Editor

Open the MCP store via the ”…” dropdown at the top of the editor’s agent panel, click Manage MCP Servers, then View raw config, and add the server to the config:

{ "mcpServers": { "mochi": { "type": "http", "serverUrl": "https://mochi.fast/mcp" } } }
Antigravity CLI (previously Gemini)

Edit ~/.gemini/config/mcp_config.json and add the server:

{ "mcpServers": { "mochi": { "type": "http", "serverUrl": "https://mochi.fast/mcp" } } }
OpenCode

Run opencode mcp add, choose Remote, name it mochi, and enter https://mochi.fast/mcp.

VS Code
  1. Open the command palette
  2. Select MCP: Add Server…
  3. Choose HTTP (HTTP or Server-Sent-Events)
  4. Enter https://mochi.fast/mcp and press Enter
  5. Name it mochi
  6. Choose Global or Workspace scope
Cursor

Open the command palette, select View: Open MCP Settings, click Add custom MCP, and add:

{ "mcpServers": { "mochi": { "url": "https://mochi.fast/mcp" } } }
GitHub Coding Agent

In your repo, go to Settings > Copilot > Coding agent, edit the MCP configuration, then save:

{ "mcpServers": { "mochi": { "type": "http", "url": "https://mochi.fast/mcp", "tools": ["*"] } } }
Other clients

Refer to your client’s documentation for adding a remote MCP server and use https://mochi.fast/mcp as the URL.

llms.txt

/llms.txt is the index: a title, a one-line summary, and a linked list of every doc (## Docs) and demo (## Examples), each pointing at its own plain-text file. The concatenated bundles below are linked under ## Optional. Start here.

All docs concatenated

The full set of docs, concatenated in reading order, is served at /llms-recommended.txt. Use this when you want the model to have the complete picture of the framework API in one paste.

Docs + demo source

/llms-full.txt includes everything in /llms-recommended.txt plus the source of every demo (.svelte and .ts files), grouped by demo name. Use this when the model needs both the API and real working examples.

Per-document text

Each individual doc is reachable as plain text at /docs/<slug>/llms.txt:

The “Copy as llms.txt” button on each doc page emits just that page — use it to give the model focused context without the rest of the framework.

Per-demo source

Each demo’s source is reachable as plain text alongside its demo page — usually /demos/<slug>/llms.txt. It’s the exact source /llms-full.txt bundles for that demo, scoped to one demo:

Machine-readable index

/llms.json returns a JSON index of every doc and demo — each with its title, description, and an absolute url to its llms.txt. Use it to discover what’s available and fetch each piece on demand:

{
  "docs": [{ "title": "Welcome", "description": "", "url": "https://mochi.fast/docs/intro/llms.txt" }],
  "demos": [{ "title": "Hello World", "description": "", "url": "https://mochi.fast/demos/hello-world/llms.txt" }]
}