Skip to content

Releases: Shorzinator/CodeBrief

v1.1.0

17 Jun 08:04

Choose a tag to compare

CodeBrief v1.1.0

From ContextCraft to CodeBrief: Same power, sharper name.

This release marks a major milestone: ContextCraft is now CodeBrief. The name may be new, but the mission is the same — delivering brief, comprehensive code context for AI assistants. All the power you’re used to, now under a name that actually tells people what it does.

🎯 Major Changes

Complete Rebrand to CodeBrief

  • New package name: codebrief (replaces contextcraft)
  • New CLI command: codebrief (replaces contextcraft)
  • Updated branding: Docs, messaging, and references now use CodeBrief
  • Zero feature loss: All functionality and commands preserved

Why "CodeBrief"?

Because it’s what you needed all along — brief but comprehensive summaries of your code. Clear, concise, and not pretending to be clever.

What’s Included

All your favorites are still here:

  • codebrief tree : Generate clean directory structures
  • codebrief flatten : Create LLM-ready code bundles
  • codebrief deps : Extract project dependencies
  • codebrief git-info : Capture git context & recent changes
  • codebrief bundle : Build comprehensive project context bundles

📦 Migration Guide

New Users

pip install codebrief

Existing ContextCraft Users

# Remove the old
pip uninstall contextcraft

# Install the new
pip install codebrief

# Update your commands
# Old: contextcraft tree
# New: codebrief tree

🔄 No Breaking Changes

  • Command arguments and options: unchanged
  • Config files: work the same
  • Output: identical

🎯 Still Solving the Same Problem

CodeBrief is still your shortcut to prepping code for AI tools — from ChatGPT debugging to Claude code reviews. Why waste 10 minutes wrangling files when you can get context in seconds?


CodeBrief: Because great code context shouldn't take 10 minutes.

v1.0.3

15 Jun 18:15

Choose a tag to compare

ContextCraft v1.0.3

The missing link between your codebase and AI assistants.

This release refines ContextCraft's focus on solving the core problem: developers waste 5-10 minutes preparing context for AI tools. We've streamlined our messaging and documentation while maintaining all existing functionality.

What's Changed

Documentation Improvements

  • Restructured documentation around specific developer workflows
  • Simplified visual design for better readability
  • Added problem-focused guides for common use cases
  • Improved navigation and content organization

Repository Updates

  • Updated README with clearer value proposition
  • Refined project description on PyPI
  • Streamlined examples to focus on core workflows

No Breaking Changes

  • All commands function identically to v1.0.2
  • Configuration files remain compatible
  • Test coverage maintained at 77% (175 tests)

Looking Ahead

Future releases will focus on three core capabilities:

Error Context Mode - Pass an error message or stack trace to automatically generate context including relevant source files, test files, and recent changes to those files.

Smart Context Selection - AST-based analysis to include only files with actual dependencies on your target code, reducing noise and staying within LLM token limits.

Semantic Search - Find code by what it does, not just text matching. Search for "authentication flow" and get all relevant auth-related code across your project.

These features target the specific pain point of spending 5-10 minutes manually gathering context before each AI debugging session.

Installation

# If not already installed:
pip install contextcraft

# If already installed:
pip install contextcraft --upgrade

v1.0.2

15 Jun 17:03

Choose a tag to compare

ContextCraft v1.0.2

Turn chaos into context.

This patch release improves the PyPI package experience with a cleaner, more readable package description while maintaining all the production-ready features from v1.0.0.


What's Fixed

  • Fixed Package Installation : Resolved ModuleNotFoundError: No module named 'src' when installing via Poetry
  • Help System Compatibility : Fixed TypeError: Parameter.make_metavar() compatibility issues with newer Click versions
  • Poetry Compatibility : Improved Python version specification for better cross-project compatibility
  • Test Suite Reliability : Enhanced test assertions to handle ANSI color codes across different environments

What's Improved

  • Dependency Management: Updated Typer to >=0.15.0,<1.0.0 for better Click compatibility
  • Python Version Support: Changed from ^3.9 to >=3.9,<4.0 for broader Poetry compatibility
  • Package Structure: Properly configured package mapping for seamless installation
  • Build Artifacts: Added dist/ and build/ to .gitignore following best practices

Quick Start (Unchanged)

pip install contextcraft
cd your-project
contextcraft bundle --to-clipboard
# or
contextcraft bundle -c

Same powerful functionality, now with a better PyPI experience.


📖 Documentation

💬 Community

v1.0.1

15 Jun 07:27

Choose a tag to compare

ContextCraft v1.0.1 – PyPI Compatibility Update

Clean package description, same powerful features.

This patch release improves the PyPI package experience with a cleaner, more readable package description while maintaining all the production-ready features from v1.0.0.


What's Fixed

PyPI Experience Improvements

  • Clean Package Description – Removed complex HTML/CSS that broke PyPI rendering
  • Professional Presentation – Package page now displays properly formatted content
  • Better Discoverability – Improved first impression for new users finding ContextCraft on PyPI

Maintained Excellence

  • All v1.0.0 features and stability preserved
  • 175+ tests, 77% coverage unchanged
  • Production-ready reliability continues
  • Full CI/CD pipeline validated

Quick Start (Unchanged)

pip install contextcraft
cd your-project
contextcraft bundle --to-clipboard

Same powerful functionality, now with a better PyPI experience.


📖 Documentation

💬 Community


ContextCraft 1.0.1 – Same power, cleaner presentation.


Key points for this release:

  • Brief and focused – This is a minor fix, not a major feature release
  • Emphasizes the improvement – Better PyPI experience for new users
  • Reassures existing users – All functionality preserved
  • Professional tone – Matches your established voice
  • Clear value proposition – Better first impressions = more adoption

v1.0.0

15 Jun 07:19

Choose a tag to compare

ContextCraft v1.0.0 – First Major Release

Stop explaining your repo to a chatbot. Let it read your mind.

ContextCraft turns your codebase into a clean, structured bundle of everything an LLM needs to understand your project—without you copy-pasting half your repo into a chat window.


What's New

Full Feature Suite

  • Bundle – One command to generate a complete context snapshot
  • Tree View – Clear, readable project structure
  • Flatten – Combines files into one readable stream, intelligently segmented
  • Dependency Detection – Python and Node.js support out of the box
  • Git Context – Branch, commit history, and diffs—because "why" matters
  • Clipboard Integration – Direct copy support for instant use with any LLM

Built for Production

  • 175+ tests, 77% coverage
  • Bandit and Ruff compliant
  • Mypy validated, type-safe throughout
  • Robust error handling, graceful fallbacks
  • Cross-platform tested—yes, even on Windows

Built for Developers

  • Rich CLI with polished terminal output
  • .llmignore support to keep the noise out
  • Configurable via pyproject.toml, no YAML required
  • Zero fluff, no setup ceremony—just run and get results

Quick Start

pip install contextcraft
cd your-project
contextcraft bundle --to-clipboard

You now have everything your LLM needs to reason about your codebase. Paste it in and get back to real work.


📖 Documentation

💬 Community


ContextCraft 1.0.0 is production-ready. Clean context. Fast output. Built for AI.

No fluff. Just a smarter way to talk to machines.