English Français العربية

StateDock

Official registry Productivity

Shared task layer for AI agents: tasks, handoffs and decisions that persist across tools.

Source code Website Documentation

What can you do with StateDock?

  • Codex: available from the plugin repository's local marketplace; installation is documented in its README.
  • DeepSeek Harness: @statedock/dsh-plugin is published for Harness 0.2.0-rc.2; see the official community showcase.
  • ChatGPT app: submitted to OpenAI for review; approval is pending.
  • Cursor: Marketplace submission materials are being prepared; installation and approval are not yet verified.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http statedock 'https://statedock.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "statedock": {
            "type": "http",
            "url": "https://statedock.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. StateDock
  2. Coding-tool plugins
  3. Development checks
  4. License

StateDock

Shared project memory for you and your coding agents.

Goals, decisions and handoffs live in one place. Claude Code, Cursor and Codex read context over MCP, pick up ready work and write back handoffs, so the next agent never starts from zero.

This repository is the Cloudflare self-hosted edition. Deploy it in your own Cloudflare account; you operate its Workers, D1, KV, R2, domain, email delivery, and backups. It is separate from StateDock Cloud and has no Cloud subscription tiers. To run StateDock on your own computer or a Linux server with one command, use StateDock Local instead.

Coding-tool plugins

StateDock's separate MIT plugin repository provides shared Skills for saving plans, restoring task context, and recording progress through StateDock Remote MCP. The current packages target the hosted service at https://statedock.dev/mcp; self-hosted deployments can use the Skills with their own MCP setup, but the published packages' default endpoint is the hosted service.

  • Codex: available from the plugin repository's local marketplace; installation is documented in its README.
  • DeepSeek Harness: @statedock/dsh-plugin is published for Harness 0.2.0-rc.2; see the official community showcase.
  • ChatGPT app: submitted to OpenAI for review; approval is pending.
  • Cursor: Marketplace submission materials are being prepared; installation and approval are not yet verified.

These plugins record and restore project state. They do not execute task code or schedule agents. Plugin code is MIT-licensed; this self-hosted service remains AGPL-3.0-only.

For a complete local install, use the deployment guide above. It covers the required Cloudflare resources, verified email sender, public HTTPS origin, secrets, migrations, deployment, administrator approval, and agent access. The operations guide contains offline backup and recovery steps.

Development checks

Requirements and the repository's checks are listed in CONTRIBUTING.md. Typical verification:

pnpm install --frozen-lockfile
pnpm test
pnpm typecheck
pnpm lint
pnpm format:check
pnpm selfhost:check

License

StateDock is licensed under AGPL-3.0-only. Dependencies retain their own licenses; see THIRD_PARTY_NOTICES.md. The license does not grant rights to StateDock trademarks or imply official endorsement of third-party instances.

Frequently asked questions

What is StateDock?

Shared task layer for AI agents: tasks, handoffs and decisions that persist across tools.

How do I install StateDock?

It runs as a remote server. In Claude Code: claude mcp add --transport http statedock 'https://statedock.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does StateDock need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is StateDock open source?

Yes. Its code is on GitHub under the AGPL-3.0 license.

Who maintains StateDock?

It is published by statedock. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.