{"id":32849167,"url":"https://github.com/christophera/claude_code_tools","last_synced_at":"2026-05-15T18:02:21.075Z","repository":{"id":322726513,"uuid":"1089881429","full_name":"ChristopherA/claude_code_tools","owner":"ChristopherA","description":"Session continuity skills for Claude Code - maintain context across coding sessions","archived":false,"fork":false,"pushed_at":"2026-01-12T20:08:19.000Z","size":326,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-19T11:14:30.489Z","etag":null,"topics":["ai-tools","claude-code","claude-skills","session-management"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause-patent","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChristopherA.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2025-11-05T00:05:27.000Z","updated_at":"2026-01-12T20:08:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"e638a315-22d1-4774-a6ca-e5978ee4f0fd","html_url":"https://github.com/ChristopherA/claude_code_tools","commit_stats":null,"previous_names":["christophera/claude_code_tools"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ChristopherA/claude_code_tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2Fclaude_code_tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2Fclaude_code_tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2Fclaude_code_tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2Fclaude_code_tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChristopherA","download_url":"https://codeload.github.com/ChristopherA/claude_code_tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherA%2Fclaude_code_tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33074392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["ai-tools","claude-code","claude-skills","session-management"],"created_at":"2025-11-08T10:01:13.480Z","updated_at":"2026-05-15T18:02:21.068Z","avatar_url":"https://github.com/ChristopherA.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Tools\n\nA collection of Claude Code skills and hooks for enhanced development workflows.\n\n## Overview\n\nThis repository provides multiple skills and hooks for Claude Code:\n\n**Session Management** (`session-skills` plugin):\n- **session-closure**: Creates detailed session resumes when ending a session\n- **session-resume**: Loads and presents previous session context when starting a new session\n- **session-cleanup**: Adaptive session audit before closure with depth calibration\n\n**Git Worktree Operations** (`git-worktree` plugin):\n- **git-worktree**: Interactive git worktree management - clone, convert, create, list, remove, troubleshoot\n\n**Session-Start Hooks** (`hooks/`):\n- **session-start.sh**: Persists PROJECT_ROOT for consistent path handling across session\n- **session-start-git-context.sh**: Git awareness at session start (branch, commits, status)\n\n**Context Monitor** (`context-monitor` tool):\n- **status-line.sh**: Always-visible statusline showing context usage with color thresholds\n\n## Features\n\n### Session Skills\n- Automatic session resumes with project status tracking\n- Intelligent archiving with git-aware logic\n- Staleness detection and warnings\n- Full, minimal, and emergency modes\n- Pre-closure cleanup with depth calibration (light/standard/thorough)\n- Project-specific cleanup checklists\n\n### Git Worktree Skill\n- Clone repos directly into worktree form\n- Convert existing repos to worktree structure\n- Create/list/remove worktrees for branches\n- Troubleshoot common worktree issues\n- WORKTREES/GITHUB/{owner}/{repo}/ workspace pattern\n\n### Context Monitor\n- Always-visible context percentage (Claude's built-in only shows at ~12%)\n- Color thresholds: green \u003e40%, yellow 21-40%, red ≤20% with warning\n- Model name display: `[Opus 4.5] XX%`\n- Configurable overhead and optional cost display\n\n### Common Features\n- Executable scripts for consistency\n- Progressive disclosure architecture\n- Cross-platform support (macOS + Linux)\n- Comprehensive test suites\n\n## Installation\n\n### Option 1: Plugin Installation (Recommended)\n\n```bash\n# Add this marketplace\n/plugin marketplace add ChristopherA/claude_code_tools\n\n# Install individual plugins\n/plugin install session-skills@claude-code-tools\n/plugin install git-worktree@claude-code-tools\n/plugin install git-enforcement-hooks@claude-code-tools\n```\n\n**Note**: The context-monitor tool requires manual installation (see Option 2 below).\n\n### Option 2: Manual Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/ChristopherA/claude_code_tools.git\n\n# Copy session skills\ncp -r claude_code_tools/skills/session-closure ~/.claude/skills/\ncp -r claude_code_tools/skills/session-resume ~/.claude/skills/\ncp -r claude_code_tools/skills/session-cleanup ~/.claude/skills/\n\n# Copy git-worktree skill\ncp -r claude_code_tools/skills/git-worktree ~/.claude/skills/\n\n# Copy session-start hooks (optional but recommended)\ncp claude_code_tools/hooks/*.sh ~/.claude/hooks/\nchmod +x ~/.claude/hooks/session-start*.sh\n\n# Copy context-monitor (statusline script)\nmkdir -p ~/.claude/scripts\ncp claude_code_tools/tools/context-monitor/scripts/status-line.sh ~/.claude/scripts/\nchmod +x ~/.claude/scripts/status-line.sh\n# Then add to ~/.claude/settings.json:\n#   \"statusLine\": { \"command\": \"~/.claude/scripts/status-line.sh\" }\n```\n\n**Note**: Skills go to `~/.claude/skills/`, hooks go to `~/.claude/hooks/`, scripts go to `~/.claude/scripts/`.\n\n## Quick Start\n\n### Git Worktree Operations\n\n```\nUser: clone worktree from https://github.com/owner/repo\n\nClaude: This will create:\n  ~/WORKTREES/GITHUB/owner/repo/\n  ├── repo.git/   (bare repository)\n  └── main/       (main branch worktree)\n\nProceed? [Y/n]\n\n✅ Cloned into worktree form\ncd ~/WORKTREES/GITHUB/owner/repo/main\n```\n\nOther commands:\n- \"convert to worktree\" - Convert current repo\n- \"create worktree for feature/auth\" - Add branch worktree\n- \"list worktrees\" - Show all worktrees\n- \"troubleshoot worktrees\" - Fix common issues\n\n### Ending a Session\n\nWhen you're ready to end your coding session:\n\n```\nUser: close context\n```\n\nClaude will:\n1. Archive any previous resume\n2. Analyze your session\n3. Create a structured CLAUDE_RESUME.md with:\n   - What you accomplished\n   - Pending tasks\n   - Key decisions made\n   - Next session focus\n   - Project status\n   - Sync status (if applicable)\n\n### Starting a New Session\n\nWhen you return to work:\n\n```\nUser: resume\n```\n\nClaude will:\n1. Load CLAUDE_RESUME.md\n2. Check for staleness\n3. Present summary with:\n   - Last activity\n   - Next focus\n   - Pending tasks (with count)\n   - Project status\n4. Ready you to continue where you left off\n\n## Skills Included\n\n### git-worktree v1.0.0\n\n**Triggers**:\n- \"clone worktree from {url}\", \"get worktree from {repo}\"\n- \"convert to worktree\"\n- \"create worktree for {branch}\"\n- \"list worktrees\", \"remove worktree {name}\"\n- \"troubleshoot worktrees\", \"validate worktree\"\n\n**Key Features**:\n- Clone GitHub repos directly into worktree form\n- Convert existing local repos to worktree structure\n- Create/list/remove worktrees for branches\n- Troubleshoot common issues (core.bare, stale entries, broken links)\n- WORKTREES/GITHUB/{owner}/{repo}/ workspace pattern\n- Inception commit detection (Open Integrity pattern)\n\n**Scripts** (10 total):\n- `clone-as-worktree.sh` - Clone into worktree form\n- `convert-to-worktree.sh` - Convert existing repo\n- `create-worktree.sh` - Add worktree for branch\n- `list-worktrees.sh` - Show worktrees with status\n- `remove-worktree.sh` - Safely remove worktree\n- `troubleshoot.sh` - Diagnose and fix issues\n- Plus 4 utility scripts (detect-repo-type, extract-owner, detect-inception, validate-setup)\n\n### session-closure v1.2.0\n\n**Triggers**:\n- \"close context\", \"end session\", \"prepare to stop\"\n- Context approaching 170k tokens (proactive)\n- SessionEnd hook (automatic on /exit)\n\n**Key Features**:\n- Full mode: Complete analysis and detailed resume\n- Minimal mode: Essential state when context limited\n- Emergency mode: Output to chat when critically low\n- Git-aware archiving (skips if tracked in git)\n- Resume validation with format checking\n- Project Status section (inter-project communication)\n- Sync Status section (authoritative source tracking)\n\n**Scripts**:\n- `archive_resume.sh` - Intelligent resume archiving\n- `validate_resume.sh` - Format validation\n\n### session-resume v1.2.1\n\n**Triggers**:\n- \"resume\", \"load resume\", \"continue from last session\"\n- \"what was I working on\", \"show previous session\"\n\n**Key Features**:\n- Staleness detection with warnings\n- Archive browsing and loading\n- Project Status recognition\n- Sync Status recognition\n- Multiple resume format support (v1.1.0, v1.2.0)\n\n**Scripts**:\n- `check_staleness.sh` - Calculate resume age\n- `list_archives.sh` - Discover archived sessions\n\n### session-cleanup v1.1.0\n\n**Triggers**:\n- \"session cleanup\", \"session review\", \"audit session\"\n- \"pre-closure check\", \"cleanup\"\n\n**Key Features**:\n- Adaptive depth calibration based on session complexity\n- Automated checks: permissions, uncommitted changes, complexity\n- Structured ultrathink with category hints\n- Project-specific local cleanup support\n- Seamless handoff to session-closure\n\n**Scripts**:\n- `check_permissions.sh` - One-time permission verification\n- `check_uncommitted_changes.sh` - Git state validation\n- `detect_complexity.sh` - Session depth calibration\n- `find_local_cleanup.sh` - Local cleanup file detection\n\n## Usage Examples\n\n### Daily Workflow\n\n**End of day**:\n```\nUser: We've made good progress on the authentication feature. Close context.\n\nClaude: [Archives previous resume]\nCreating session resume...\n\n✅ Resume created: CLAUDE_RESUME.md\n\n**Last activity**: Implemented JWT authentication with refresh tokens\n\n**Next focus**: Add rate limiting and write integration tests\n\n**Pending**: 3 tasks remaining\n- Add rate limiting middleware\n- Write integration tests for auth flow\n- Update API documentation\n\nResume saved. See you next session!\n```\n\n**Next morning**:\n```\nUser: resume\n\nClaude: 📋 Resuming from November 3, 2025 session:\n\n**Project**: auth-service\n**Status**: 🔄 IN PROGRESS - JWT implementation complete, testing pending\n\n**Last activity**: Implemented JWT authentication with refresh tokens\n\n**Next focus**: Add rate limiting and write integration tests\n\n**Pending tasks**: 3 tasks remaining\n- Add rate limiting middleware\n- Write integration tests for auth flow\n- Update API documentation\n\nFull context loaded. Ready to continue!\n```\n\n### Multi-Project Coordination\n\nWith Project Status section, coordinate across projects:\n\n```markdown\n## Project Status\n\n- **Current State**: 🔄 TESTING - Core features complete, integration tests in progress\n- **Key Changes**: Implemented OAuth2 flow, migrated from sessions to JWT\n- **Next Priority**: Complete integration tests, then deploy to staging\n- **Dependencies**: Waiting on database migration approval from DBA team\n- **Project Health**: Good - on track for Friday release\n```\n\nOther project contexts can read this status to understand dependencies.\n\n### Working with Authoritative Sources\n\nWhen syncing with external docs:\n\n```markdown\n## Sync Status\n\n**Authoritative Sources**:\n- **API Specification**: https://docs.google.com/document/d/abc123 (synced 2025-11-03)\n- **Architecture Decisions**: https://hackmd.io/@team/architecture (synced 2025-11-02)\n- **Project Board**: https://github.com/org/repo/projects/1 (synced 2025-11-03)\n\n**Sync Health**: ✅ All sources current\n```\n\nClaude will warn if sources become stale (\u003e7 days old).\n\n## Testing\n\nBoth skills include comprehensive test suites:\n\n```bash\n# Test session-closure\ncd skills/session-closure/tests\n./test_scripts.sh\n\n# Test session-resume\ncd skills/session-resume/tests\n./test_scripts.sh\n```\n\nExpected: All tests passing (6 tests with 12 assertions for session-closure, 8 tests for session-resume)\n\n## Resume Format\n\nResumes are created in markdown format with these sections:\n\n**Required**:\n- Header (date, duration, status)\n- Last Activity Completed\n- Pending Tasks\n- Session Summary\n- Next Session Focus\n\n**Optional** (v1.2.0+):\n- Project Status (inter-project communication)\n- Sync Status (authoritative source tracking)\n- Key Decisions Made\n- Insights \u0026 Learnings\n\n**Modes**:\n- Full mode: All sections, detailed content\n- Minimal mode: Essential sections, abbreviated content\n- Emergency mode: Template output to chat\n\nFor complete format specification, see `skills/session-closure/references/RESUME_FORMAT_v1.2.md`\n\n## Configuration\n\n### SessionEnd Hook (Recommended)\n\nAutomatically trigger session-closure on /exit:\n\nAdd to `~/.claude/settings.json`:\n```json\n{\n  \"hooks\": {\n    \"SessionEnd\": [{\n      \"type\": \"skill\",\n      \"skill\": \"session-closure\"\n    }]\n  }\n}\n```\n\nOr combine with custom command:\n```json\n{\n  \"hooks\": {\n    \"SessionEnd\": [{\n      \"type\": \"command\",\n      \"command\": \"echo '👋 Session ending...'\"\n    }, {\n      \"type\": \"skill\",\n      \"skill\": \"session-closure\"\n    }]\n  }\n}\n```\n\n### SessionStart Hook (Recommended)\n\nShow reminder about resume availability:\n\nAdd to `~/.claude/settings.json`:\n```json\n{\n  \"hooks\": {\n    \"SessionStart\": [{\n      \"type\": \"command\",\n      \"command\": \"date +'📅 Today is %A, %B %d, %Y' \u0026\u0026 ([ -f CLAUDE_RESUME.md ] \u0026\u0026 echo '\\\\n📋 Previous session available. Say \\\"resume\\\" to continue.' || true)\"\n    }]\n  }\n}\n```\n\n## Requirements\n\n- Claude Code (latest version recommended)\n- Bash shell (for scripts)\n- Git (optional, for git-aware archiving)\n\n## Architecture\n\nBoth skills follow best practices:\n\n- **Executable Scripts**: Consistent, tested, token-efficient\n- **Progressive Disclosure**: Core logic in SKILL.md, details in references/\n- **Automated Testing**: All scripts validated by test suites\n- **Format Validation**: Resume structure verified before writing\n- **Error Handling**: Graceful degradation and clear error messages\n\n## Documentation\n\n### Core Documentation\n- **[CHANGELOG.md](./CHANGELOG.md)** - Version history and release notes\n- **[CONTRIBUTING.md](./CONTRIBUTING.md)** - Contribution guidelines and development setup\n\n### Guides\n- **[guides/](./guides/)** - Practical workflow tutorials\n  - [Solo Workflow](./guides/solo-workflow.md) - Individual developer workflow\n  - [Team Workflow](./guides/team-workflow.md) - Team collaboration with git\n\n### Skill Documentation\n\n**git-worktree**: See `skills/git-worktree/` for:\n- SKILL.md - Complete skill documentation\n- references/troubleshooting.md - Advanced troubleshooting guide\n\n**session-closure**: See `skills/session-closure/references/` for:\n- README.md - Installation and usage\n- CONTRIBUTING.md - Development guide\n- PERMISSIONS.md - Permission configuration\n- RESUME_FORMAT_v1.2.md - Resume format specification\n\n**session-resume**: See `skills/session-resume/references/` for:\n- README.md - Installation and usage\n- CONTRIBUTING.md - Development guide\n- RESUME_FORMAT_v1.2.md - Resume format specification\n\n**session-cleanup**: See `skills/session-cleanup/references/` for:\n- README.md - Installation and usage\n- CONTRIBUTING.md - Developer guide with script documentation\n- LOCAL_TEMPLATE.md - Template for project-specific cleanup\n\n## Versions\n\n**Current**: v1.7.5 (January 7, 2026)\n\n**What's New in v1.7.5**:\n- **Fixed**: Marketplace schema compliance\n  - Removed context-monitor from marketplace (requires manual install - no `tools` key in schema)\n  - Fixed git-enforcement-hooks to use hooks.json config (schema requires `.json` files)\n  - Added hooks/hooks.json wrapper for Python scripts\n- **git-enforcement-hooks**: Now installable via plugin system\n\n**Previous (v1.7.4)**:\n- Added hooks test suite (13 tests)\n- Fixed GitHub Issues #2, #3, #4\n\n**Previous (v1.7.2)**:\n- context-monitor tool v0.1.0 - Always-visible statusline (manual install only)\n- session-skills v0.5.1: Dual location support\n\n**Previous (v1.6.0)**:\n- git-worktree skill - Interactive git worktree management\n- Repository renamed to \"claude-code-tools\"\n\nSee [CHANGELOG.md](./CHANGELOG.md) for complete version history.\n\n## Contributing\n\nContributions welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n**Quick links**:\n- Issues: https://github.com/ChristopherA/claude_code_tools/issues\n- Pull Requests: https://github.com/ChristopherA/claude_code_tools/pulls\n- Discussions: https://github.com/ChristopherA/claude_code_tools/discussions\n\n## License\n\nBSD-2-Clause-Patent License - see [LICENSE](./LICENSE) file for details\n\n## Author\n\nChristopher Allen (ChristopherA@LifeWithAlacrity.com)\n\n## Acknowledgments\n\nBuilt following [Anthropic's Agent Skills best practices](https://github.com/anthropics/skills) and [Claude Code documentation](https://docs.claude.com/en/docs/claude-code/skills).\n\n---\n\n**Need help?** In Claude Code, try:\n- \"clone worktree from https://github.com/owner/repo\"\n- \"convert to worktree\"\n- \"close context\" or \"resume\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristophera%2Fclaude_code_tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchristophera%2Fclaude_code_tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristophera%2Fclaude_code_tools/lists"}