mcpField
R
Remembering Conversations

Remembering Conversations

github.com/obraAgent workflows755516 installsUpdated 54w ago
Repository

About Remembering Conversations

Remembering Conversations is a skill for searching archived conversations by semantic similarity or exact text. It is intended for finding prior decisions, patterns, or related debugging discussions before repeating familiar work.

Key features

  1. 01Search by semantic similarity
  2. 02Match exact text
  3. 03Filter results by date
  4. 04Limit the number of results
  5. 05Return conversation and match details

Use cases

  1. 01Find a prior architectural decision
  2. 02Review discussion of a similar bug
  3. 03Locate a specific string or Git SHA

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/obra/superpowers-skills --skill remembering-conversations

After installing, type/remembering-conversationsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

INDEXING.md
DEPLOYMENT.md
tool/
.gitignore
index-conversations
package.json
migrate-to-config.sh
package-lock.json
install-hook
search-conversations
tsconfig.json
test-install-hook.sh
test-deployment.sh
tool/hooks/
sessionEnd
tool/prompts/
search-agent.md
tool/src/
db.test.ts
db.ts
index-cli.ts
embeddings.ts
parser.ts
search-agent-template.test.ts
paths.ts
indexer.ts
search.ts
search-cli.ts
types.ts
summarizer.ts
verify.ts
verify.test.ts

Details

From the project README

Remembering Conversations

Search archived conversations using semantic similarity or exact text matching.

Core principle: Search before reinventing.

Announce: "I'm searching previous conversations for [topic]."

Setup: See INDEXING.md

When to Use

Search when:

  • Your human partner mentions "we discussed this before"
  • Debugging similar issues
  • Looking for architectural decisions or patterns
  • Before implementing something familiar

Don't search when:

  • Info in current conversation
  • Question about current codebase (use Grep/Read)

In-Session Use

Always use subagents (50-100x context savings). See skills/using-skills for workflow.

Manual/CLI use: Direct search (below) for humans outside Claude Code sessions.

Direct Search (Manual/CLI)

Tool: ${SUPERPOWERS_SKILLS_ROOT}/skills/collaboration/remembering-conversations/tool/search-conversations

Modes:

search-conversations "query"              # Vector similarity (default)
search-conversations --text "exact"       # Exact string match
search-conversations --both "query"       # Both modes

Flags:

--after YYYY-MM-DD    # Filter by date
--before YYYY-MM-DD   # Filter by date
--limit N             # Max results (default: 10)
--help                # Full usage

Examples:

# Semantic search
search-conversations "React Router authentication errors"

# Find git SHA
search-conversations --text "a1b2c3d4"

# Time range
search-conversations --after 2025-09-01 "refactoring"

Returns: project, date, conversation summary, matched exchange, similarity %, file path.

For details: Run search-conversations --help

Comments

Markdown supported