claude-history 0.5.0__tar.gz

claude_history-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Benjamin Anderson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_history-0.5.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: claude-history
+Version: 0.5.0
+Summary: CLI tool to explore and inspect past Claude Code conversations
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.3.1
+Requires-Dist: orjson>=3.10.0
+Dynamic: license-file
+
+# claude-history
+
+CLI tool to explore and inspect past Claude Code conversation histories.
+
+## Installation
+
+```bash
+# Install with uv
+uv pip install -e .
+
+# Or with pip
+pip install -e .
+```
+
+To also install the Claude Code skill:
+```bash
+./install.sh              # Installs to ~/.claude/skills/
+./install.sh /custom/path # Installs to custom location
+```
+
+## Usage
+
+### List projects
+```bash
+claude-history projects
+```
+Shows all projects with conversation history, conversation counts, and last modified dates.
+
+### List conversations in a project
+```bash
+claude-history list [PROJECT] [-n LIMIT]
+```
+- `PROJECT`: Can be specified in multiple formats:
+  - Full filesystem path: `/Users/bob/myproject`
+  - Project name suffix: `myproject` (matches any project ending with that name)
+  - Path as shown by `projects` command: `/Users/bob/myproject`
+- Without argument: lists recent conversations across all projects
+
+### View a conversation
+```bash
+claude-history view SESSION_ID [-f|--full] [--no-tools] [-n LIMIT] [-o OFFSET]
+```
+- `SESSION_ID`: Full ID, partial ID (e.g., first 8 chars), or file path
+- `-f`: Show full message content (not truncated)
+- `--no-tools`: Hide tool use details
+- `-n`: Limit messages shown
+- `-o`: Skip first N messages
+
+### Quick summary
+```bash
+claude-history summary SESSION_ID
+```
+Shows conversation metadata and a compact flow of user/assistant exchanges with tools used.
+
+### Search conversations
+```bash
+claude-history search QUERY [-n LIMIT]
+```
+Search all conversations for a text string.
+
+### Generate catchup context
+```bash
+claude-history catchup SESSION_ID [-c MAX_CHARS] [--include-tools]
+```
+Generates a markdown summary suitable for pasting into a new Claude session to restore context.
+
+### Project summary
+```bash
+claude-history project-summary PROJECT_PATH [-n LIMIT] [-c MAX_CHARS]
+```
+Summarizes recent conversations in a project.
+
+### Export
+```bash
+claude-history export SESSION_ID [-f text|json]
+```
+Export conversation to simplified text or JSON format.
+
+## Common Workflows
+
+### Catching up on a previous session
+```bash
+# Find the session
+claude-history list /path/to/project -n 10
+
+# Get a catchup summary to paste into new context
+claude-history catchup abc123def
+```
+
+### Finding where something was discussed
+```bash
+claude-history search "authentication bug"
+```
+
+### Understanding project history
+```bash
+claude-history project-summary /path/to/project -n 5
+```
+
+## License
+
+MIT

claude_history-0.5.0/README.md

@@ -0,0 +1,102 @@
+# claude-history
+
+CLI tool to explore and inspect past Claude Code conversation histories.
+
+## Installation
+
+```bash
+# Install with uv
+uv pip install -e .
+
+# Or with pip
+pip install -e .
+```
+
+To also install the Claude Code skill:
+```bash
+./install.sh              # Installs to ~/.claude/skills/
+./install.sh /custom/path # Installs to custom location
+```
+
+## Usage
+
+### List projects
+```bash
+claude-history projects
+```
+Shows all projects with conversation history, conversation counts, and last modified dates.
+
+### List conversations in a project
+```bash
+claude-history list [PROJECT] [-n LIMIT]
+```
+- `PROJECT`: Can be specified in multiple formats:
+  - Full filesystem path: `/Users/bob/myproject`
+  - Project name suffix: `myproject` (matches any project ending with that name)
+  - Path as shown by `projects` command: `/Users/bob/myproject`
+- Without argument: lists recent conversations across all projects
+
+### View a conversation
+```bash
+claude-history view SESSION_ID [-f|--full] [--no-tools] [-n LIMIT] [-o OFFSET]
+```
+- `SESSION_ID`: Full ID, partial ID (e.g., first 8 chars), or file path
+- `-f`: Show full message content (not truncated)
+- `--no-tools`: Hide tool use details
+- `-n`: Limit messages shown
+- `-o`: Skip first N messages
+
+### Quick summary
+```bash
+claude-history summary SESSION_ID
+```
+Shows conversation metadata and a compact flow of user/assistant exchanges with tools used.
+
+### Search conversations
+```bash
+claude-history search QUERY [-n LIMIT]
+```
+Search all conversations for a text string.
+
+### Generate catchup context
+```bash
+claude-history catchup SESSION_ID [-c MAX_CHARS] [--include-tools]
+```
+Generates a markdown summary suitable for pasting into a new Claude session to restore context.
+
+### Project summary
+```bash
+claude-history project-summary PROJECT_PATH [-n LIMIT] [-c MAX_CHARS]
+```
+Summarizes recent conversations in a project.
+
+### Export
+```bash
+claude-history export SESSION_ID [-f text|json]
+```
+Export conversation to simplified text or JSON format.
+
+## Common Workflows
+
+### Catching up on a previous session
+```bash
+# Find the session
+claude-history list /path/to/project -n 10
+
+# Get a catchup summary to paste into new context
+claude-history catchup abc123def
+```
+
+### Finding where something was discussed
+```bash
+claude-history search "authentication bug"
+```
+
+### Understanding project history
+```bash
+claude-history project-summary /path/to/project -n 5
+```
+
+## License
+
+MIT

claude_history-0.5.0/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "claude-history"
+version = "0.5.0"
+description = "CLI tool to explore and inspect past Claude Code conversations"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "click>=8.3.1",
+    "orjson>=3.10.0",
+]
+
+[project.scripts]
+claude-history = "claude_history.cli:main"
+
+[dependency-groups]
+dev = []

claude_history-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_history-0.5.0/src/claude_history/__init__.py

@@ -0,0 +1,3 @@
+"""Claude Code conversation history viewer."""
+
+__version__ = "0.1.0"