Plugins

Installing a plugin

Open Settings → Plugins in the desktop app. Browse the registry, or type a plugin id straight into the install field. Installed plugins land in ~/.replicamd/plugins/<id>/ as ordinary files you can read.

A plugin can be switched off without removing it. What it contributes disappears while it is off and comes back when you switch it on again.

What a plugin is

A plugin is a folder of files plus a replicamd.plugin.json manifest. The manifest is declarative - it describes what the plugin adds; nothing runs on its own.

• commands - appear in the member command palette; run a shell command or prompt the member's AI
• skills - Markdown files mirrored into every member's skills folder
• mcpServers - MCP servers offered to the members that support them
• themes and agentFiles - extra files shipped alongside

{
  "slug": "standup-reporter",
  "name": "Standup reporter",
  "version": "1.0.0",
  "kind": "command",
  "description": "Writes a daily standup from git activity.",
  "contributes": {
    "commands": [
      {
        "id": "standup",
        "title": "Write standup",
        "prompt": "Summarise what changed today."
      }
    ],
    "skills": ["skills/standup.md"],
    "mcpServers": {
      "sqlite": { "command": "mcp-sqlite", "args": ["./data.db"] }
    }
  }
}

Writing your own

Make a folder, add a replicamd.plugin.json and whatever files it needs, then use Install from folder in Settings → Plugins. The plugin is live immediately, and editing the folder and reinstalling is the whole development loop.

When it is ready, sign in to the registry from the same settings page and press publish - the folder goes up as a version. You can also publish from the website: Plugins → Publish a plugin lets you upload your files or write them in the browser.

Connecting your account

Browsing and installing are anonymous. Publishing needs an account, which you create on the website with a username and password or with Google.

In Settings → Plugins, sign in with the same username and password, or paste a personal access token from your account page. Google-only accounts have no password, so they use a token.