{"id":29806281,"url":"https://github.com/iannuttall/claude-sessions","last_synced_at":"2026-01-17T12:25:05.498Z","repository":{"id":299439517,"uuid":"1003047863","full_name":"iannuttall/claude-sessions","owner":"iannuttall","description":"Custom slash commands for Claude Code that provide comprehensive development session tracking and documentation","archived":false,"fork":false,"pushed_at":"2025-06-16T14:50:30.000Z","size":7,"stargazers_count":1137,"open_issues_count":9,"forks_count":141,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-01-14T21:52:20.888Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"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/iannuttall.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}},"created_at":"2025-06-16T14:39:53.000Z","updated_at":"2026-01-14T21:30:20.000Z","dependencies_parsed_at":"2025-06-16T15:53:13.970Z","dependency_job_id":null,"html_url":"https://github.com/iannuttall/claude-sessions","commit_stats":null,"previous_names":["iannuttall/claude-sessions"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iannuttall/claude-sessions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iannuttall%2Fclaude-sessions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iannuttall%2Fclaude-sessions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iannuttall%2Fclaude-sessions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iannuttall%2Fclaude-sessions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iannuttall","download_url":"https://codeload.github.com/iannuttall/claude-sessions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iannuttall%2Fclaude-sessions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-07-28T14:05:56.103Z","updated_at":"2026-01-17T12:25:05.472Z","avatar_url":"https://github.com/iannuttall.png","language":null,"funding_links":[],"categories":["Claude Code Ecosystem","Custom Commands \u0026 Frameworks","Slash Commands","📦 Legacy \u0026 Inactive Projects"],"sub_categories":["Project \u0026 Session Management","MCP Frameworks and Tooling"],"readme":"# Claude Code Session Management Commands\n\nCustom slash commands for Claude Code that provide comprehensive development session tracking and documentation. Based on [Claude Code's custom slash command system](https://docs.anthropic.com/en/docs/claude-code/slash-commands).\n\n## 🎯 Overview\n\nThis is a set of custom slash commands for Claude Code that helps developers maintain continuity across multiple coding sessions with Claude by:\n\n- **Documenting Progress**: Capture what was done, how it was done, and why decisions were made\n- **Tracking Changes**: Monitor git changes, todo items, and implementation details  \n- **Knowledge Transfer**: Enable future sessions to understand past work without re-analyzing the entire codebase\n- **Issue Resolution**: Document problems encountered and their solutions for future reference\n\nThese commands extend Claude Code's built-in functionality with project-specific session management capabilities.\n\n## 🚀 Quick Start\n\n```bash\n# Start a new session (with optional name)\n/project:session-start authentication-refactor\n# Or without a name\n/project:session-start\n\n# Update progress during development (with optional notes)\n/project:session-update Implemented OAuth with Google\n# Or without notes (auto-summarizes recent activity)\n/project:session-update\n\n# End session with comprehensive summary\n/project:session-end\n\n# View current session status\n/project:session-current\n\n# List all past sessions\n/project:session-list\n```\n\n## 📁 File Structure\n\n```\ncommands/                       # Custom command directory\n├── session-start.md           # Command for starting a new session\n├── session-update.md          # Command for updating current session\n├── session-end.md             # Command for ending and summarizing\n├── session-current.md         # Command for viewing current status\n├── session-list.md            # Command for listing all sessions\n└── session-help.md            # Command for showing help\n\nsessions/                      # Session storage directory\n├── .current-session          # Tracks the active session filename\n├── 2025-01-16-1347.md       # Example session file\n└── [YYYY-MM-DD-HHMM-name].md  # Session naming format\n```\n\n## 🛠️ Installation\n\n1. Clone this repository or copy the folders to your project:\n   ```bash\n   git clone git@github.com:iannuttall/claude-sessions.git\n   # Or copy the commands and sessions folders to your project root\n   ```\n\n2. Create the sessions tracking file:\n   ```bash\n   mkdir -p sessions\n   touch sessions/.current-session\n   ```\n\n3. Add to `.gitignore` if you don't want to track sessions:\n   ```\n   sessions/\n   ```\n\n## 📝 How It Works\n\nThis system provides custom slash commands inspired by [Claude Code's custom slash commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands#custom-slash-commands) feature. While Claude Code typically looks for commands in `.claude/commands/`, this repository provides a standalone implementation with commands in the `commands/` directory.\n\n- **Prefix**: All commands use the `/project:` prefix (for project-specific commands)\n- **Arguments**: Commands support arguments using the `$ARGUMENTS` placeholder\n- **Execution**: Claude reads the command file and executes the instructions within\n- **Note**: These commands are designed to work with Claude but can be adapted for other AI coding assistants\n\n## 📋 Command Reference\n\n### `/project:session-start [name]`\nStarts a new development session with an optional descriptive name.\n\n**Parameters:**\n- `[name]` (optional) - A descriptive name for the session. If omitted, creates a session with just the timestamp.\n\n**What it does:**\n- Creates a new markdown file with timestamp (format: `YYYY-MM-DD-HHMM.md` or `YYYY-MM-DD-HHMM-name.md`)\n- Sets up session structure with goals and progress sections\n- Updates `.current-session` to track active session\n- Prompts for session goals if not clear from context\n\n**Examples:**\n```\n# With a descriptive name\n/project:session-start refactor-auth-system\n\n# Without a name (just timestamp)\n/project:session-start\n```\n\n### `/project:session-update [notes]`\nAdds timestamped updates to the current session.\n\n**Parameters:**\n- `[notes]` (optional) - Custom notes about the update. If omitted, automatically summarizes recent activities.\n\n**What it does:**\n- Appends progress notes with timestamp\n- Captures git status and changes\n- Tracks todo list progress\n- Documents issues and solutions\n- Records implementation details\n- Auto-generates summary if no notes provided\n\n**Examples:**\n```\n# With custom notes\n/project:session-update Fixed Next.js 15 params Promise issue\n\n# Without notes (auto-summarizes)\n/project:session-update\n```\n\n### `/project:session-end`\nEnds the current session with a comprehensive summary.\n\n**What it does:**\n- Generates complete session summary including:\n  - Duration and timing\n  - Git changes summary\n  - Todo items completed/remaining\n  - Key accomplishments\n  - Problems and solutions\n  - Dependencies and configuration changes\n  - Lessons learned\n  - Tips for future developers\n- Clears `.current-session` file\n\n### `/project:session-current`\nShows the status of the current active session.\n\n**What it does:**\n- Displays session name and duration\n- Shows recent updates\n- Lists current goals and tasks\n- Reminds of available commands\n\n### `/project:session-list`\nLists all session files with summaries.\n\n**What it does:**\n- Shows all session files sorted by date\n- Displays session titles and timestamps\n- Highlights currently active session\n- Shows brief overview of each session\n\n### `/project:session-help`\nDisplays help information about the session system.\n\n## 🎯 Best Practices for Claude Code\n\n### Command Usage\n- These commands work only within Claude Code interactive sessions\n- Commands are project-specific and available to all team members\n- Arguments are passed directly after the command name\n\n### Session Management  \n- Sessions help Claude maintain context across conversations\n- Review past sessions before starting related work\n- Session files serve as documentation for your development process\n\n## 🔧 Customization\n\n### Adapting for Standard Claude Code Setup\nIf you want to use these with Claude Code's standard directory structure:\n1. Copy the `commands` folder to `.claude/commands/` in your project\n2. Update paths in command files from `sessions/` to `.claude/sessions/`\n\n### Creating Your Own Commands\n- Modify command files to change behavior\n- Create additional session-related commands\n- Organize commands in subdirectories for namespacing (e.g., `/project:session:feature:start`)\n- Create personal versions in `~/.claude/commands/` with `/user:` prefix\n\n## 📚 References\n\n- [Claude Code Slash Commands Documentation](https://docs.anthropic.com/en/docs/claude-code/slash-commands)\n- [Claude Code Memory Management](https://docs.anthropic.com/en/docs/claude-code/memory-management)\n- [Claude Code Overview](https://docs.anthropic.com/en/docs/claude-code/overview)\n\n## 🎯 Best Practices\n\n### Starting Sessions\n- Use descriptive names that indicate the main focus\n- Start sessions for significant features or bug fixes\n- Define clear goals at the beginning\n\n### During Development\n- Update regularly when completing significant tasks\n- Document unexpected issues and their solutions\n- Track breaking changes or important discoveries\n- Note any dependencies added or configuration changes\n\n### Ending Sessions\n- Always end sessions with `/project:session-end`\n- Review the generated summary for completeness\n- Add any missing context before closing\n\n### Knowledge Transfer\n- Review relevant past sessions before starting similar work\n- Reference session files in commit messages for context\n- Use session summaries for standup updates or reports\n\n## 💡 Use Cases\n\n### 1. Feature Development\n```\n/project:session-start user-authentication\n# Implement auth logic\n/project:session-update Added middleware and login page\n# Fix issues\n/project:session-update Resolved Next.js 15 async cookie issue\n/project:session-end\n```\n\n### 2. Bug Fixing\n```\n/project:session-start fix-email-bounce-handling\n# Investigate issue\n/project:session-update Found AWS SNS webhook misconfiguration\n# Implement fix\n/project:session-update Updated webhook handler and added logging\n/project:session-end\n```\n\n### 3. Refactoring\n```\n/project:session-start database-service-refactor\n# Plan refactoring\n/project:session-update Created new DB service class architecture\n# Execute changes\n/project:session-update Migrated all queries to new service\n/project:session-end\n```\n\n## 🤖 Benefits for AI Agents\n\n1. **Context Preservation**: Sessions provide rich context about past work\n2. **Decision History**: Understand why certain approaches were taken\n3. **Issue Awareness**: Know about problems already encountered and solved\n4. **Code Evolution**: Track how the codebase has changed over time\n5. **Dependency Tracking**: Awareness of what packages and tools are used\n\n## 🔍 Tips and Tricks\n\n1. **Searchable Sessions**: Use consistent terminology in updates for easy searching\n2. **Link Issues**: Reference ticket numbers or GitHub issues in updates\n3. **Code Snippets**: Include important code changes in session updates\n4. **Screenshots**: Reference screenshot paths for UI changes\n5. **Testing Notes**: Document test scenarios and results\n\n## ⚙️ Configuration\n\n### Customizing Commands\nEdit the command files in `commands/` to:\n- Change session file format\n- Add custom sections\n- Modify summary generation\n- Adjust git tracking details\n\n### Session Storage\n- Default: `sessions/`\n- Can be changed by updating command files\n- Consider version control needs\n\n## 🚨 Troubleshooting\n\n**No active session found**\n- Start a new session with `/project:session-start`\n- Check `sessions/.current-session` exists\n\n**Session updates not working**\n- Ensure a session is active\n- Check file permissions in `sessions/`\n\n**Missing git information**\n- Verify you're in a git repository\n- Check git is properly initialized\n\n## 📚 Examples\n\n### Complete Feature Implementation Session\n```markdown\n# Development Session - 2025-01-16 13:47 - campaign-editor\n\n## Goals\n- [x] Create dedicated campaign editor\n- [x] Add markdown support\n- [x] Implement auto-save\n\n## Progress\n[Multiple detailed updates documenting the implementation]\n\n## Session Summary\nSuccessfully implemented a full-featured campaign editor with markdown support,\nlive preview, and auto-save functionality. Resolved Next.js 15 compatibility\nissues and added proper error handling.\n```\n\n## 🤝 Contributing\n\nTo improve this system:\n1. Enhance command instructions for better AI comprehension\n2. Add new commands for specific workflows\n3. Improve session file formatting\n4. Create utilities for session analysis\n\n## 📄 License\n\nThis session management system is open source and available for use in any project.\n\n---\n\n*Remember: Good documentation today saves hours of debugging tomorrow!*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiannuttall%2Fclaude-sessions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiannuttall%2Fclaude-sessions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiannuttall%2Fclaude-sessions/lists"}