docs-kit 0.1.3__tar.gz → 0.1.5__tar.gz

docs_kit-0.1.5/AGENTS.md

@@ -0,0 +1,76 @@
+# docs-kit — Agent Instructions
+
+## Scope
+
+This document applies to AI agents working on the **docs-kit** codebase: a **PyPI** package (and optional **npx** wrapper) that **fetches documentation** (GitBook, Mintlify, or local files), **stores and embeds it locally** (markdown on disk + Qdrant), and **teaches coding agents to call the CLI** via **installed skills** — not via an MCP server.
+
+---
+
+## What the product does
+
+1. **Fetch** — Fetchers use `/llms-full.txt` and `/llms.txt` on public doc sites; **Mintlify** also falls back to `/sitemap.xml` when needed. **GitBook** and **Mintlify** are supported; `docs-kit ingest` accepts `--provider auto|gitbook|mintlify`.
+2. **Local storage** — `docs-kit fetch` writes `.md` files; `docs-kit ingest` chunks, embeds with FastEmbed (dense + sparse/BM25), and upserts into local Qdrant. Concurrent CLI processes coordinate with **filelock** on the Qdrant path.
+3. **Agent integration** — `docs-kit install <agent>` installs **skill templates** (`docs_kit/templates/`) so agents run **`docs-kit` CLI** commands (`query`, `list`, `ingest`, `remove`, `inspect`, `doctor`, etc.). **Claude Desktop** gets a zip to upload in the app; **Cursor** may also get a home-level `AGENTS.md` fallback fragment.
+4. **Install targets** (see `INSTALL_TARGETS` in `docs_kit/cli/commands.py`): `claude-code`, `claude-desktop`, `cursor`, `codex`, `codex-app`, `codex-desktop`, `opencode`.
+
+The **npx** package under `npx-wrapper/` ensures Python 3.11+ and installs/runs the **`docs-kit`** Python module; behavior lives in Python.
+
+---
+
+## Security (Non-Negotiable)
+
+- **MUST NOT** read, access, or reference `.env`, `.env.local`, `.env.*`, or any secret/credentials files.
+- **MUST NOT** recommend reading environment files. If config is needed, ask the user for non-sensitive details.
+- **MUST** treat `.env` files as if they do not exist.
+
+---
+
+## Verification After Changes
+
+From the repository root:
+
+```bash
+pytest tests/ -v
+```
+
+- **MUST NOT** claim work is complete without a successful test run when behavior or dependencies changed.
+
+---
+
+## Skill templates (`docs_kit/templates/`)
+
+Skills installed by `docs-kit install` come from these Markdown templates.
+
+- **MUST** review `docs_kit/templates/` after **major** CLI or install-flow changes (new or removed commands, renamed options, changed defaults, new `INSTALL_TARGETS`, different recommended workflows).
+- **MUST** edit the relevant templates when skill text or examples would be wrong or misleading; **need not** update templates when the change does not affect what installed skills describe.
+- If you are unsure whether agents would see outdated instructions, check the templates and align them with `docs_kit/cli/commands.py` and install behavior.
+
+---
+
+## Git Commit Workflow
+
+When the user asks to commit, stage, or write a commit message:
+
+1. **MUST** analyze staged/unstaged changes via `git status` and `git diff` in the relevant git root.
+2. **MUST** write a commit message following Conventional Commits:
+   - `feat:` — new feature
+   - `fix:` — bug fix
+   - `chore:` — maintenance, deps, config
+   - `docs:` — documentation only
+   - `style:` — formatting, no logic change
+   - `refactor:` — code restructure
+   - `test:` — tests only
+   - `perf:` — performance
+3. **SHOULD** keep subject line under 50 chars, imperative mood; use bullet points in body.
+4. **SHOULD** suggest splitting into atomic commits if changes span unrelated concerns.
+
+---
+
+## Project Context (Brief)
+
+- **Package name:** `docs-kit` (import `docs_kit`, CLI `docs-kit`). **Python:** `>=3.11,<3.14` (`pyproject.toml`); no `mcp` dependency in this tree.
+- **Main types:** `DocsKitConfig` (`docs_kit/core/config.py`), `DocsKitAgent` (`docs_kit/agent.py`).
+- **CLI:** `docs_kit/cli/commands.py` + `docs_kit/cli/__main__.py` — `init`, `fetch`, `ingest`, `query`, `inspect`, `doctor`, `install`, `remove`, `list`.
+- **Fetchers:** `docs_kit/connectors/fetchers/gitbook.py`, `mintlify.py`, shared `llms_txt` helpers.
+- **Skills / install artifacts:** `docs_kit/templates/` (e.g. `skill.md`, `claude_code_skill.md`, `cursor_agents_md.md`).
+- **Docs:** [README.md](README.md) for user-facing quickstart (if it diverges from the repo, trust the code and `docs/project-overview.md` for architecture).

