znav tab my-feature                    # Switch to or create tab
znav pane my-task --tab my-feature     # Create pane in specific tab

znav pane api-refactor                 # Create/open pane (auto-creates tab if needed)
znav pane info api-refactor            # Get pane metadata
znav list                              # Tree view of all sessions/tabs/panes
znav reconcile                         # Sync Redis state with Zellij layout

# Simple checkpoint
znav pane log my-feature "Fixed authentication bug"

# Milestone with artifacts
znav pane log api-refactor "Completed REST API redesign" \
    --type milestone --artifacts src/api.rs docs/api.md

# Exploration session
znav pane log research "Investigated caching strategies" --type exploration

# Agent-generated entry
znav pane log my-feature "Completed task analysis" --source agent

# Human-readable (default)
znav pane history my-feature

# JSON for programmatic access
znav pane history my-feature --format json

# Compact JSON for piping
znav pane history my-feature --format json-compact | jq '.entries[0]'

# Markdown export (Obsidian-compatible)
znav pane history my-feature --format markdown > session.md

# LLM-optimized context for agent integration (~1000 tokens)
znav pane history my-feature --format context

# Generate AI summary of recent activity
znav pane snapshot my-feature

# Requires LLM configuration and consent
znav config set llm.provider anthropic
znav config consent --grant

znav config show                       # View all settings
znav config set redis_url redis://...  # Update Redis connection
znav config consent --grant            # Allow LLM data sharing
znav config consent --revoke           # Revoke LLM consent

# 1. Create a tab for the fixes (with optional correlation ID)
znav tab "myapp(fixes)"

# 2. Create individual panes for each fix
znav pane fix-auth --tab "myapp(fixes)"
znav pane fix-errors --tab "myapp(fixes)"
znav pane fix-docs --tab "myapp(fixes)"

# 3. Each pane can be worked on by a separate agent
# Agent in fix-auth pane:
znav pane log fix-auth "Starting auth token refresh fix" --source agent
# ... agent does work ...
znav pane log fix-auth "Completed auth fix" --type milestone --source agent

# 1. Create worktrees with iMi
imi add fix auth-refresh
imi add fix error-handling
imi add fix api-docs

# 2. Create Zellij workspace matching worktrees
znav tab "myapp(fixes)"

# 3. Create panes and set working directories
znav pane fix-auth --tab "myapp(fixes)"
# Then in pane: cd ~/code/myapp/fix-auth-refresh/

znav pane fix-errors --tab "myapp(fixes)"
# Then in pane: cd ~/code/myapp/fix-error-handling/

znav pane fix-docs --tab "myapp(fixes)"
# Then in pane: cd ~/code/myapp/fix-api-docs/

# First session
znav pane my-feature
znav pane log my-feature "Implementing user authentication flow"
# ... work happens ...

# Later session (shows resume context)
znav pane my-feature
# Output: "Resuming: ● Implementing user authentication flow (2 hours ago)"

# Get ~1000 token context summary
CONTEXT=$(znav pane history my-feature --format context)

# Inject into agent prompt
echo "Continue this work session:\n$CONTEXT"

{
  "id": "uuid",
  "timestamp": "2025-01-06T12:00:00Z",
  "summary": "What you were working on",
  "entry_type": "checkpoint|milestone|exploration",
  "source": "manual|agent|automated",
  "artifacts": ["file1.rs", "file2.ts"],
  "commands_run": 15,
  "goal_delta": "Progress description"
}

perth:pane:{name}          # Pane metadata hash
perth:intent:{name}        # Intent history list (LPUSH/LRANGE)

znav migrate --dry-run     # Preview migration
znav migrate               # Execute migration