cursor-mem

Cursorでclaude-memのMCPサーバーにアクセスし、過去のセッション記録を検索・新しい観測を記録。トリガー: 'メモリ検索', 'claude-mem', '過去の判断', '記録して', 'memory search', 'past decisions'. Do NOT load for: 通常のコーディング、一時的なメモ、実装作業。

16 stars

Best use case

cursor-mem is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Cursorでclaude-memのMCPサーバーにアクセスし、過去のセッション記録を検索・新しい観測を記録。トリガー: 'メモリ検索', 'claude-mem', '過去の判断', '記録して', 'memory search', 'past decisions'. Do NOT load for: 通常のコーディング、一時的なメモ、実装作業。

Teams using cursor-mem should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/cursor-mem/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/ai-agents/cursor-mem/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/cursor-mem/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How cursor-mem Compares

Feature / Agentcursor-memStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Cursorでclaude-memのMCPサーバーにアクセスし、過去のセッション記録を検索・新しい観測を記録。トリガー: 'メモリ検索', 'claude-mem', '過去の判断', '記録して', 'memory search', 'past decisions'. Do NOT load for: 通常のコーディング、一時的なメモ、実装作業。

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Cursor-Mem Integration Skill

CursorからClaude-memを活用するスキル。Claude CodeとCursorで同じメモリデータベースを共有し、セッション間の知識を引き継ぎます。

## 🎯 使用場面

### 検索(読み取り)
- **過去の意思決定を確認**: 「なぜこのアーキテクチャを選んだのか?」
- **パターンの参照**: 「以前はどのように実装したか?」
- **バグ修正履歴**: 「同様の問題を過去に解決したか?」
- **技術選定の理由**: 「なぜこのライブラリを使っているのか?」

### 記録(書き込み)
- **PMとしての判断をメモ**: レビュー中の気付きや設計判断
- **パターンの記録**: 再利用可能なソリューション
- **引き継ぎ事項**: 次のセッションやチームメンバーへの情報
- **学習事項**: トラブルシューティングで得た知見

## 📋 利用可能なMCPツール

Cursor上でclaude-memのMCPツールを直接利用できます:

### 検索系
- `mcp__claude-mem__search`: キーワードでメモリを検索
- `mcp__claude-mem__timeline`: 時系列で記録を取得
- `mcp__claude-mem__get_recent_context`: 最近の文脈を取得
- `mcp__claude-mem__get_observation`: 特定の観測を取得

### 書き込み系
- `mcp__claude-mem__create_entities`: 新しいエンティティを作成
- `mcp__claude-mem__create_relations`: エンティティ間の関連を作成
- `mcp__claude-mem__add_observations`: 観測を追加

## 🔧 セットアップ

### 1. MCPラッパースクリプトの配置

```bash
# harness リポジトリ内に claude-mem-mcp がインストールされている前提
# 絶対パスで参照
HARNESS_PATH="/path/to/claude-code-harness"
```

### 2. Cursor MCP設定

プロジェクトルートに `.cursor/mcp.json` を作成:

```json
{
  "mcpServers": {
    "claude-mem": {
      "type": "stdio",
      "command": "/absolute/path/to/claude-code-harness/scripts/claude-mem-mcp"
    }
  }
}
```

**⚠️ 重要**: `command` には絶対パスを指定してください。

### 3. Cursor再起動

設定後、Cursorを再起動してMCPサーバーを認識させます。

## 💡 使い方の例

詳細な使用例は [examples.md](./examples.md) を参照してください。

### 基本的な検索

```
ユーザー: 「認証方式の選定理由を確認したい」

Cursor(Composer):
mcp__claude-mem__search を使用
→ クエリ: "認証 JWT Supabase 選定理由"
→ 過去の決定記録(decisions)を取得
```

### 気付きの記録

```
ユーザー: 「この実装パターンを記録しておいて」

Cursor(Composer):
mcp__claude-mem__add_observations を使用
→ タイプ: pattern
→ タグ: source:cursor, review, best-practice
→ 内容: 実装パターンの説明
```

## 🏷️ タグ規約

Claude CodeとCursorで統一されたタグ体系を使用します:

| タグ | 用途 |
|------|------|
| `source:cursor` | Cursorから記録された情報 |
| `source:claude-code` | Claude Codeから記録された情報 |
| `type:decision` | 意思決定の記録 |
| `type:pattern` | 再利用可能なパターン |
| `type:bug` | バグ修正の記録 |
| `type:review` | レビューでの気付き |
| `type:handoff` | 引き継ぎ事項 |

## 🔄 Claude Code との連携

### データ共有

- Claude CodeとCursorは同じSQLiteデータベース(`~/.claude-mem/claude-mem.db`)を使用
- WALモードで並行書き込みに対応
- リアルタイムでデータが共有される

### 推奨ワークフロー

