Skip to main content

Synopsis

profclaw memory <subcommand> [flags]

Description

memory manages profClaw’s context memory index. The memory system indexes files and conversation history into chunks that are retrieved during agent execution to provide relevant context. Commands let you search the index, trigger a sync from disk, inspect what is indexed, and clear everything.

Subcommands

SubcommandAliasDescription
search <query>-Search memory for relevant chunks
stats-Show index statistics
sync-Sync memory index from disk files
fileslsList all indexed files
clear-Delete all memory chunks and the index

memory search <query>

Performs a semantic search over the memory index and returns the most relevant chunks.
query
string
required
Search query string. Matched semantically against indexed content.
-l, --limit
string
default:"10"
Maximum number of chunks to return.
--json
boolean
Output as JSON with scores, file paths, and content.

memory stats

--json
boolean
Output statistics as JSON including chunk count, file count, token estimate, embedding model, and last sync time.

memory sync

Crawls the configured memory directories and updates the index - adding new files, updating changed files, and removing deleted files.
--json
boolean
Output sync result as JSON with counts for added, updated, and removed chunks.

memory clear

--yes
boolean
Skip the confirmation prompt. Required for non-interactive use.
--json
boolean
Output {"ok": true} on success.
memory clear permanently deletes all indexed content. The index must be rebuilt from disk with memory sync.

Examples

profclaw memory search "authentication flow"