Claude Code Sessions
FreeManage and analyze your Claude Code session history.
Free · Opens the source repo
What Claude Code Sessions does
Claude Code Sessions is a powerful plugin designed for users of Claude Code who want to efficiently manage and analyze their session history. By reading the JSONL session files generated by Claude Code, this skill allows users to perform full-text searches, review token usage, and track tasks across multiple sessions. The plugin provides a comprehensive set of 11 skills that can be invoked directly within Claude Code, making it easier to find specific sessions, compare approaches, and resume previous work without losing context.
The plugin's capabilities include a web dashboard that serves as a user-friendly interface for accessing session data. Users can view summary statistics, sort session lists, perform full-text searches, and manage tasks grouped by their status. This dashboard enhances the usability of the plugin, allowing for quick access to important information and facilitating better project management. The inclusion of features like session comparison and task tracking makes it particularly useful for developers and designers who need to maintain oversight of their work across multiple sessions.
Installation is straightforward, requiring no API keys or additional configuration, as it operates directly on the existing session files stored on disk. This means that users can start leveraging the benefits of the plugin almost immediately after installation. The underlying architecture is built with TypeScript, ensuring that the skills, dashboard, and command-line interface are all seamlessly integrated, providing a consistent experience across different modes of interaction.
Overall, Claude Code Sessions is an essential tool for anyone who frequently uses Claude Code and wants to enhance their productivity by effectively managing their session history and tasks. Whether you are tracking token usage or looking to resume a specific project, this plugin streamlines the process and provides valuable insights into your coding sessions.
When to use it
Use this skill when you need to search through past sessions, analyze token usage, or manage tasks across multiple projects.
When not to use it
This skill may not be suitable for users who do not utilize Claude Code or those who prefer not to analyze session data.
What you can build with it
Find Past Solutions
Quickly locate the session where you solved a specific problem weeks ago using the session search functionality.
Analyze Token Usage
Track which projects consume the most tokens to optimize your usage and manage costs effectively.
Manage Pending Tasks
Easily find and review pending tasks across all your sessions to ensure nothing is overlooked.
How to install Claude Code Sessions
View source1. Install with the skills CLI
npx skills add davila7/claude-code-templates/claude-code-sessions --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by davila7Claude Code Sessions
Session intelligence plugin for Claude Code. Reads the JSONL session files that Claude Code writes to ~/.claude/projects/ and makes them searchable and analyzable.
What It Does
Claude Code records every session as a JSONL file — messages, tool calls, token counts, diffs, tasks. This plugin reads those files and provides two interfaces. Most operations are read-only; delete and cleanup skills can remove session files when explicitly invoked.
11 skills usable directly in Claude Code:
| Skill | Purpose |
|---|---|
/session-search "query" | Full-text search across every session |
/session-stats | Token usage, model distribution, tool breakdown |
/session-list | List sessions sorted by recency, size, or duration |
/session-detail | Deep dive into a specific session |
/session-diff | Compare two sessions — files, tools, topics |
/session-timeline | Chronological view of sessions on a project |
/session-resume | Generate a context recovery prompt from any session |
/session-tasks | Find pending and orphaned tasks across sessions |
/session-export | Export a session as clean markdown |
/session-cleanup | Find empty, tiny, or stale sessions |
/session-delete | Delete sessions and their associated tasks |
Web dashboard at localhost:3000 with four views: Dashboard (summary stats), Sessions (sortable table with bulk operations), Search (full-text with context snippets), Tasks (grouped by status with orphan detection).
Install
/plugin marketplace add apappascs/claude-code-sessions
/plugin install claude-code-sessions@claude-code-sessions
No API keys. No config. No runtime dependencies. It reads what's already on disk.
For the dashboard:
bun run ui
# → http://localhost:3000
Architecture
Same TypeScript modules power skills, dashboard, and CLI:
lib/formatters.ts — pure utilities, no I/O
lib/session-parser.ts — parses one JSONL file into structured data
lib/session-store.ts — scans all sessions, aggregates, searches
ui/server.ts — HTTP endpoints + static file serving
Each lib file doubles as a standalone CLI:
bun run lib/session-store.ts list --sort recency --limit 10
bun run lib/session-store.ts search "database migration" --since 2025-01-01
bun run lib/session-parser.ts stats path/to/session.jsonl
Use Cases
- Find the session where you solved a specific problem weeks ago
- See which projects consume the most tokens
- Track pending tasks across all sessions and projects
- Resume a past session with full context
- Compare how two sessions approached the same problem
- Export session transcripts for documentation
Links
- GitHub: github.com/apappascs/claude-code-sessions
- License: MIT
Frequently asked questions about Claude Code Sessions
Similar skills
Canva Creator
Streamline your content campaign from brief to HubSpot.
Cowork Plugin Customization
Tailor your Claude Code plugin to fit your organization.
Impediment Prioritization
Rank and prioritize impediments effectively.
Chronicle
Streamline your Copilot session analysis and reporting.
Idea Refine
Transform vague ideas into actionable concepts.
App Store Optimization
Optimize your mobile app's visibility and performance.