docs_kit-0.1.5/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.5] - 2026-03-28
+
+### Added
+
+- `docs-kit query --full` to print full chunk text; default preview truncation increased to 1500 characters (from 300).
+- Markdown chunking that keeps tables and fenced code blocks intact when possible: large tables split on row boundaries with header repeated; large code blocks split on lines with opening/closing fences preserved in each part.
+- Tests covering table/code chunking, list-heavy sections, and headers inside fences.
+
+### Changed
+
+- `docs-kit install codex` (and `codex-app` / `codex-desktop`) writes the skill to `~/.codex/skills/docs-kit/SKILL.md` and mirrors the same content to `~/.agents/skills/docs-kit/SKILL.md` for compatibility with shared agent layouts.
+- `docs-kit doctor` lists installed skills with install-target labels (`claude-code`, `cursor`, `codex`, `codex-shared`, `opencode`, `claude-desktop`) and suggests the matching `docs-kit install <target>` command when missing.
+
+### Fixed
+
+- Chunking no longer merges or normalizes markdown tables and code fences in ways that broke pipe layout or list structure.
+
+## [0.1.4] - 2026-03-28
+
+### Changed (breaking)
+
+- Removed the MCP server and MCP dependencies; agents use installed skill files that invoke the `docs-kit` CLI directly (`query`, `list`, `ingest`, `remove`, `inspect`, `doctor`, etc.).
+- CLI: added `list` and `remove`; removed `serve` and `stop`.
+- `docs-kit install` writes skills for Claude Code, Cursor, Codex, OpenCode, Claude Desktop, and related targets under `docs_kit/templates/`.
+- `doctor` checks PATH, config, Qdrant, and installed skill paths.
+- Local Qdrant access is serialized with `filelock` for concurrent CLI use.
+- Python support remains `>=3.11,<3.14`.
+
+## [0.1.3] - 2026-03-28
+
+### Added
+
+- `docs-kit serve` as a background daemon (PID + logs) and `docs-kit stop`.
+- Default MCP transport: SSE on `localhost:45139` to reduce Qdrant lock contention.
+- Install flows write URL entries pointing at `/sse` for Claude, Cursor, and Codex.
+- `doctor` checks MCP process and port reachability.
+
+### Changed
+
+- Project install without a local `docs-kit.yaml` uses in-memory defaults (no user bootstrap in that path).
+
+### Fixed
+
+- Serve daemon test log path mock (`MagicMock` parent breaking `mkdir`).
+
+## [0.1.2] - 2026-03-27
+
+### Added
+
+- Bootstrap `~/.docs-kit/docs-kit.yaml` and default Qdrant path when running a global `install` with no project config.
+- `DocsKitConfig.from_yaml` loading from the user config after `./docs-kit.yaml`.
+
+### Changed
+
+- Documented pipx-first install, config precedence, and Python 3.11–3.13 cap; `requires-python` set to `<3.14` (onnxruntime wheels).
+
+## [0.1.1] - 2026-03-27
+
+### Added
+
+- Mintlify fetcher (`llms-full.txt`, `llms.txt`, sitemap fallback) and shared `llms_txt` helpers.
+- `docs-kit ingest --provider auto|gitbook|mintlify`.
+- Formatted CLI help and banner (`DocsKitGroup` / `DocsKitCommand`, examples in epilogs).
+
+### Changed
+
+- GitBook fetcher refactor; HTML stripped before chunking via `html_utils`.
+- `install` resolves absolute `docs-kit` command and config paths; warns if YAML is missing.
+
+### Chore
+
+- Ignore local `docs/` and add release helper script to `.gitignore`.
+
+## [0.1.0] - 2026-03-27
+
+### Added
+
+- `DocsKitAgent` API: `ingest()`, `query()`.
+- CLI: `docs-kit init`, `fetch`, `ingest`, `serve`, `install`, `query`, `inspect`, `doctor`.
+- GitBook fetch via `/llms-full.txt` / `/llms.txt` and linked pages.
+- Local embeddings with FastEmbed (dense + sparse/BM25).
+- Vector store: Qdrant (local path or remote URL).
+- Document parsers for `.txt` and `.md`.
+- `DocsKitConfig` with YAML and environment variable support.
+- MCP server tools: `search_docs`, `list_sources`, `get_collection_info`, `get_full_document`.
+- Annotated `docs-kit.yaml` example, npx wrapper, sample data, CI and publish workflows.

