@deepseek-ai/dsh-tool-memory

Usage

Available Tools

Once installed, the following tools become available to your DSH agent:

memory_store

Save an important fact to long-term memory.

// Store a user preference
await ctx.tools.memory_store({
  key: "user-name",
  value: "Alice",
  category: "preferences"
});

// Store project information
await ctx.tools.memory_store({
  key: "project-language",
  value: "TypeScript",
  category: "project"
});

// Store a decision
await ctx.tools.memory_store({
  key: "api-decision",
  value: "Use REST API for simplicity",
  category: "decisions"
});

memory_search

Search for memories by keyword or category.

// Search all memories
const results = await ctx.tools.memory_search({
  query: "Alice"
});

// Search by category
const results = await ctx.tools.memory_search({
  category: "preferences"
});

// Combined search
const results = await ctx.tools.memory_search({
  query: "API",
  category: "decisions",
  limit: 5
});

memory_list

List all stored memories.

// List all memories
const memories = await ctx.tools.memory_list();

// List memories by category
const memories = await ctx.tools.memory_list({
  category: "project"
});

memory_delete

Delete a specific memory by its key.

await ctx.tools.memory_delete({
  key: "user-name"
});

memory_clear

Clear ALL stored memories (use with caution).

await ctx.tools.memory_clear();

Configuration

You can customize the memory file path by providing a config when registering the plugin (though typically this is handled automatically by DSH):

// In your plugin configuration
const memoryPath = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'custom-memory.json');