session-save

/session-save - Save Session Context

PURPOSE: Capture current session state, tasks, and decisions for automatic loading on next session start.

EXPECTED OUTCOME: Create .orca/orchestration/active-task.md that SessionStart hook will auto-load.

NOTE: File is stored in .orca/orchestration/ (not temp/) to avoid accidental cleanup. The SessionStart hook automatically outputs this to STDOUT with 5 safeguards:

• 48h freshness check (skips stale context)
• 2000 char limit (truncates with indicator)
• Graceful missing file (silent continue)
• Absolute paths (reliable across directories)
• Resume mode awareness (native --continue provides full transcript)

---

Step 1: Gather Session Information

Collect from user:

Use AskUserQuestion to gather context:

AskUserQuestion({
  questions: [
    {
      question: "What were you working on this session?",
      header: "Session Focus",
      multiSelect: false,
      options: [
        {
          label: "iOS app development",
          description: "Swift, SwiftUI, Xcode work"
        },
        {
          label: "Web app features",
          description: "Next.js, React, UI components"
        },
        {
          label: "Design system work",
          description: "Design commands, inspiration, briefs"
        },
        {
          label: "Infrastructure/tooling",
          description: "Build, deploy, CI/CD"
        }
      ]
    }
  ]
})

Then ask for details:

"Please summarize in 2-3 sentences:

• What you accomplished this session
• What you're planning to work on next
• Any important decisions or blockers"

---

Step 2: Analyze Current State

Check git status:

git status --short
git log --oneline -5
git branch --show-current
basename $(git rev-parse --show-toplevel)

Detect project stack:

• Check for package.json (Next.js, React, etc.)
• Check for Podfile/Package.swift (iOS)
• Check for app.json/expo (Expo)

Check for active tasks:

• Modified files
• Uncommitted changes
• Recent commits