claude-history 0.5.0__tar.gz → 0.6.1__tar.gz

{claude_history-0.5.0/src/claude_history.egg-info → claude_history-0.6.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: claude-history
-Version: 0.5.0
+Version: 0.6.1
 Summary: CLI tool to explore and inspect past Claude Code conversations
-Requires-Python: >=3.13
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.3.1
@@ -23,7 +23,7 @@ uv pip install -e .
 pip install -e .
 ```
 
-To also install the Claude Code skill:
+To also install the agent skill:
 ```bash
 ./install.sh              # Installs to ~/.claude/skills/
 ./install.sh /custom/path # Installs to custom location

{claude_history-0.5.0 → claude_history-0.6.1}/README.md

@@ -12,7 +12,7 @@ uv pip install -e .
 pip install -e .
 ```
 
-To also install the Claude Code skill:
+To also install the agent skill:
 ```bash
 ./install.sh              # Installs to ~/.claude/skills/
 ./install.sh /custom/path # Installs to custom location

{claude_history-0.5.0 → claude_history-0.6.1}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "claude-history"
-version = "0.5.0"
+version = "0.6.1"
 description = "CLI tool to explore and inspect past Claude Code conversations"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.10"
 dependencies = [
     "click>=8.3.1",
     "orjson>=3.10.0",
@@ -14,3 +14,9 @@ claude-history = "claude_history.cli:main"
 
 [dependency-groups]
 dev = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+claude_history = ["skill/*"]

{claude_history-0.5.0 → claude_history-0.6.1}/src/claude_history/cli.py

@@ -2,6 +2,7 @@
 
 import os
 import re
+import shutil
 from pathlib import Path
 
 import click
@@ -511,19 +512,20 @@ def export(session_id: str, output_format: str):
     if output_format == "json":
         import json
 
+        messages: list[dict] = []
         output = {
             "session_id": conv.session_id,
             "title": conv.title,
             "cwd": conv.cwd,
             "git_branch": conv.git_branch,
             "start_time": conv.start_time.isoformat() if conv.start_time else None,
-            "messages": [],
+            "messages": messages,
         }
 
         for msg in conv.messages:
             if msg.is_meta:
                 continue
-            output["messages"].append(
+            messages.append(
                 {
                     "role": msg.role,
                     "text": msg.text,
@@ -736,6 +738,56 @@ def project_summary(project: str, limit: int, max_chars: int):
     click.echo(f"\n({len(output)} characters)", err=True)
 
 
+@cli.command("install-skill")
+@click.option(
+    "-d",
+    "--dest",
+    type=click.Path(),
+    default=None,
+    help="Destination directory (default: ~/.claude/skills)",
+)
+@click.option("-f", "--force", is_flag=True, help="Overwrite existing skill")
+def install_skill(dest: str | None, force: bool):
+    """Install the agent skill for claude-history to ~/.claude/skills/.
+
+    This makes the claude-history skill available to Claude Code (or other coding agents).
+    """
+    # Determine destination
+    if dest:
+        dest_dir = Path(dest)
+    else:
+        dest_dir = Path.home() / ".claude" / "skills"
+
+    skill_dest = dest_dir / "claude-history"
+
+    # Check if already exists
+    if skill_dest.exists() and not force:
+        echo(f"Skill already exists at {skill_dest}")
+        echo("Use --force to overwrite")
+        return
+
+    # Get the bundled skill directory
+    import claude_history
+
+    skill_source = Path(claude_history.__file__).parent / "skill"
+
+    if not skill_source.is_dir():
+        echo(f"Error: Bundled skill not found at {skill_source}")
+        return
+
+    # Create destination directory
+    dest_dir.mkdir(parents=True, exist_ok=True)
+
+    # Remove existing if force
+    if skill_dest.exists():
+        shutil.rmtree(skill_dest)
+        echo(f"Removed existing skill at {skill_dest}")
+
+    # Copy skill
+    shutil.copytree(skill_source, skill_dest)
+    echo(f"Installed skill to {skill_dest}")
+
+
 def main():
     """Entry point for the CLI."""
     cli()

claude_history-0.6.1/src/claude_history/skill/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: claude-history
+description: |
+  CLI tool to explore and inspect past Claude Code conversation histories. Use this skill when:
+  - You need to catch up on a previous conversation that ran out of context
+  - You want to review what was discussed or accomplished in past sessions
+  - You need to search across conversation history for specific topics
+  - You want to generate a summary of past work to paste into a new session
+  - The user asks about their Claude Code conversation history
+  - The user wants to resume work from a previous session and needs context
+---
+
+# Claude History CLI
+
+A tool to explore past Claude Code conversations stored in `~/.claude/projects/`.
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install claude-history
+
+# Install the Claude Code skill (default: ~/.claude/skills/)
+claude-history install-skill
+
+# Install to a custom location (e.g., for Codex)
+claude-history install-skill -d ~/.codex/skills
+```
+
+## Commands
+
+### 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. Output goes to stdout.
+
+### Project summary
+```bash
+claude-history project-summary PROJECT_PATH [-n LIMIT] [-c MAX_CHARS]
+```
+Summarizes recent conversations in a project - useful for understanding project history across sessions.
+
+### 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 > catchup.md
+```
+
+### Finding where something was discussed
+```bash
+claude-history search "authentication bug"
+```
+
+### Understanding project history
+```bash
+claude-history project-summary /path/to/project -n 5
+```

{claude_history-0.5.0 → claude_history-0.6.1/src/claude_history.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: claude-history
-Version: 0.5.0
+Version: 0.6.1
 Summary: CLI tool to explore and inspect past Claude Code conversations
-Requires-Python: >=3.13
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.3.1
@@ -23,7 +23,7 @@ uv pip install -e .
 pip install -e .
 ```
 
-To also install the Claude Code skill:
+To also install the agent skill:
 ```bash
 ./install.sh              # Installs to ~/.claude/skills/
 ./install.sh /custom/path # Installs to custom location

{claude_history-0.5.0 → claude_history-0.6.1}/src/claude_history.egg-info/SOURCES.txt

@@ -9,4 +9,5 @@ src/claude_history.egg-info/SOURCES.txt
 src/claude_history.egg-info/dependency_links.txt
 src/claude_history.egg-info/entry_points.txt
 src/claude_history.egg-info/requires.txt
-src/claude_history.egg-info/top_level.txt
+src/claude_history.egg-info/top_level.txt
+src/claude_history/skill/SKILL.md