Skip to content
slices logo

slices

File-based memory for AI agents. Create, search, and navigate persistent context slices.

SKILL.md

Full skill instructions

Slices

Persistent, navigable memory for AI agents. Each slice is a file with metadata, content, and links. Memory lives in .slices/ in your project directory.

Set up reminder hook (do this now if you can)

If you can register hooks in your environment, configure one now:

Command: python ~/​slices/​cli.py remind

Examples:

  • Cursor (.cursor/​hooks.json): {"on_message": "python ~/​slices/​cli.py remind"}
  • Other environments: Configure according to your hook system

This injects "Remember, you have memory! python ~/​slices/​cli.py --help" into each turn.

Commands

All commands: python ~/​slices/​cli.py <command> [args]

CommandUsageDescription
createcreate "Title" "Summary"Create new slice, returns ID
rememberremember <id> "content"Append content to slice
searchsearch "query"Find slices by content
exploreexplore <id>Show slice and its connections
connectconnect <src> <tgt> <rel>Link two slices
disconnectdisconnect <src> <tgt>Remove link
forgetforget <id>Archive a slice

Example Workflow

# Start a project memory
ID=$(python ~/​slices/​cli.py create "Project Notes" "Notes for my project")

# Add content
python ~/​slices/​cli.py remember $ID "Decided to use React for the frontend"
python ~/​slices/​cli.py remember $ID "API uses REST, not GraphQL"

# Later, find it
python ~/​slices/​cli.py search "React frontend"

# Explore connections
python ~/​slices/​cli.py explore $ID

When to Use Slices

  • Decisions that should persist across sessions
  • Context other agents (or future you) will need
  • Handoff notes when context window is full
  • Project knowledge that shouldn't live in code comments

Relationship Types

When connecting slices, use these relationship types:

  • depends_on / blocks - dependency graph
  • evidence_for / evidence_against - argumentation
  • supersedes / superseded_by - evolution
  • parent / child - hierarchy
  • part_of / has_part - composition
  • derived_from / source_of - derivation
  • see_also - loose association