# manage-memory

manage-memory controls the conversation memory database in Claude Code through manual syncing, full-text searches, and usage statistics.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/commands/manage-memory.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/manage-memory

## What it does

The `/manage-memory` slash command provides direct control over the indexed chat database. It accepts specific subcommands and delegates operations to Python scripts included with the plugin, relying on Bash and Read tools.

Four operations are available. Running `sync` flushes the active session using the `$CLAUDE_SESSION_ID` variable, while `search` runs a full-text query returning up to 5 matching snippets. The `stats` argument displays database size alongside session, project, and message counts, and `import` parses discussions from `~/.claude/projects` again. Passing an invalid subcommand displays the help reference.

Execution relies strictly on having `python3` available in your system path, because every subcommand triggers a helper script in the background.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/commands/manage-memory.md` — Call it with /manage-memory. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/manage-memory.md` — Call it with /prompts:manage-memory. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/manage-memory.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/manage-memory.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/commands/manage-memory.md

## When to use it
- save the active conversation session directly to the database
- run full-text searches across past discussions
- check database disk footprint and stored message metrics
- re-index project histories found inside `~/.claude/projects`

## Example prompts
- /manage-memory sync
- /manage-memory search "auth middleware"
- /manage-memory stats

## Similar
- [context-memory](https://affpapa.org/en/nevibecode/plugins/context-memory.md) — plugin · ★ 1013 repo stars
- [Mneme Memory](https://affpapa.org/en/nevibecode/mcp/mneme-memory.md) — MCP server · ★ 250 repo stars
- [ai-memory](https://affpapa.org/en/nevibecode/mcp/ai-memory.md) — MCP server · ★ 58 repo stars
- [State Memory MCP](https://affpapa.org/en/nevibecode/mcp/state-memory-mcp.md) — MCP server · ★ 44 repo stars
- [lean-memory](https://affpapa.org/en/nevibecode/mcp/lean-memory.md) — MCP server · ★ 43 repo stars
- [memory-specialist](https://affpapa.org/en/nevibecode/agents/memory-specialist.md) — subagent · ★ 189 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
