Skip to content

v1.0.0 - Initial Release

Choose a tag to compare

View all tags
@RMLaroche RMLaroche released this 21 Jul 12:47
· 26 commits to main since this release
v1.0.0
40e4348

🎉 codectx v1.0.0 - Initial Release

codectx is an AI-powered code context and file summarization tool that helps developers quickly understand codebases through intelligent analysis and structured summaries.

✨ Key Features

  • 🔄 Smart Update Mode: Only processes files that have changed since last summary (default behavior)
  • 🤖 AI-Powered Summarization: Intelligent analysis of code files with structured output
  • 📊 Enhanced Tables: Color-coded status indicators with emoji headers and real-time updates
  • 🎯 Dynamic Interactive Menu: Shows file counts, greys out options when not needed
  • 📅 Timestamp Tracking: Tracks when each file was last summarized with visual indicators
  • 📁 Smart File Processing: Automatically handles different file types and encodings
  • 🎯 Ignore Patterns: Configurable .codectxignore file with sensible defaults
  • 📊 Real-time Progress: Beautiful console interface with live progress tracking
  • 🔧 Multiple Modes: Update (default), scan all, mock (testing), and copy (raw content) modes
  • 📝 Structured Output: Organized markdown summaries with timestamps and file metadata

🚀 Quick Start

Installation

git clone https://github.com/RMLaroche/codectx.git
cd codectx
pip install -e .

Basic Usage

# Interactive mode with enhanced UI
codectx

# Process changed files only (fastest)
codectx /path/to/your/project

# Test without API calls
codectx --mock-mode

📋 Requirements

  • Python 3.8+
  • AI API key (set as CODECTX_API_KEY environment variable)

🔍 How It Works

  • Files < 200 estimated tokens: Copied as raw content
  • Files ≥ 200 estimated tokens: Sent to AI for intelligent summarization
  • Token estimation: Uses characters ÷ 4 as rough approximation
  • Smart updates: Only reprocesses files modified since their last summary

🤝 Contributing

Contributions welcome! This is the foundation release with core functionality in place.

Made with ❤️ for developers who love clean, documented code.

Assets 2
Loading