slices

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

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]

Command	Usage	Description
create	create "Title" "Summary"	Create new slice, returns ID
remember	remember <id> "content"	Append content to slice
search	search "query"	Find slices by content
explore	explore <id>	Show slice and its connections
connect	connect <src> <tgt> <rel>	Link two slices
disconnect	disconnect <src> <tgt>	Remove link
forget	forget <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