Claude Code

Install Rekall skills for Claude Code to use memory commands directly in your terminal-based coding workflow. Skills provide shorthand access to Rekall's MCP tools.

Overview

Claude Code skills are slash commands that map to one or more Rekall MCP tools. They provide a streamlined interface for the most common memory operations without needing to know the underlying tool names or parameter schemas.

save

/remember

/recall

swap_horiz

/context

/share

play_circle

/execution

Installing Skills

First, ensure the Rekall MCP server is installed globally:

Terminal

npm install -g @rekall/mcp-server

Then install the Rekall skills for Claude Code:

Terminal

# Install Rekall skills
claude skills add @rekall/claude-code-skills

# Verify installation
claude skills list

Configure your API key so the skills can authenticate with Rekall:

Terminal

# Set your Rekall API key
export REKALL_API_KEY="your-api-key-here"

# Optionally add to your shell profile for persistence
echo 'export REKALL_API_KEY="your-api-key-here"' >> ~/.zshrc

MCP server auto-start

The skills automatically start the MCP server in the background when invoked. You do not need to manually run the MCP server when using Claude Code skills.

Available Skills

`/remember`

Store information as a persistent memory. Supports all memory types including episodic, semantic, procedural, and preferences.

Remember a decision

/remember We chose Tailwind CSS for styling because the team prefers utility-first approaches.

Remember a workflow

/remember --type procedural To deploy: run tests, build Docker image, push to ECR, update ECS service.

Remember a preference

/remember --type preference User prefers TypeScript strict mode and explicit return types.

`/recall`

Search and retrieve memories using natural language queries. Uses hybrid search combining semantic similarity and keyword matching.

Recall a decision

/recall What styling framework did we choose?

Recall deployment steps

/recall How do we deploy to production?

Recall with type filter

/recall --type semantic What entities are related to the auth service?

`/context`

Manage the active memory context. Switch between user, project, agent, and hive contexts to scope memory operations.

View current context

/context

Switch to a project context

/context --project my-saas-app

Switch to a hive

/context --hive backend-team

`/share`

Share memories to a hive for team collaboration. Allows agents to contribute knowledge to shared memory spaces.

Share to a team hive

/share --hive backend-team "API rate limiting is set to 1000 req/min per user"

List hive memories

/share --list --hive backend-team

`/execution`

Manage long-running task execution state. Create checkpoints, pause, and resume complex multi-step tasks.

Start tracking a task

/execution start "Migrate database schema from v2 to v3"

Checkpoint progress

/execution checkpoint "Completed table migrations, starting index rebuilds"

Resume a paused task

/execution resume

Configuration

Skills can be configured through environment variables or a .rekallrc file in your project root:

.rekallrc

{
  "apiKey": "your-api-key-here",
  "baseUrl": "https://api.rekall.ai",
  "defaultContext": "my-project",
  "agentId": "claude-code",
  "autoRemember": true,
  "memoryTypes": {
    "default": "episodic",
    "codeDecisions": "semantic",
    "deploymentSteps": "procedural"
  }
}

Auto-remember mode

When autoRemember is enabled, Claude Code automatically stores significant decisions and learnings as memories without requiring explicit /remember commands.

Skill to Tool Mapping

Each skill maps to one or more underlying MCP tools. The skill layer handles parameter mapping and provides sensible defaults:

Skill	MCP Tools
`/remember`	`create_memorybulk_create_memoriesset_preference`
`/recall`	`search_memoriessemantic_searchfulltext_searchfind_related`
`/context`	`get_agent_contextset_agent_contextswitch_context`
`/share`	`share_to_hiveget_hive_memoriescreate_hivejoin_hive`
`/execution`	`create_executioncheckpoint_executionresume_executioncomplete_executionget_execution_state`

Tips & Best Practices

lightbulb

Use project contexts

Run /context --project my-app at the start of a session to scope all memories to the current project.

lightbulb

Remember architectural decisions

Use /remember to store important design decisions, trade-offs, and rationale so future sessions have context.

lightbulb

Checkpoint long tasks

For multi-step refactoring or migrations, use /execution to checkpoint progress so you can resume if the session is interrupted.