docs_kit-0.1.5/CLAUDE.md

@@ -0,0 +1,95 @@
+# docs-kit — Project Memory
+
+## Project Overview
+
+**docs-kit** is a distributable toolkit (PyPI **`docs-kit`**, optional **npm/npx** wrapper) that:
+
+1. **Pulls** documentation from public **GitBook** and **Mintlify** sites via AI-oriented endpoints (`/llms-full.txt` or `/llms.txt` and linked pages).
+2. **Stores** content locally — either as downloaded `.md` files (`docs-kit fetch`) or in a **local Qdrant** vector store after embedding (`docs-kit ingest`).
+3. **Ingests** with **local embeddings** (FastEmbed by default; no API keys required for embeddings).
+4. **Installs skill files** into AI agents (Claude Code, Cursor, Codex, OpenCode, Claude Desktop) that teach them to call `docs-kit` CLI commands directly — no background server required.
+
+**Pitch:** Point at any public docs, embed locally, let your coding agents query them directly via CLI skills.
+
+**Target:** Developers who want product/docs RAG in the agent loop without shipping docs to a remote embedding API.
+
+---
+
+## Distribution
+
+| Channel | What it is |
+|---------|------------|
+| **PyPI** | Canonical install: `pipx install docs-kit`. CLI entry: `docs-kit`. |
+| **npm/npx** | `npx-wrapper/` — thin Node shim that ensures Python 3.11+ and `pip install docs-kit`, then runs `python -m docs_kit …`. |
+
+---
+
+## Repo Structure
+
+| Path | Purpose |
+|------|---------|
+| `docs_kit/` | Python package: `DocsKitAgent`, GitBook/Mintlify fetchers, parsers, FastEmbed, Qdrant store, Click CLI |
+| `docs_kit/cli/` | CLI (`docs-kit init`, `fetch`, `ingest`, `install`, `query`, `inspect`, `list`, `remove`, `doctor`) |
+| `docs_kit/templates/` | Skill/instruction template files installed by `docs-kit install` |
+| `docs_kit/connectors/fetchers/gitbook.py` | GitBook `llms-full.txt` / `llms.txt` fetch |
+| `docs_kit/connectors/fetchers/mintlify.py` | Mintlify fetch with sitemap.xml fallback |
+| `npx-wrapper/` | npm package wrapping the Python CLI |
+| `tests/` | pytest suite |
+| `data/sample_docs/` | Sample markdown for local ingest tests |
+
+---
+
+## Tech Stack
+
+- **Python** ≥ 3.11, **Click**, **Pydantic** / **pydantic-settings**, **httpx**, **PyYAML**
+- **Embeddings:** FastEmbed (local)
+- **Vector store:** Qdrant (local embedded, path `~/.docs-kit/qdrant` for user config)
+- **Concurrency:** `filelock` for serializing concurrent embedded Qdrant access
+
+---
+
+## Security & Privacy
+
+- **NEVER** touch `.env`, `.env.local`, `.env.*`, or other secret/credentials files. Treat them as if they do not exist.
+- **NEVER** read, access, reference, or recommend reading environment or secret files.
+- **ALWAYS** work on `.env.example` when documenting or adding environment variables — use placeholder values only.
+- If config is needed, ask the user for non-sensitive details.
+
+---
+
+## Build & Verification
+
+From the project root (where `pyproject.toml` lives):
+
+```bash
+/usr/local/bin/python3.13 -m pytest tests/ -v
+```
+
+After substantive changes, run the full test suite before claiming completion.
+
+---
+
+## Skill templates (`docs_kit/templates/`)
+
+Installed agent skills are generated from these templates. They must stay aligned with the real CLI and install flow.
+
+- **MUST** open and review `docs_kit/templates/` after **major** changes to commands, flags, defaults, install targets, or agent integration (anything that changes what users or agents actually run).
+- **MUST** update the affected template files when those changes alter skill instructions; **need not** touch templates when the change is clearly unrelated (e.g. internal refactors with no CLI or install behavior change).
+- Stale templates mislead agents; treat template drift as a product bug on par with wrong CLI help text.
+
+---
+
+## Git Commits
+
+- **MUST** write descriptive commit messages using [Conventional Commits](https://www.conventionalcommits.org/): `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `perf`.
+- **SHOULD** keep subject line under 50 characters, imperative mood; use bullet points in body for context.
+
+---
+
+## Key Paths & Commands
+
+- **Config:** auto-created at `~/.docs-kit/docs-kit.yaml` on first use; or project-local `docs-kit.yaml` via `docs-kit init`
+- **Fetch only:** `docs-kit fetch <url> --output docs-kit-docs`
+- **Ingest URL or path:** `docs-kit ingest https://example.gitbook.io/docs` or `docs-kit ingest ./path/to/markdown`
+- **Agent setup:** `docs-kit install claude-code` (or `cursor`, `codex`, `opencode`, `claude-desktop`)
+- **No MCP server:** `serve` and `stop` commands do not exist; agents call CLI directly via installed skill files

docs_kit-0.1.5/PKG-INFO

@@ -0,0 +1,270 @@
+Metadata-Version: 2.3
+Name: docs-kit
+Version: 0.1.5
+Summary: Fetch docs, embed locally, expose to AI agents via skills.
+License: MIT License
+        
+        Copyright (c) 2026 Docs Kit Limited
+        
+        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.
+Requires-Python: <3.14,>=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: fastembed>=0.6.0
+Requires-Dist: filelock>=3.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic-settings>=2.2.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: qdrant-client>=1.10.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# docs-kit
+
+[![PyPI version](https://img.shields.io/pypi/v/docs-kit)](https://pypi.org/project/docs-kit/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/pypi/pyversions/docs-kit)](https://pypi.org/project/docs-kit/)
+[![CI](https://github.com/docs-kit/docs-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/docs-kit/docs-kit/actions/workflows/ci.yml)
+
+Fetch docs from GitBook, Mintlify, or local files, embed them locally, and teach AI agents to search them via installed **skills** (CLI commands). No API keys for the default embedding path. No background server or MCP.
+
+## What it does
+
+- Fetches public docs from **GitBook** and **Mintlify** sites via `/llms-full.txt` and `/llms.txt`, with a **sitemap.xml** fallback on Mintlify when those endpoints are missing
+- **`docs-kit ingest`:** `--provider auto` (default) uses a combined strategy (llms endpoints → sitemap). **`--provider gitbook`** uses the GitBook-only fetcher; **`--provider mintlify`** uses the same pipeline as `auto`
+- Ingests local `.md` and `.txt` files
+- Stores vectors in **embedded Qdrant** on disk — typically `~/.docs-kit/qdrant` when using the auto-created user config, or `.docs-kit/qdrant` (resolved relative to your `docs-kit.yaml`) for a project-local config from `docs-kit init`
+- **Hybrid retrieval** (dense embeddings + sparse / BM25-style vectors) for `docs-kit query` and agent-driven queries
+- Installs **skill files** into Claude Code, Cursor, Codex, OpenCode, and Claude Desktop so agents run `docs-kit` over the shell
+- Concurrent CLI runs coordinate with a **file lock** on the local Qdrant path
+
+## Install
+
+Recommended: **`pipx`** so `docs-kit` is on your PATH:
+
+```bash
+pipx install docs-kit
+```
+
+Install `pipx` if needed:
+
+```bash
+brew install pipx
+pipx ensurepath
+```
+
+Or **`pip`** inside a virtual environment:
+
+```bash
+pip install docs-kit
+```
+
+Optional: the repo includes an **`npx-wrapper/`** npm package that bootstraps Python and runs the same CLI (`npx docs-kit …` when published or linked locally).
+
+## Quickstart
+
+```bash
+# 1. Install (once)
+pipx install docs-kit
+
+# 2. Ingest docs
+docs-kit ingest https://docs.example.com
+
+# 3. Install skill into your agent
+docs-kit install claude-code   # or: cursor, codex, opencode, claude-desktop
+
+# 4. Use the agent — it can run docs-kit query / list / ingest when relevant
+```
+
+No server to start. On first use, config and the default vector store path are created under **`~/.docs-kit/`** unless you use a project-local `docs-kit.yaml`.
+
+## How it works
+
+docs-kit installs a **skill** (Markdown + YAML frontmatter) into each tool’s skills directory. The skill tells the agent when to use docs-kit and which commands to run (`query`, `list`, `ingest`, `remove`, `inspect`, `doctor`, …). Agents execute **`docs-kit`** via their normal terminal integration.
+
+For more architecture detail (config resolution, layout, security posture), see [docs/project-overview.md](docs/project-overview.md).
+
+## Install targets
+
+| Command | Where the skill lands |
+|---------|------------------------|
+| `docs-kit install claude-code` | `~/.claude/skills/docs-kit/SKILL.md` |
+| `docs-kit install codex` | `~/.codex/skills/docs-kit/SKILL.md` (also mirrors to `~/.agents/skills/docs-kit/SKILL.md` for compatibility) |
+| `docs-kit install cursor` | `~/.cursor/skills/docs-kit/SKILL.md` + marked block in `~/.cursor/AGENTS.md` when needed |
+| `docs-kit install opencode` | `~/.config/opencode/skills/docs-kit/SKILL.md` (and may mirror under `~/.agents/skills/` if absent) |
+| `docs-kit install claude-desktop` | `~/.docs-kit/exports/claude-desktop/docs-kit.zip` — upload via Claude Desktop **Customize → Skills** |
+
+`codex-app` and `codex-desktop` are accepted aliases for the Codex install path.
+
+Use **`--project`** with `claude-code` for `.claude/skills/docs-kit/SKILL.md` in the current repo.
+
+## Commands
+
+### `docs-kit install <agent>`
+
+Install the docs-kit skill into a supported agent.
+
+```bash
+docs-kit install claude-code
+docs-kit install cursor
+docs-kit install codex
+docs-kit install opencode
+docs-kit install claude-desktop
+docs-kit install claude-code --project
+docs-kit install cursor --config ./docs-kit.yaml
+```
+
+If no config is found, **`~/.docs-kit/docs-kit.yaml`** is created automatically (non-project installs).
+
+### `docs-kit ingest <path-or-url>`
+
+Ingest a local file, directory, or documentation URL.
+
+```bash
+docs-kit ingest ./docs
+docs-kit ingest https://docs.example.com
+docs-kit ingest https://docs.example.com --provider gitbook
+docs-kit ingest ./docs --recreate
+```
+
+`--provider`: `auto` (default), `gitbook`, or `mintlify`.
+
+### `docs-kit query <text>`
+
+Run hybrid retrieval from the CLI.
+
+```bash
+docs-kit query "How do I authenticate?"
+docs-kit query "getting started" --limit 3
+docs-kit query "season 5 end date" --full
+docs-kit query "..." --config ./docs-kit.yaml
+```
+
+Use `--full` when you want the entire chunk body instead of the default preview.
+
+### `docs-kit list`
+
+List ingested sources with ingestion timestamps.
+
+```bash
+docs-kit list
+docs-kit list --config ./docs-kit.yaml
+```
+
+### `docs-kit fetch <url>`
+
+Download **GitBook** docs as Markdown files only (does not embed). For Mintlify or mixed hosting, use **`docs-kit ingest`** or copy files locally first.
+
+```bash
+docs-kit fetch https://docs.example.com
+docs-kit fetch https://docs.example.com --output ./downloaded-docs
+```
+
+### `docs-kit remove <source>`
+
+Remove an ingested source by URL or file path.
+
+```bash
+docs-kit remove https://docs.example.com/page
+docs-kit remove ./docs/getting-started.md
+```
+
+### `docs-kit inspect`
+
+Show collection stats and embedding settings.
+
+```bash
+docs-kit inspect
+docs-kit inspect --config ./docs-kit.yaml
+```
+
+### `docs-kit doctor`
+
+Check `docs-kit` on PATH, effective config, Qdrant path / connectivity, and which skills are installed.
+
+For Codex installs, `doctor` reports both the native `~/.codex/skills/...` install and the shared compatibility mirror under `~/.agents/skills/...` when present.
+
+```bash
+docs-kit doctor
+docs-kit doctor --config ./docs-kit.yaml
+```
+
+### `docs-kit init`
+
+Create a project-local **`docs-kit.yaml`** (optional if you rely on `~/.docs-kit/docs-kit.yaml`).
+
+```bash
+docs-kit init
+docs-kit init --dir ./sandbox
+```
+
+## Configuration
+
+**Resolution order:** `--config` → `./docs-kit.yaml` in the current working directory → `~/.docs-kit/docs-kit.yaml` (created on first use when applicable).
+
+Example **project-local** `docs-kit.yaml` from `docs-kit init`:
+
+```yaml
+embedding:
+  provider: fastembed
+  model: BAAI/bge-small-en-v1.5
+
+vector_store:
+  provider: qdrant
+  local_path: .docs-kit/qdrant   # resolved relative to this file’s directory
+  collection_name: knowledge_base
+  retrieval_limit: 5
+  score_threshold: 0.35
+
+ingestion:
+  chunk_size: 800
+  chunk_overlap: 120
+  bm25_model: Qdrant/bm25
+```
+
+The auto-created **user** config under `~/.docs-kit/` sets `local_path` to an absolute directory under **`~/.docs-kit/qdrant`**. To use a **remote** Qdrant instance, set `vector_store.url` and leave local storage unused.
+
+## Supported sources
+
+| Source | Strategy |
+|--------|----------|
+| GitBook sites | `/llms-full.txt` → `/llms.txt` (GitBook fetcher); `auto` / `mintlify` use the broader pipeline below |
+| Mintlify & typical llms.txt sites | `/llms-full.txt` → `/llms.txt` → `/sitemap.xml` |
+| Local `.md` / `.txt` | Read from disk |
+
+## Requirements
+
+- **Python 3.11–3.13** (`requires-python` excludes 3.14+ while dependencies such as `onnxruntime` lack wheels)
+- Disk space for the embedding model (on the order of tens of MB for the default model)
+
+If your default `python` is 3.14:
+
+```bash
+pipx install docs-kit --python python3.13
+```
+
+## Migration from v0.1.x
+
+Older releases configured an **MCP server** in agent settings. That integration has been removed in favor of **skills + CLI**.
+
+1. Remove legacy **`mcpServers.docs-kit`** (or equivalent) from `~/.claude/settings.json`, Cursor MCP config, `~/.codex/config.toml`, etc.
+2. Run **`docs-kit install <agent>`** again to install skills.
+3. Existing **`~/.docs-kit/docs-kit.yaml`** and ingested data remain valid; any unused **`mcp:`** section in YAML can be deleted for clarity.