archive-session
Skill2 starsChanged 7 months agoMITView on GitHub
Archive session transcripts + subagent logs to browsable HTML and Markdown. Supports relative refs (last, last-1, last-2) or UUID. Default output is docs/process/claudeCodeSessions/exported-on-<timestamp>/. User may override with --output=<path>.
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- grasscaograss/AwesomeWeldoneSkillstheir own version, first seen Jun 2, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- grasscaograss/AwesomeWeldoneSkills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- dep-reconSkill
- upstream-cherry-pickSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 19
Before context gets too large
- Very specific: line 23
No arguments: archives to default location docs/process/claudeCodeSessions/exported-on-<timestamp>/
- Distinctive: line 56
All bash features used are compatible with macOS's default bash 3.2.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
IMPORTANT: Always invoke scripts with relative paths from the project root, never absolute paths. Permission rules use relative patterns -- absolute paths will not match and will trigger a prompt.
Archive Session
Archives the current Claude Code session transcript and any subagent logs, generating browsable HTML and Markdown files.
When to Use
- End of work session for audit trail
- Debugging session or subagent execution
- Before context gets too large
Arguments
- No arguments: archives to default location
docs/process/claudeCodeSessions/exported-on-<timestamp>/ --output=<path>: archives to custom location- Session ref (optional):
last,last-1,last-2, or UUID
What It Does
- Detects current session (most recently modified transcript)
- Archives main session transcript (
session.jsonl) - Archives subagent transcripts if present (
subagents/) - Generates HTML and Markdown files via
claude-code-logdependency, or uvx - Opens HTML in browser
Cross-Platform Support
Works on both macOS and Windows (Git Bash / MSYS2). The script handles the different path formats each OS uses for Claude Code's transcript storage.
Claude Code stores transcripts in ~/.claude/projects/<project-hash>/, where <project-hash> is the project path with path separators and : replaced by -.
macOS:
Project path: /Users/dev/code/my-project
Transcript dir: ~/.claude/projects/-Users-dev-code-my-project/Windows (Git Bash / MSYS2):
Native path: D:\code\my-project
Git Bash pwd: /d/code/my-project
Transcript dir: ~/.claude/projects/D--code-my-project/On Windows, the script detects the MSYS /d/... path format and converts it back to the Windows-native D:/... form before computing the hash. This uses pure string operations (no cygpath dependency).
All bash features used are compatible with macOS's default bash 3.2.
Output Location
Default: docs/process/claudeCodeSessions/exported-on-<timestamp>/
Override: Set either CLAUDE_ARCHIVE_DIR env var or use --output=<path> argument.
Location override: Useful in scenarios where you want to archive to a different location to fit other frameworks and processes.
For example, when using the Get Shit Done CC framework, a better location might be in .planning/sessions/, where that framework generates all of its other plans and records.
Default exported folder structure
docs/process/claudeCodeSessions/exported-on-2026-01-14_15-51-05/
├── session-info.txt # Metadata
├── session.jsonl # Main transcript
├── session.html # Main session HTML
├── session.md # Main session Markdown
└── subagents/ # If subagents exist
├── agent-a2bad1a.jsonl
├── agent-a2bad1a.html # HTML per subagent
├── agent-a2bad1a.md # Markdown per subagent
├── agent-b3cde2b.jsonl
├── agent-b3cde2b.html
├── agent-b3cde2b.md
└── cache/ # Created by claude-code-logUsage
Via Claude Code Skill:
# Archive current session (auto-detected, to default location)
/archive-session
# Archive specific session by UUID
/archive-session 602fca42-0159-466c-bdb7-00745e1939f1
# Archive using relative references
/archive-session last # most recent session (same as no arg)
/archive-session last-1 # second most recent
/archive-session last-2 # third most recent
# Archive to custom location
/archive-session --output=./my-archives
/archive-session last-1 --output=./my-archives
/archive-session 602fca42-0159-466c-bdb7-00745e1939f1 --output=./my-archivesDirect Bash Execution:
# Archive current session
bash .claude/skills/archive-session/scripts/archive.sh
# Archive with relative reference
bash .claude/skills/archive-session/scripts/archive.sh last
bash .claude/skills/archive-session/scripts/archive.sh last-1
# Archive specific UUID
bash .claude/skills/archive-session/scripts/archive.sh 602fca42-0159-466c-bdb7-00745e1939f1
# Archive to custom location via env var
CLAUDE_ARCHIVE_DIR=~/some/other/path bash .claude/skills/archive-session/scripts/archive.sh
# Archive to custom location via arg
bash .claude/skills/archive-session/scripts/archive.sh --output=./my-archives
bash .claude/skills/archive-session/scripts/archive.sh last-1 --output=./my-archivesTUI for Richer Experience
For interactive session management, claude-code-log provides a TUI:
claude-code-log --tui
# or
uvx claude-code-log@latest --tuiFeatures: session list with timestamps/token counts, keyboard nav (h HTML, m Markdown, v view), cross-project traversal, c to resume sessions.
Dependencies
claude-code-log generates browsable HTML reports from transcript files. Primarily a TUI with CLI capabilities for batch export.
You can install it as a project dependency or run it on-demand:
Project dependency (recommended if using frequently):
uv add claude-code-logAdds to pyproject.toml and installs via uv package manager.
On-demand execution (no install):
uvx claude-code-log@latestuvx is uv's tool runner that fetches and runs packages without permanent installation.
The script checks for claude-code-log first, falls back to uvx. If neither available, transcripts are still archived but HTML generation is skipped.
Note: You can also use pip install claude-code-log, but we default to uv for convenience and speed.
Script Location
.claude/skills/archive-session/scripts/archive.shDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

