GitHub Session Manager

Session management system for AI-assisted development. Automates git workflows, session documentation, and project tracking. Designed for Claude Code - adaptable to other AI coding assistants.

Overview

This project provides slash commands that help you manage development sessions by:

• Automatically documenting your work
• Creating comprehensive session notes
• Handling git commits and pushes
• Maintaining project documentation
• Tracking progress across sessions

Quick Start

1. Install the Commands

Copy the commands to your global Claude Code commands directory:

mkdir -p ~/.claude/commands
cp .claude/commands/start-session.md ~/.claude/commands/
cp .claude/commands/close-session.md ~/.claude/commands/

2. Configure Git (if not already done)

git config --global user.name "your-username"
git config --global user.email "your-email@example.com"

3. Use in Any Project

Navigate to any project directory and use the commands:

cd /path/to/your/project
# Start Claude Code and run:
/start-session

Commands

/start-session

Initializes a new development session:

• Checks git repository status and syncs with remote
• Reviews previous session notes
• Creates notes/ directory and sessions.md if missing
• Presents context from previous session
• Asks what you want to work on

/close-session

Closes the current development session:

• Creates comprehensive summary of all work done
• Updates notes/sessions.md with detailed session log
• Reviews and updates documentation (CLAUDE.md, README.md)
• Commits all changes with meaningful commit message
• Asks for confirmation before pushing to remote
• Handles edge cases (no changes, no remote, push failures)

Session Notes

All sessions are documented in notes/sessions.md, including:

• Date and time of session
• Summary of what was accomplished
• Files changed and why
• Key technical decisions
• Next steps and TODOs

This creates a comprehensive project history useful for:

• Writing reports and documentation
• Understanding past decisions
• Onboarding collaborators
• Tracking project evolution

Project Structure

your-project/
├── .claude/
│   └── commands/           # (optional local copy)
│       ├── start-session.md
│       └── close-session.md
├── notes/
│   └── sessions.md         # Session history (auto-generated)
├── CLAUDE.md               # Project guidance for Claude
└── README.md

Adapting for Other AI Tools

This system is designed for Claude Code but the concepts can be adapted:

AI Tool	Adaptation Needed
Cursor	Convert to .cursorrules format
GitHub Copilot	Use .github/copilot-instructions.md
Other AI	Paste command contents as system prompts

The core workflow (session start, documentation, session close) works with any AI that can execute git commands and edit files.

Requirements

• Claude Code CLI
• Git
• GitHub account (optional, for remote push)

License

MIT License - see LICENSE