No AI session escapes. A local CLI for viewing, searching, and managing AI coding sessions across Claude Code, Codex, Gemini, and Cowork.
Project description
hades
The dead or the living will be seen by Hades. No AI session escapes.
A local CLI for viewing, searching, analyzing, and managing your AI coding assistant sessions — Claude Code, Codex CLI, Gemini CLI, and Cowork — all from one place.
Install
pip install hades-cli # or
pipx install hades-cli # or
uv tool install hades-cli
Homebrew tap coming after PyPI validation.
Commands (v1)
hades list [--tool claude|codex|gemini|cowork] [--active] [--since 2d]
hades show <session-id>
hades attention
hades watch [--notify] # --notify is ON by default
Commands (v1.1)
hades search <term> [--tool ...] [--since ...] [--role human|assistant]
hades stats [--by tool|day|project]
hades thinking <session-id>
hades export <session-id> [--md|--json] -o <file>
hades archive <session-id> | --older-than 30d
hades rm <session-id>
Sources (v1)
| Tool | Session data location | Format |
|---|---|---|
| Claude Code | ~/.claude/projects/<encoded-path>/<session-id>.jsonl |
JSONL |
| Codex CLI | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl |
JSONL |
| Gemini CLI | ~/.gemini/tmp/<project-hash>/chats/*.json |
JSON |
| Cowork | ~/Library/Application Support/Claude/local-agent-mode-sessions/** |
Mixed JSON |
Paths are auto-discovered: hardcoded defaults + fallback probing of known locations. Override via env vars (HADES_CLAUDE_PATH, HADES_CODEX_PATH, etc.). No config file in v1.
Cursor deferred to v2 via cursor-session.
Out of scope for v1
- Cursor support
- Editing session content
- GUI/TUI
- Cloud sync or cross-machine aggregation
- Cost/token billing accuracy
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hades_cli-0.1.0.tar.gz.
File metadata
- Download URL: hades_cli-0.1.0.tar.gz
- Upload date:
- Size: 37.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
95a3a8beee3576196a9aeef4778a263b6a31cd071724f8052bd6bc2800019f5d
|
|
| MD5 |
cf42d2c02766ec5bef4f34cf614f7066
|
|
| BLAKE2b-256 |
84373137543c80f66f3d89cba1af946bb27e7f4321309cb772b3319dec398412
|
File details
Details for the file hades_cli-0.1.0-py3-none-any.whl.
File metadata
- Download URL: hades_cli-0.1.0-py3-none-any.whl
- Upload date:
- Size: 18.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
928781a2a6f19c50f4b45fc6c7715d8e201deb12ccc57fe0d7310ce256e8d2ea
|
|
| MD5 |
a7c4cea176721bd18fa10c52401dc70f
|
|
| BLAKE2b-256 |
646ca1a2a5f96617de46518fe03c230f84931d86721205cc0fd1294d735f9fd6
|
