FAQ

Supaspec is a SaaS platform for developers who use AI coding agents. It stores versioned implementation plans (specs) that are accessible to both humans and AI agents via the MCP protocol.

In AI-assisted development, the implementation spec is the real intellectual property — not the generated code. Supaspec treats specs as a first-class asset: versioned, editable, searchable, and accessible to AI agents. No more scattering plans across Notion, markdown files, and chat threads.

Supaspec is free during beta. A Pro plan with additional features will launch later. See the Pricing page.

Any MCP-compatible tool works, including Claude Code, Cursor, Codex, Windsurf, and Copilot. See MCP Setup for configuration instructions.

No. One API key and one config block works across all your tools. Each tool identifies itself via the agent_name parameter.

Agents self-identify via the agent_name parameter on every write operation. This is tracked in version history and displayed in the UI.

Technically yes, but it's impractical since you control your own API keys and tools. Agent identification serves attribution purposes, not security.

Supaspec versioning is purpose-built for specs. It includes structured commit messages (message + description + prompt), agent/user attribution, proposals with PR-style review, and full-attribution diffs — all without needing to learn git.

Commits apply changes immediately and create a new version. Proposals create a suggestion that awaits review before being applied — like a pull request.

Yes. Click Restore on any version in the revision log. This creates a new version with the restored content (non-destructive — no history is lost).

Yes. Download a single section as .md or the entire project as a .zip of markdown files.

API keys are stored as SHA-256 hashes. The full key is displayed only once when generated — we cannot retrieve it afterward.

Yes. All team members can view changes, versions, and agent activity. Access is controlled via project membership with role-based permissions.

Content is stored in PostgreSQL with database-level security (encrypted at rest and in transit) but is not end-to-end encrypted. This allows server-side features like search, diffs, and proposals.

Yes. You can delete your account and all associated data from the Settings page. All projects, sections, versions, and agent records will be permanently removed.

Check that your API key is correct (starts with ss_), you're using https://, and the URL is https://supaspec.dev/api/mcp.

Agents are auto-registered on their first write operation. Read-only operations (listing projects, reading sections) don't create agent records.

Refresh the page. Supaspec does not yet support real-time collaborative editing. Changes will appear after a page reload.