1. **Cursor(PM役)**: 設計判断やレビュー結果を記録
2. **Claude Code(実装役)**: 過去の判断を参照しながら実装
3. **双方向検索**: どちらからでも過去の記録を検索可能

## ⚠️ 注意事項

### パフォーマンス

- 初回検索時はワーカー起動に2-3秒かかる場合があります
- 2回目以降はワーカーが常駐するため高速

### セキュリティ

- メモリデータベースはローカル環境にのみ保存されます
- 機密情報を記録する場合は注意してください

### トラブルシューティング

**問題**: MCPツールが認識されない
**解決策**:
1. `.cursor/mcp.json` のパスが正しいか確認
2. スクリプトが実行可能か確認: `chmod +x scripts/claude-mem-mcp`
3. Cursorを再起動

**問題**: ワーカーが起動しない
**解決策**:
1. ヘルスチェック: `curl http://127.0.0.1:37777/health`
2. 手動起動: `node ~/.claude/plugins/cache/thedotmack/claude-mem/*/scripts/worker-cli.js start`

## 📚 参考資料

- [Claude-mem 公式ドキュメント](https://github.com/thedotmack/claude-mem)
- [Cursor MCP 設定ガイド](https://cursor.com/docs/context/mcp)
- [使用例集](./examples.md)
- [統合ガイド](../../docs/guides/cursor-mem-integration.md)

Related Skills

cursor

16
from diegosouzapw/awesome-omni-skill

Translates task requirements into Cursor CLI commands. Used by cursor-driver agent to execute coding tasks via Cursor.

cursor-rules-synchronizer

16
from diegosouzapw/awesome-omni-skill

Synchronizes Cursor Rules (.mdc files in .cursor/rules/) to CLAUDE.md by generating a Rules section with context-efficient descriptions and usage instructions. Use when setting up Cursor Rules for the first time, after adding or modifying rules, or when the Rules section in CLAUDE.md is missing or outdated.

cursor-rules-review

16
from diegosouzapw/awesome-omni-skill

Audit Cursor IDE rules (.mdc files) against quality standards using a 5-gate review process. Validates frontmatter (YAML syntax, required fields, description quality, triggering configuration), glob patterns (specificity, performance, correctness), content quality (focus, organization, examples, cross-references), file length (under 500 lines recommended), and functionality (triggering, cross-references, maintainability). Use when reviewing pull requests with Cursor rule changes, conducting periodic rule quality audits, validating new rules before committing, identifying improvement opportunities, preparing rules for team sharing, or debugging why rules aren't working as expected.

cursor-best-practices

16
from diegosouzapw/awesome-omni-skill

Best practices for using Cursor—rules, commands, skills, subagents, ignore files, Agent security, workflows, and community resources. Use when setting up Cursor, initializing or creating the .cursor folder, writing .cursor/rules or AGENTS.md, creating commands or skills, configuring .cursorignore, working with Agent, discovering rules or MCPs (e.g. cursor.directory), making codebases cursor-compatible, or asking about Cursor workflows, TDD, git commands, or large codebases.

cursor-agent

16
from diegosouzapw/awesome-omni-skill

Use the Cursor CLI (agent) for software engineering tasks. Includes installation, auth, commands, terminal-based automation, and best practices for AI coding workflows.

python-fastapi-scalable-api-cursorrules-prompt-fil

16
from diegosouzapw/awesome-omni-skill

Apply for python-fastapi-scalable-api-cursorrules-prompt-fil. --- description: Defines conventions specific to FastAPI usage in the backend. globs: backend/src/**/*.py

python-django-best-practices-cursorrules-prompt-fi

16
from diegosouzapw/awesome-omni-skill

Apply for python-django-best-practices-cursorrules-prompt-fi. --- description: Configurations for Django settings file with the list of dependencies and conventions. globs: **/settings.py

optimise-cursor-repo

16
from diegosouzapw/awesome-omni-skill

Audit a repository and produce prioritised recommendations for improving Cursor performance and developer experience. Use when the user wants to optimise their repo for Cursor, improve indexing, add rules, or assess their Cursor configuration.

laravel-tall-stack-best-practices-cursorrules-prom-cursorrules

16
from diegosouzapw/awesome-omni-skill

Apply for laravel-tall-stack-best-practices-cursorrules-prom. --- description: Laravel specific best practices for different modules and features. globs: /**/*.php

go-servemux-rest-api-cursorrules-prompt-file

16
from diegosouzapw/awesome-omni-skill

Apply for go-servemux-rest-api-cursorrules-prompt-file. --- description: This rule emphasizes security, scalability, and maintainability best practices in Go API development. globs: /*/**/*_api.go

go-backend-scalability-cursorrules-prompt-file-cursorrules

16
from diegosouzapw/awesome-omni-skill

Apply for go-backend-scalability-cursorrules-prompt-file. --- description: General rule for backend development expertise across the project. globs: **/*

bgo

10
from diegosouzapw/awesome-omni-skill

Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.

Coding & Development