@memstate/setup

Set up Memstate AI persistent memory for your AI coding agent in seconds.

npx @memstate/setup

Detects your AI agent environment (Claude Code, Cursor, Cline, Windsurf, Kilo Code, Claude Desktop) and installs the Memstate MCP server config and/or skill file automatically.

What it installs

MCP server config (recommended — default)

Writes the Memstate server stanza into your agent's MCP config file so tools like memstate_get, memstate_remember, and memstate_search are available in every session.

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": { "MEMSTATE_API_KEY": "your_key_here" }
    }
  }
}

Skill file (optional)

Installs SKILL.md to the correct location for skill-based agents (Claude Code, Kilo Code, Cursor rules, etc.) and appends workflow instructions to CLAUDE.md / .clinerules / etc.

Usage

npx @memstate/setup                   # Interactive setup (recommended)
npx @memstate/setup --mcp             # MCP config only
npx @memstate/setup --skill           # Skill file only
npx @memstate/setup --mcp --skill     # Both
npx @memstate/setup --path ~/my/proj  # Custom project root
npx @memstate/setup --yes             # Accept all defaults
npx @memstate/setup --help            # Full help

Options

| Flag | Description | |------|-------------| | --mcp | Install MCP server config | | --skill | Install SKILL.md | | --path <dir> | Use a custom project root | | --global, -g | Prefer global (user-level) install | | --project | Prefer project-level install (default) | | --yes, -y | Accept all defaults without prompting | | --help, -h | Show help | | --version, -v | Show version |

Get a free API key

memstate.ai/dashboard/api-keys — free to sign up, no credit card required.

Links

• Docs: https://memstate.ai/docs
• GitHub: https://github.com/memstate-ai/memstate-skills
• npm: https://www.npmjs.com/package/@memstate/setup