Tools

Create and manage SurfContext projects with these tools.

SurfDoc

The document workspace with native SurfContext support.

SurfDoc

Export your workspace as a SurfContext package

Available

SurfDoc is a typed document format and workspace at doc.surf. Export your entire workspace — docs, tasks, team context, agent configurations — as a SurfContext-conformant package. The exported CONTEXT.md and .context/ directory can be dropped directly into any code repository.

  • Generates ARDS v3.0 conformant output
  • Includes version ledger for change tracking
  • Exports agent definitions with proper frontmatter
  • Maps team knowledge to .context/docs/ format
Visit doc.surf

WaveSite

Build websites from SurfDoc files with SurfContext built in.

WaveSite

AI website builder with native .surf format and SurfContext integration

Available

WaveSite at wave.site builds websites from SurfDoc files. Every WaveSite project uses the .surf format natively, and SurfContext can be used to define project context for AI-assisted site generation and management.

  • Builds sites from .surf files with 37 typed block types
  • AI chat generates SurfDoc specs, compiler builds the site
  • Custom domains, SEO, contact forms, visitor chat
  • Free tier + Pro at $12/mo
Visit wave.site

Surf CLI

Command-line tool for initializing and managing projects.

Surf CLI

Project scaffolding, AI chat, and CloudSurf account access from the terminal

Available

The Surf CLI manages SurfContext projects and connects to CloudSurf services — all from the command line.

  • `init` / `sync` / `validate` — Scaffold, sync, and validate SurfContext projects
  • `login` / `whoami` — Authenticate with your CloudSurf account
  • `chat` / `ask` — Interactive AI chat or one-shot queries
  • `tasks` / `docs` / `status` — Manage workspace tasks and documents
# macOS / Linux — one-line install
curl -fsSL https://raw.githubusercontent.com/cloudsurf-software/surfcontext-cli/main/scripts/install.sh | sh

# macOS — Homebrew
brew install cloudsurf-software/tap/surf

# From source
cargo install --git https://github.com/cloudsurf-software/surfcontext-cli
# Initialize a new SurfContext project
surf init

# Sign in to your CloudSurf account
surf login

# Start an AI chat session
surf chat

# Ask a one-shot question
surf ask "How do I add a contact form?"

# Manage tasks
surf tasks
surf tasks create "Build landing page"
surf tasks done 3

Surf MCP Server

Expose .context/ content as MCP tools for any AI agent.

Surf MCP Server

Bridges ARDS documentation into any MCP-compatible AI agent

Coming Q2 2026

The Surf MCP Server exposes your project context, agents, docs, guides, and plans as standardized MCP tools that any compatible AI agent can call.

  • Read context, agents, docs, guides, and plans via MCP tools
  • Search across all ARDS content in your project
  • Works with any MCP-compatible AI agent or IDE
  • Zero configuration — auto-discovers .context/ directory
Info: Building a tool?

SurfContext is an open standard. If you are building a developer tool or AI coding agent, you can add SurfContext support by reading `CONTEXT.md` and `surfcontext.json` from the project root. The format is CC-BY-SA 4.0 licensed — free to implement and distribute.