Skip to content

Release 0.3.0

Choose a tag to compare

@github-actions github-actions released this 08 Jan 08:01
· 1 commit to main since this release

What's New in v0.3.0

🎯 Token Tracking

  • Always shows token count: Processed 15 files (~46.2K tokens)
  • --max-tokens flag: Skip files that would exceed a token budget
  • Threshold warnings: Alerts at 128K, 200K, and 1M tokens

⚡ Improved Error Handling (Breaking Change)

  • Removed defensive exception handling - errors now surface clearly
  • Removed ImportError fallbacks for Pillow/mutagen
  • If something breaks, you'll know about it immediately

🔧 Code Quality

  • Refactored should_exclude() into smaller, focused helper functions
  • Added CI linting with ruff and mypy
  • Expanded test coverage (27 tests)

Breaking Changes

This release removes defensive code that could hide errors:

  • Bare except Exception: blocks have been removed
  • ImportError fallbacks for optional dependencies removed (Pillow/mutagen are required)

If you were relying on silent fallback behavior, ensure dependencies are properly installed.

Usage Example

# See token count in output
llmcontext . output.txt
# Processed 42 files (~85K tokens)

# Limit token budget
llmcontext --max-tokens 100000 . output.txt
# Skips files that would exceed the budget

Installation

pipx install git+https://github.com/speakman/llmcontext.git@v0.3.0

Full Changelog: v0.2.4...v0.3.0