claugs 0.5.0__tar.gz

claugs-0.5.0/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+dist/

claugs-0.5.0/LICENSE

@@ -0,0 +1,13 @@
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

claugs-0.5.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: claugs
+Version: 0.5.0
+Summary: Parse and prettify Claude Code JSONL session logs
+Project-URL: Homepage, https://github.com/shitchell/claugs
+Project-URL: Repository, https://github.com/shitchell/claugs
+Project-URL: Issues, https://github.com/shitchell/claugs/issues
+Author: Shaun Mitchell
+License-Expression: WTFPL
+License-File: LICENSE
+Keywords: anthropic,claude,cli,jsonl,logs
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: Public Domain
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dateutil>=2.8
+Requires-Dist: typing-extensions>=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: watch
+Requires-Dist: watchdog>=3.0; extra == 'watch'
+Description-Content-Type: text/markdown
+
+# claude-stream
+
+[![PyPI version](https://badge.fury.io/py/claude-stream.svg)](https://pypi.org/project/claude-stream/)
+
+Parse and prettify Claude Code JSONL stream output.
+
+![claude-stream output](screenshots/compact.png)
+
+## Installation
+
+```bash
+pip install claude-stream
+```
+
+For file watching support:
+
+```bash
+pip install "claude-stream[watch]"
+```
+
+---
+
+![claude-stream watch mode](screenshots/demo.gif)
+
+## Usage
+
+```bash
+# Read from a file
+claude-stream session.jsonl
+
+# Show only last N lines
+claude-stream session.jsonl -n 20
+
+# Read from stdin
+cat session.jsonl | claude-stream
+
+# Parse the most recent session
+claude-stream --latest
+claude-stream --latest -n 50              # Last 50 lines
+
+# Find and parse a session by UUID
+claude-stream --session abc123
+```
+
+### Watch Mode
+
+Watch for new messages in real-time (like `tail -f`):
+
+```bash
+# Watch all Claude sessions
+claude-stream --watch ~/.claude/projects/
+
+# Watch from any project directory (auto-resolves to Claude path)
+claude-stream --watch .
+claude-stream --watch ~/myproject
+
+# Watch with initial context (last N lines)
+claude-stream --watch . -n 10
+```
+
+When given a directory outside `~/.claude`, the path is automatically
+converted to Claude's project format (e.g., `/home/user/project` becomes
+`~/.claude/projects/-home-user-project`).
+
+### Output Formats
+
+```bash
+# ANSI terminal colors (default for TTY)
+claude-stream session.jsonl
+
+# Markdown
+claude-stream --format markdown session.jsonl > export.md
+
+# Plain text (default when piped)
+claude-stream session.jsonl | less
+```
+
+Output automatically switches to plain text when piped. Use `--format ansi` to force colors.
+
+### Filtering
+
+```bash
+# Show only specific message types
+claude-stream --show-type assistant --show-type user session.jsonl
+
+# Show only messages with specific tools
+claude-stream --show-tool Bash --show-tool Read session.jsonl
+
+# Grep for patterns
+claude-stream --grep "error" session.jsonl
+
+# Exclude patterns
+claude-stream --exclude "thinking" session.jsonl
+```
+
+### Display Options
+
+```bash
+# Hide thinking blocks
+claude-stream --hide-thinking session.jsonl
+
+# Hide tool results
+claude-stream --hide-tool-results session.jsonl
+
+# Show metadata (UUIDs, timestamps)
+claude-stream --show-metadata session.jsonl
+
+# Compact mode (hide thinking, tool results, metadata)
+claude-stream --compact session.jsonl
+
+# Show line numbers
+claude-stream --line-numbers session.jsonl
+```
+
+## Architecture
+
+- **Pydantic models** parse JSON into typed message structures
+- **Messages** produce `RenderBlock` lists (flexible rendering primitives)
+- **Formatters** convert `RenderBlocks` to output formats (ANSI, Markdown, Plain)
+
+## License
+
+[WTFPL](http://www.wtfpl.net/)

claugs-0.5.0/README.md

@@ -0,0 +1,123 @@
+# claude-stream
+
+[![PyPI version](https://badge.fury.io/py/claude-stream.svg)](https://pypi.org/project/claude-stream/)
+
+Parse and prettify Claude Code JSONL stream output.
+
+![claude-stream output](screenshots/compact.png)
+
+## Installation
+
+```bash
+pip install claude-stream
+```
+
+For file watching support:
+
+```bash
+pip install "claude-stream[watch]"
+```
+
+---
+
+![claude-stream watch mode](screenshots/demo.gif)
+
+## Usage
+
+```bash
+# Read from a file
+claude-stream session.jsonl
+
+# Show only last N lines
+claude-stream session.jsonl -n 20
+
+# Read from stdin
+cat session.jsonl | claude-stream
+
+# Parse the most recent session
+claude-stream --latest
+claude-stream --latest -n 50              # Last 50 lines
+
+# Find and parse a session by UUID
+claude-stream --session abc123
+```
+
+### Watch Mode
+
+Watch for new messages in real-time (like `tail -f`):
+
+```bash
+# Watch all Claude sessions
+claude-stream --watch ~/.claude/projects/
+
+# Watch from any project directory (auto-resolves to Claude path)
+claude-stream --watch .
+claude-stream --watch ~/myproject
+
+# Watch with initial context (last N lines)
+claude-stream --watch . -n 10
+```
+
+When given a directory outside `~/.claude`, the path is automatically
+converted to Claude's project format (e.g., `/home/user/project` becomes
+`~/.claude/projects/-home-user-project`).
+
+### Output Formats
+
+```bash
+# ANSI terminal colors (default for TTY)
+claude-stream session.jsonl
+
+# Markdown
+claude-stream --format markdown session.jsonl > export.md
+
+# Plain text (default when piped)
+claude-stream session.jsonl | less
+```
+
+Output automatically switches to plain text when piped. Use `--format ansi` to force colors.
+
+### Filtering
+
+```bash
+# Show only specific message types
+claude-stream --show-type assistant --show-type user session.jsonl
+
+# Show only messages with specific tools
+claude-stream --show-tool Bash --show-tool Read session.jsonl
+
+# Grep for patterns
+claude-stream --grep "error" session.jsonl
+
+# Exclude patterns
+claude-stream --exclude "thinking" session.jsonl
+```
+
+### Display Options
+
+```bash
+# Hide thinking blocks
+claude-stream --hide-thinking session.jsonl
+
+# Hide tool results
+claude-stream --hide-tool-results session.jsonl
+
+# Show metadata (UUIDs, timestamps)
+claude-stream --show-metadata session.jsonl
+
+# Compact mode (hide thinking, tool results, metadata)
+claude-stream --compact session.jsonl
+
+# Show line numbers
+claude-stream --line-numbers session.jsonl
+```
+
+## Architecture
+
+- **Pydantic models** parse JSON into typed message structures
+- **Messages** produce `RenderBlock` lists (flexible rendering primitives)
+- **Formatters** convert `RenderBlocks` to output formats (ANSI, Markdown, Plain)
+
+## License
+
+[WTFPL](http://www.wtfpl.net/)

claugs-0.5.0/docs/plans/2026-02-23-user-message-subtypes-design.md

@@ -0,0 +1,45 @@
+# User Message Subtypes
+
+## Problem
+
+Claude Code's JSONL format stores three distinct categories of content as `type: "user"` messages:
+
+1. **Real user input** - what the human typed
+2. **Tool results** - responses from tool calls (Bash, Read, etc.)
+3. **System-injected meta content** - skill loading, system reminders (`isMeta: true`)
+
+This means `--show-type user` shows all three, `--hide-tool-results` only suppresses rendered content (not the messages themselves), and system-injected content renders with a `USER` header indistinguishable from real input.
+
+## Design
+
+### Subtype classification
+
+Each `type: "user"` message gets a subtype based on JSONL fields:
+
+| Subtype | Detection |
+|---------|-----------|
+| `user-input` | No `toolUseResult`, no `isMeta`, content is string |
+| `tool-result` | Has `toolUseResult` (not subagent) |
+| `subagent-result` | `toolUseResult` with `agentId` |
+| `meta` | `isMeta: true` |
+| `local-command` | Content starts with `<command-name>` or `<local-command-stdout>` |
+
+### Filtering
+
+`--show-subtype` applies to user messages via their computed subtype. Without `--show-subtype`, all subtypes display (backward compatible).
+
+Example: `--show-type user --show-subtype user-input` shows only real human input.
+
+### `--hide-tool-results` fix
+
+When `show_tool_results=False`, tool-result and subagent-result user messages are fully filtered out in `should_show_message()`, not just content-suppressed.
+
+### Meta rendering
+
+Messages with `isMeta: true` render as `USER [meta]` instead of plain `USER`.
+
+## Changes
+
+1. **`models.py`**: Add `isMeta` field, `get_subtype()` method, `[meta]` tag in `render_user_input()`
+2. **`stream.py`**: Subtype filtering for user messages, `--hide-tool-results` suppression
+3. **`cli.py`**: No changes needed (existing flags sufficient)