Writer’s Brief (Outline)

This section is a handoff for a writer — what the post is about and what to cover.

The Hook

When your AI session manager gets too cluttered, you can just ask the AI to reorganize it — and it knows exactly which JSON files to edit.

Main Points to Cover

  1. Agent Deck stores everything in simple JSON files — profiles are just folders with sessions.json
  2. Claude can read the structure, identify which sessions belong where, and create clean new profiles
  3. The meta moment: using Claude Code to reorganize your Claude Code session manager

The Angle

Personal discovery — hit a wall with cluttered sessions, asked Claude if reorganization was possible, turned out to be trivially easy because it’s all just JSON.

Target Reader

People using Agent Deck (or similar session managers) who have accumulated too many sessions and want to separate work contexts. Also anyone curious about the “AI working on its own tools” dynamic.

Tone Notes

Casual, amused by the meta-ness of it. Not a tutorial — more “huh, that was easy.”

Raw Material / Moments to Write From

  • 34 sessions across 15 projects. Unusable. Scrolling and squinting every time.
  • Knew profiles existed. Seen it in help output once. Never used it. “Migration anxiety?”
  • Asked Claude how easy it would be. “It’s just a JSON file.” Five minutes later, four profiles.
  • Watching Claude create new JSON files for the tool you use to manage Claude sessions. Text manipulation on its own management layer.
  • From one cluttered view to four clean ones: personal, podcast, clients, AI course.
  • “Turtles all the way down.”