Skip to the content
Surface

AI

Plugins

The plugin for Claude Code, Codex CLI and Cursor, and what it holds.This page as Markdown
Statuscurrent on 2026-11-06, for version 0.
Related documentsSurface for agents, MCP server, skills
A plugin puts the tools of Surface into an agent with one install. The plugin surface has one source for Claude Code, Codex CLI and Cursor. It is in plugins/surface of the repository.
Part
Name
What it does
MCP server
surface
Starts surf mcp. The surf command must be on the PATH.
Skill
surface-code-writer
The steps with the tools of the MCP server.
Skill
surface-best-practices
The rules of Surf.
Subagent
surface-file-editor
Edits .surf and .surfs files, and repeats the checks until they pass.
Rule
rules/surface.mdc
A rule of Cursor for .surf and .surfs files.
The repository is private until version 1. An install from its address needs access to the repository.

1. Claude Code

  • Add the marketplace of the repository:
  • text
    /plugin marketplace add https://git.solenovis.com/henning.liemant/surface
  • Install the plugin:
  • text
    /plugin install surface@solenovis
The marketplace is .claude-plugin/marketplace.json at the root of the repository. Its name is solenovis.

2. Codex CLI

  • Add the marketplace:
  • bash
    codex plugin marketplace add https://git.solenovis.com/henning.liemant/surface
  • Run /plugins in codex.
  • Install surface.

3. Cursor

The plugin has the folder .cursor-plugin for Cursor. Without the plugin, do these two steps:
  • Add the MCP server in the MCP settings of Cursor.
  • Copy plugins/surface/rules/surface.mdc into .cursor/rules of your project.

4. Other agents

An agent with no plugins can use each part alone: