agents-remember

Install For Cursor

Cursor supports native Agent Skills, project rules, project hooks, and project-local MCP configuration.

Official references:

• Cursor Rules
• Cursor Hooks
• Cursor MCP
• Cursor Agent Skills

Root Starter Package

The repository includes a Cursor starter package at .cursor/. Copy that folder to your workspace root, then render the copied package. The .cursor/render-starter script is a convenience: with a single --repo list such as --repo my-app shared-lib, it infers the workspace root from the copied .cursor/ folder, fills path and repository placeholders, writes the Python hook command, and validates that each requested repository exists before you open or restart the workspace in Cursor once. If you prefer not to run the renderer, make those same replacements by hand and verify that no placeholder tokens remain.

The package contains:

• .cursor/rules/agents-remember.mdc - always-applied first-action instruction.
• .cursor/hooks.json and .cursor/hooks/agents-remember-session-start.py - project sessionStart hook that injects the same startup directive.
• .cursor/mcp.json - project-local Cursor MCP registration.
• .cursor/mcp/agents-remember-settings.json - Agents Remember MCP authority settings.
• .cursor/skills/ - Agents Remember skills for Cursor Agent.

After the restart, invoke:

c-13-install-and-onboard

That skill runs or verifies runtime_install() and then handles memory, onboarding, and providers.

Persistent Instructions

Use the packaged Cursor project rule. Do not overwrite a repository’s root AGENTS.md just to wire Agents Remember; root AGENTS.md is project-specific.

The starter package includes .cursor/rules/agents-remember.mdc:

---
description: Agents Remember memory system conventions
alwaysApply: true
---

Read and follow `ar-coordination/AGENTS.md` before working in any sibling project.
Treat these rules as workspace instructions!

@ar-coordination/AGENTS.md

Use an absolute path when ar-coordination is outside the workspace.

Cursor also supports project hooks. The starter package uses a sessionStart hook to inject the startup directive, but the always-applied project rule remains the dependable instruction surface because Cursor documents sessionStart as fire-and-forget.

MCP

Cursor project MCP config lives at .cursor/mcp.json.

{
  "mcpServers": {
    "agents-remember": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--refresh-package",
        "agents-remember-mcp",
        "agents-remember-mcp@latest",
        "--config",
        "<PATH/TO/YOUR/PROJECTS_FOLDER>/.cursor/mcp/agents-remember-settings.json"
      ]
    }
  }
}

Runtime And Skills

After the restart, the copied c-13-install-and-onboard skill runs or verifies:

runtime_install()

Cursor loads skills from .agents/skills, .cursor/skills, ~/.agents/skills, and ~/.cursor/skills; it also supports Claude and Codex compatibility folders. The copied starter package already provides the Agents Remember skills in .cursor/skills/.

Do not run skills_install() for first-run setup. It remains available for manual maintenance and non-package installs.

This site is open source. Improve this page.