{"id":50556396,"url":"https://github.com/non4me/session-wizard","last_synced_at":"2026-06-04T07:30:27.501Z","repository":{"id":347151248,"uuid":"1193039722","full_name":"non4me/session-wizard","owner":"non4me","description":"Full session lifecycle skill for Claude Code — knowledge routing, session handoff, and skill evolution","archived":false,"fork":false,"pushed_at":"2026-03-26T20:27:01.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T08:42:43.731Z","etag":null,"topics":["agent-skills","claude-code","claude-code-skill","memory","session-management"],"latest_commit_sha":null,"homepage":"https://github.com/non4me/session-wizard","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/non4me.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-26T20:13:44.000Z","updated_at":"2026-03-26T20:41:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/non4me/session-wizard","commit_stats":null,"previous_names":["non4me/session-wizard"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/non4me/session-wizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/non4me%2Fsession-wizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/non4me%2Fsession-wizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/non4me%2Fsession-wizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/non4me%2Fsession-wizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/non4me","download_url":"https://codeload.github.com/non4me/session-wizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/non4me%2Fsession-wizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33895174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","claude-code-skill","memory","session-management"],"created_at":"2026-06-04T07:30:26.939Z","updated_at":"2026-06-04T07:30:27.492Z","avatar_url":"https://github.com/non4me.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧙 Session Wizard\n\n**Full session lifecycle management for Claude Code** — analyzes sessions on close, routes knowledge to memory and skills, and passes context to the next session automatically.\n\n\u003e Auto-dream cleans your memory. Session Wizard makes sure nothing worth remembering gets lost in the first place.\n\n## The Problem\n\nClaude Code's **Auto-memory** takes notes. **Auto-dream** cleans them up. But neither does three things:\n\n1. **Route knowledge** — decide what goes into memory vs. what becomes a reusable skill\n2. **Hand off context** — give the next session a structured summary so it can pick up where you left off\n3. **Evolve skills** — detect reusable patterns and update skills automatically\n\nAfter 20+ sessions, Claude either forgets critical decisions or drowns in noise. Session Wizard solves this.\n\n## How It Works\n\n```\n┌─────────────┐     ┌──────────────┐     ┌───────────────────────────────────────┐\n│  Session N   │────▶│     /es       │────▶│ ~/.claude/projects/{cwd}/memory/     │\n│  (working)   │     │  (analysis)  │     │   ├── MEMORY.md (index)              │\n│              │     │              │     │   ├── last-session.md (handoff)      │\n└─────────────┘     └──────────────┘     │   └── *.md (topic files)             │\n                                          │ ~/.claude/skills/ (if skill updated) │\n                                          └──────────────────┬──────────────────┘\n                                                             │\n                    ┌──────────────┐                         │\n                    │ Session N+1  │◀────────────────────────┘\n                    │ sessionStart │  Python hook reads\n                    │  hook fires  │  last-session.md → JSON\n                    │              │  → additionalContext\n                    └──────────────┘  → deletes file\n```\n\n**`/es`** analyzes the session and writes:\n- Classified memory files (user prefs, project state, bugs, references)\n- Skill updates (if a reusable pattern was discovered)\n- `last-session.md` — structured handoff for the next session\n\n**SessionStart hook** fires on the next session:\n- Reads `last-session.md`\n- Injects it as `[session-memory]` into the conversation\n- Deletes the file (one-shot consumption — no stale context)\n\n## What `/es` Does (6 Steps)\n\n| Step | Action |\n|------|--------|\n| 1. **Analyze** | Scans full conversation, classifies findings into `user` / `feedback` / `project` / `reference` / `pitfall` types |\n| 2. **Save to Memory** | Creates/updates memory files with YAML frontmatter, updates `MEMORY.md` index |\n| 3. **Update Active Work** | Maintains `## Active Work` and `## Completed` sections with exact next steps |\n| 4. **Update Skills** | If a reusable pattern was found → updates global or project skill |\n| 5. **Write Handoff** | Saves `last-session.md` with date, branch, completed items, next steps, key decisions |\n| 6. **Respond** | Compact summary: what was done, what's next, memory stats |\n\n## Installation\n\n### 1. Install the skill\n\n**Global (all projects):**\n```bash\ngit clone https://github.com/non4me/session-wizard.git\ncp -r session-wizard ~/.claude/skills/session-wizard\n```\n\n**Or with npx:**\n```bash\nnpx skills add non4me/session-wizard\n```\n\n### 2. Install the SessionStart hook\n\nCopy the hook script:\n```bash\nmkdir -p ~/.claude/hooks\ncp session-wizard/scripts/session-start-memory.py ~/.claude/hooks/\n```\n\nRegister it in `~/.claude/settings.json`:\n```json\n{\n  \"hooks\": {\n    \"sessionStart\": [\n      {\n        \"type\": \"command\",\n        \"command\": \"python ~/.claude/hooks/session-start-memory.py\"\n      }\n    ]\n  }\n}\n```\n\n\u003e **Windows**: use `python` or `python3` depending on your setup. The script handles both Windows and Unix paths.\n\n### 3. Verify\n\n```bash\n# Start a Claude Code session\n# Do some work\n# Type /es\n# Check that memory/last-session.md was created\n# Start a new session\n# You should see [session-memory] at the start\n```\n\n## Session Wizard vs Auto-dream\n\n| Feature | Auto-dream | Session Wizard |\n|---------|-----------|----------------|\n| Cleans memory files | ✅ | ❌ (not its job) |\n| Routes knowledge to memory | ❌ (auto-memory does raw capture) | ✅ (classified by type) |\n| Routes knowledge to skills | ❌ | ✅ |\n| Session-to-session handoff | ❌ | ✅ |\n| Tracks active work \u0026 next steps | ❌ | ✅ |\n| Runs automatically | ✅ (background) | `/es` on demand |\n| Logs pitfalls \u0026 solutions | ❌ | ✅ (`problems-and-fixes.md`) |\n\n**They complement each other.** Auto-dream keeps memory clean. Session Wizard makes sure the right knowledge gets to the right place and the next session starts warm.\n\n## Memory Directory Structure\n\n```\n~/.claude/projects/{sanitized_cwd}/memory/\n├── MEMORY.md                 ← index of all memory files\n├── last-session.md           ← handoff file (auto-deleted by hook)\n├── problems-and-fixes.md     ← accumulated pitfalls \u0026 solutions\n└── *.md                      ← topic memory files with YAML frontmatter\n```\n\n## Compatibility\n\n- **Claude Code**: Full support (skills + hooks)\n- **OS**: Windows, macOS, Linux\n- **Works with Auto-dream**: Yes\n- **Works with Auto-memory**: Yes\n- **Python**: 3.8+ (no external dependencies)\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Author\n\n[@non4me](https://github.com/non4me)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnon4me%2Fsession-wizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnon4me%2Fsession-wizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnon4me%2Fsession-wizard/lists"}