codetex-mcp 0.1.3__tar.gz

codetex_mcp-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint
+        run: uv run ruff check src/ tests/
+
+      - name: Format check
+        run: uv run ruff format --check src/ tests/
+
+      - name: Type check
+        run: uv run mypy src/
+
+      - name: Test
+        run: uv run pytest --cov=codetex_mcp

codetex_mcp-0.1.3/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    concurrency: release
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Python Semantic Release
+        id: release
+        uses: python-semantic-release/python-semantic-release@v9
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build package
+        if: steps.release.outputs.released == 'true'
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.release.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

codetex_mcp-0.1.3/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.db
+*.sqlite3
+.coverage
+.DS_Store

codetex_mcp-0.1.3/.python-version

@@ -0,0 +1 @@
+3.12

codetex_mcp-0.1.3/CHANGELOG.md

@@ -0,0 +1,41 @@
+# CHANGELOG
+
+
+## v0.1.3 (2026-03-30)
+
+### Bug Fixes
+
+- Add .coverage to .gitignore
+  ([`178b3e9`](https://github.com/mrosata/codetex-mcp/commit/178b3e99a9a202accd0932fd8e2105ef4649d939))
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
+
+## v0.1.2 (2026-03-30)
+
+### Bug Fixes
+
+- **ci**: Move dev deps to dependency-groups and fix lint/format
+  ([`818cb98`](https://github.com/mrosata/codetex-mcp/commit/818cb982a09b251b1834b594c2187f958c703402))
+
+Move dev dependencies (ruff, mypy, pytest) from [project.optional-dependencies] to
+  [dependency-groups] so uv sync installs them automatically in CI. Fix ruff lint errors (unused
+  imports) and apply ruff format across all source files.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
+
+## v0.1.1 (2026-03-29)
+
+### Bug Fixes
+
+- **ci**: Remove build_command from semantic-release config
+  ([`a3dd857`](https://github.com/mrosata/codetex-mcp/commit/a3dd857ae2e6af13b9c5e45d1acec5726f80ecf9))
+
+The PSR GitHub Action runs in a Docker container without uv, causing `uv build` to fail with exit
+  code 127. The workflow already has a separate build step that runs on the runner.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
+
+## v0.1.0 (2026-03-29)

codetex_mcp-0.1.3/CLAUDE.md

@@ -0,0 +1,96 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**codetex-mcp** is a commit-aware code context manager for LLMs, providing both an MCP server (stdio transport) and a CLI. It indexes Git repositories into a multi-tier context hierarchy (repo overview → file summaries → symbol details), stores results in SQLite with sqlite-vec for vector search, and serves them to LLM clients via the MCP protocol.
+
+**Status:** Early stage — project scaffolding and detailed architecture/PRD exist, implementation is in progress.
+
+## Development Environment
+
+- **Python:** >=3.12 (see `.python-version`)
+- **Package Manager:** uv
+- **Linting/Formatting:** ruff
+- **Type Checking:** mypy
+- **Testing:** pytest with pytest-asyncio
+
+## Commands
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run a single test file
+uv run pytest tests/test_storage/test_database.py
+
+# Run tests with coverage
+uv run pytest --cov=codetex_mcp
+
+# Lint and format
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+
+# Type check
+uv run mypy src/
+
+# Run CLI
+uv run codetex <command>
+
+# Run as module
+uv run python -m codetex_mcp
+
+# Run MCP server (stdio transport)
+uv run codetex serve
+```
+
+## Architecture
+
+Two entry points (CLI via Typer, MCP server via FastMCP) share the same core service layer. No DI framework — services are wired manually via a `create_app()` factory.
+
+```
+CLI (typer) ──┐
+              ├──▶ core/ (RepoManager, Indexer, Syncer, ContextStore, SearchEngine)
+MCP (FastMCP)─┘        │           │            │
+                   analysis/    llm/      embeddings/
+                   (tree-sitter + fallback)  (sentence-transformers)
+                        └──────────┼────────────┘
+                              storage/ (SQLite + sqlite-vec)
+                                │
+                          git/ ←─┴──▶ config/
+```
+
+**Key modules under `src/codetex_mcp/`:**
+- `cli/app.py` — Typer app with 8 commands (add, index, sync, context, status, list, serve, config)
+- `server/mcp_server.py` — FastMCP server with 7 tools
+- `core/` — Domain logic (no direct I/O, dependencies injected)
+- `analysis/` — Tree-sitter AST parsing with regex fallback; `parser.py` is the unified dispatcher
+- `llm/provider.py` — Abstract base + Anthropic implementation for tier summarization
+- `embeddings/embedder.py` — sentence-transformers wrapper (lazy model loading)
+- `storage/` — SQLite via aiosqlite; DAO pattern with separate modules per entity (repositories, files, symbols, vectors)
+- `storage/migrations/` — SQL migration files applied by `database.py`
+- `git/operations.py` — Subprocess git wrapper (no GitPython)
+- `config/settings.py` — TOML config loader with env var overrides
+- `exceptions.py` — Error hierarchy (11 exception classes)
+
+**Data model:** Single SQLite database for all repos. 6 main tables (repositories, files, symbols, dependencies, repo_overviews, schema_version) + 2 vector tables (384-dim embeddings for files and symbols).
+
+**Pipelines:** Full index is a 9-step pipeline (discover files → parse AST → generate summaries → embed → store). Incremental sync is a 7-step pipeline using git diff to process only changed files.
+
+## Reference Documents
+
+- `tasks/architecture.md` — Complete technical architecture (module interfaces, data model, pipeline specs, config schema, wiring)
+- `tasks/prd-code-context-manager.md` — Product requirements document
+- `prd.json` — PRD in structured JSON with 20 user stories and acceptance criteria
+
+## Conventions
+
+- All core services are async
+- Tree-sitter grammars are optional extras (installed per-language)
+- Config lives at `~/.codetex/config.toml` at runtime; SQLite database at `~/.codetex/codetex.db`
+- MCP tool responses are structured markdown strings optimized for LLM consumption
+- CLI output uses `rich` for progress bars, tables, and markdown rendering

codetex_mcp-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Rosata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codetex_mcp-0.1.3/PKG-INFO

@@ -0,0 +1,434 @@
+Metadata-Version: 2.4
+Name: codetex-mcp
+Version: 0.1.3
+Summary: Commit-aware code context manager for LLMs - MCP server and CLI
+Project-URL: Homepage, https://github.com/mrosata/codetex-mcp
+Project-URL: Repository, https://github.com/mrosata/codetex-mcp
+Project-URL: Issues, https://github.com/mrosata/codetex-mcp/issues
+Author-email: Michael Rosata <michael.rosata@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: code-context,llm,mcp,sqlite,tree-sitter
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: anthropic>=0.40
+Requires-Dist: mcp>=1.0
+Requires-Dist: pathspec>=0.12
+Requires-Dist: rich>=13.0
+Requires-Dist: sentence-transformers>=3.0
+Requires-Dist: sqlite-vec>=0.1
+Requires-Dist: tiktoken>=0.7
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: typer>=0.9
+Provides-Extra: all-grammars
+Requires-Dist: tree-sitter-cpp>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-go>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-java>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'all-grammars'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'all-grammars'
+Provides-Extra: tree-sitter-cpp
+Requires-Dist: tree-sitter-cpp>=0.23; extra == 'tree-sitter-cpp'
+Provides-Extra: tree-sitter-go
+Requires-Dist: tree-sitter-go>=0.23; extra == 'tree-sitter-go'
+Provides-Extra: tree-sitter-java
+Requires-Dist: tree-sitter-java>=0.23; extra == 'tree-sitter-java'
+Provides-Extra: tree-sitter-javascript
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'tree-sitter-javascript'
+Provides-Extra: tree-sitter-python
+Requires-Dist: tree-sitter-python>=0.23; extra == 'tree-sitter-python'
+Provides-Extra: tree-sitter-ruby
+Requires-Dist: tree-sitter-ruby>=0.23; extra == 'tree-sitter-ruby'
+Provides-Extra: tree-sitter-rust
+Requires-Dist: tree-sitter-rust>=0.23; extra == 'tree-sitter-rust'
+Provides-Extra: tree-sitter-typescript
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'tree-sitter-typescript'
+Description-Content-Type: text/markdown
+
+# codetex-mcp
+
+A commit-aware code context manager for LLMs. Indexes Git repositories into a multi-tier knowledge hierarchy — repo overviews, file summaries, and symbol details — stored in SQLite with vector search. Serves context to LLM clients via the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) or a local CLI.
+
+## What It Does
+
+codetex builds a structured, searchable index of your codebase that LLMs can query on demand:
+
+- **Tier 1 — Repo Overview:** Purpose, architecture, directory structure, key technologies, entry points
+- **Tier 2 — File Summaries:** Per-file purpose, public interfaces, dependencies, roles
+- **Tier 3 — Symbol Details:** Function/class signatures, parameters, return types, call relationships
+
+Summaries are generated by an LLM (Anthropic Claude). Embeddings are computed locally with [sentence-transformers](https://www.sbert.net/) for semantic search. Everything is stored in a single SQLite database with [sqlite-vec](https://github.com/asg017/sqlite-vec) for vector queries.
+
+Incremental sync means only changed files are re-analyzed when you update your code.
+
+## Requirements
+
+- Python 3.12+
+- Git
+- An [Anthropic API key](https://console.anthropic.com/) (for indexing)
+
+## Installation
+
+```bash
+# With pip
+pip install codetex-mcp
+
+# With uv (recommended)
+uv tool install codetex-mcp
+```
+
+### Tree-sitter grammars (optional)
+
+codetex uses tree-sitter for accurate AST parsing. Without grammars installed, it falls back to regex-based extraction that works for any language but is less precise.
+
+Install grammars for the languages you work with:
+
+```bash
+# Individual languages
+pip install "codetex-mcp[tree-sitter-python]"
+pip install "codetex-mcp[tree-sitter-typescript]"
+
+# All 8 supported languages (Python, JS, TS, Go, Rust, Java, Ruby, C/C++)
+pip install "codetex-mcp[all-grammars]"
+```
+
+## Quick Start
+
+### 1. Set your Anthropic API key
+
+```bash
+# Via environment variable
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Or via config
+codetex config set llm.api_key sk-ant-...
+```
+
+### 2. Add a repository
+
+```bash
+# Local repo
+codetex add /path/to/your/project
+
+# Remote repo (clones to ~/.codetex/repos/)
+codetex add https://github.com/user/repo.git
+```
+
+### 3. Index it
+
+```bash
+# Preview what indexing will cost (no API calls)
+codetex index my-project --dry-run
+
+# Build the full index
+codetex index my-project
+```
+
+### 4. Query your codebase
+
+```bash
+# Repo overview (Tier 1)
+codetex context my-project
+
+# File summary (Tier 2)
+codetex context my-project --file src/auth/login.py
+
+# Symbol detail (Tier 3)
+codetex context my-project --symbol authenticate_user
+
+# Semantic search
+codetex context my-project --query "how is authentication implemented?"
+```
+
+### 5. Keep it up to date
+
+```bash
+# Incremental sync — only re-analyzes changed files
+codetex sync my-project
+```
+
+## MCP Server Setup
+
+The MCP server lets LLM clients (like Claude Code, Cursor, Windsurf, etc.) query your indexed codebases directly.
+
+### Claude Code
+
+Add to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "codetex": {
+      "command": "codetex",
+      "args": ["serve"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+If you installed with `uv tool`, use the full path:
+
+```json
+{
+  "mcpServers": {
+    "codetex": {
+      "command": "/path/to/codetex",
+      "args": ["serve"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+Find the path with `which codetex` or `uv tool dir`.
+
+### Other MCP Clients
+
+Any client that supports MCP stdio transport can use codetex. The server command is:
+
+```bash
+codetex serve
+```
+
+### Available MCP Tools
+
+Once connected, the LLM has access to 7 tools:
+
+| Tool | Description |
+|------|-------------|
+| `get_repo_overview` | Tier 1 repo overview (architecture, technologies, entry points) |
+| `get_file_context` | Tier 2 file summary with symbol list |
+| `get_symbol_detail` | Tier 3 full symbol detail (signature, params, relationships) |
+| `search_context` | Semantic search across all indexed context |
+| `get_repo_status` | Index status (staleness, file/symbol counts, last indexed) |
+| `sync_repo` | Trigger incremental sync from within the LLM session |
+| `list_repos` | List all registered repositories |
+
+## CLI Reference
+
+### `codetex add <target>`
+
+Register a git repository. Accepts a local path or remote URL.
+
+```bash
+codetex add .                                    # Current directory
+codetex add /path/to/repo                        # Local path
+codetex add https://github.com/user/repo.git     # Remote (clones locally)
+codetex add git@github.com:user/repo.git         # SSH remote
+```
+
+### `codetex index <repo-name>`
+
+Build a full index for a registered repository.
+
+```bash
+codetex index my-project                # Full index
+codetex index my-project --dry-run      # Preview (files, symbols, estimated LLM calls/tokens)
+codetex index my-project --path src/    # Index only files under src/
+```
+
+### `codetex sync <repo-name>`
+
+Incremental sync to the current HEAD. Only files changed since the last indexed commit are re-analyzed.
+
+```bash
+codetex sync my-project                 # Sync changes
+codetex sync my-project --dry-run       # Preview what would change
+codetex sync my-project --path src/     # Sync only changes under src/
+```
+
+### `codetex context <repo-name>`
+
+Query indexed context at any tier.
+
+```bash
+codetex context my-project                              # Tier 1: repo overview
+codetex context my-project --file src/main.py           # Tier 2: file summary
+codetex context my-project --symbol MyClass             # Tier 3: symbol detail
+codetex context my-project --query "error handling"     # Semantic search
+```
+
+### `codetex status <repo-name>`
+
+Show index status: indexed commit, current HEAD, staleness, file/symbol counts, token usage.
+
+### `codetex list`
+
+List all registered repositories with their index status.
+
+### `codetex config show`
+
+Display the current configuration.
+
+### `codetex config set <key> <value>`
+
+Update a configuration value.
+
+```bash
+codetex config set llm.api_key sk-ant-...
+codetex config set llm.model claude-sonnet-4-5-20250929
+codetex config set indexing.max_file_size_kb 1024
+codetex config set indexing.max_concurrent_llm_calls 10
+```
+
+## Configuration
+
+Configuration is loaded in layers (last wins):
+
+1. **Defaults** — sensible out-of-the-box values
+2. **TOML file** — `~/.codetex/config.toml`
+3. **Environment variables** — override everything
+
+### Config file
+
+```toml
+# ~/.codetex/config.toml
+
+[storage]
+data_dir = "~/.codetex"                  # Base directory for DB and cloned repos
+
+[llm]
+provider = "anthropic"                   # LLM provider (currently: anthropic)
+model = "claude-sonnet-4-5-20250929"     # Model used for summarization
+api_key = "sk-ant-..."                   # Anthropic API key
+
+[indexing]
+max_file_size_kb = 512                   # Skip files larger than this
+max_concurrent_llm_calls = 5             # Parallel LLM requests during indexing
+tier1_rebuild_threshold = 0.10           # Rebuild repo overview if >=10% of files changed on sync
+
+[embedding]
+model = "all-MiniLM-L6-v2"              # Sentence-transformers model for embeddings
+```
+
+### Environment variables
+
+| Variable | Maps to | Example |
+|----------|---------|---------|
+| `ANTHROPIC_API_KEY` | `llm.api_key` | `sk-ant-...` |
+| `CODETEX_DATA_DIR` | `storage.data_dir` | `/custom/path` |
+| `CODETEX_LLM_PROVIDER` | `llm.provider` | `anthropic` |
+| `CODETEX_LLM_MODEL` | `llm.model` | `claude-sonnet-4-5-20250929` |
+| `CODETEX_MAX_FILE_SIZE_KB` | `indexing.max_file_size_kb` | `1024` |
+| `CODETEX_MAX_CONCURRENT_LLM` | `indexing.max_concurrent_llm_calls` | `10` |
+| `CODETEX_TIER1_THRESHOLD` | `indexing.tier1_rebuild_threshold` | `0.15` |
+| `CODETEX_EMBEDDING_MODEL` | `embedding.model` | `all-MiniLM-L6-v2` |
+
+## File Exclusion
+
+Files are filtered through multiple stages:
+
+1. **Default excludes** — `node_modules/`, `__pycache__/`, `.git/`, `dist/`, `build/`, `.venv/`, `*.lock`, `*.min.js`, `*.pyc`, `*.so`, etc.
+2. **`.gitignore`** — standard gitignore rules from your repo
+3. **`.codetexignore`** — same syntax as `.gitignore`, placed in your repo root. Use `!pattern` to un-ignore files
+4. **File size** — files exceeding `max_file_size_kb` are skipped
+5. **Binary detection** — files with null bytes in the first 8 KB are skipped
+
+## Language Support
+
+| Language | Tree-sitter (full AST) | Fallback (regex) |
+|----------|:----------------------:|:-----------------:|
+| Python | Yes | Yes |
+| JavaScript | Yes | Yes |
+| TypeScript | Yes | Yes |
+| Go | Yes | Yes |
+| Rust | Yes | Yes |
+| Java | Yes | Yes |
+| Ruby | Yes | Yes |
+| C/C++ | Yes | Yes |
+| All others | — | Yes |
+
+Tree-sitter grammars are optional. The fallback parser uses regex patterns to extract functions, classes, and imports from any language.
+
+## Architecture
+
+```
+CLI (Typer) ──┐
+              ├──▶ Core Services (Indexer, Syncer, ContextStore, SearchEngine)
+MCP (FastMCP)─┘         │              │              │
+                    Analysis        LLM Provider    Embeddings
+                 (tree-sitter +    (Anthropic)    (sentence-transformers)
+                  regex fallback)       │              │
+                         └──────────────┴──────────────┘
+                                        │
+                                   SQLite + sqlite-vec
+```
+
+- **Two entry points** (CLI and MCP server) share the same core service layer
+- **No DI framework** — services are wired via a `create_app()` factory
+- **All core services are async** — CLI bridges with `asyncio.run()`
+- **Embeddings are local** — no external API calls for vector search (model auto-downloads on first run, ~90 MB)
+- **Single SQLite database** — 6 main tables + 2 vector tables (384-dimensional embeddings)
+
+## Development
+
+```bash
+git clone https://github.com/mrosata/codetex-mcp.git
+cd codetex-mcp
+
+# Install dependencies (including dev)
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run tests with coverage
+uv run pytest --cov=codetex_mcp
+
+# Lint and format
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+
+# Type check
+uv run mypy src/
+```
+
+## Releasing
+
+Releases are automated via GitHub Actions and [python-semantic-release](https://python-semantic-release.readthedocs.io/). Version bumps are driven by **conventional commit messages** on `main`.
+
+### Commit message format
+
+| Prefix | Effect | Example |
+|--------|--------|---------|
+| `fix: ...` | Patch bump (0.1.0 → 0.1.1) | `fix: handle missing gitignore` |
+| `feat: ...` | Minor bump (0.1.0 → 0.2.0) | `feat: add Ruby tree-sitter support` |
+| `feat!: ...` | Major bump (0.1.0 → 1.0.0) | `feat!: redesign context API` |
+| `docs:`, `chore:`, `ci:`, `test:`, `refactor:` | No release | `docs: update README` |
+
+A `BREAKING CHANGE:` line in the commit body also triggers a major bump.
+
+### How it works
+
+1. Push or merge a PR to `main`
+2. CI runs lint, type check, and tests
+3. The release workflow analyzes commits since the last tag
+4. If a version bump is needed, it:
+   - Updates the version in `pyproject.toml`
+   - Creates a git tag (e.g., `v0.2.0`)
+   - Publishes a GitHub Release with a changelog
+   - Builds and publishes the package to PyPI
+
+### Manual release (not recommended)
+
+If you need to release without the automation:
+
+```bash
+uv build
+uv publish
+```
+
+## License
+
+MIT