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.surf and .context/ directory can be dropped directly into any code repository.

  • Generates ARDS v5.2 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
InstallBASH
# 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
UsageBASH
# 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
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.surf and surfcontext.json from the project root — resolving CONTEXT.surf first and falling back to CONTEXT.md for legacy projects. The format is CC-BY-SA 4.0 licensed — free to implement and distribute.