docs-kit 0.1.1__tar.gz → 0.1.2__tar.gz

{docs_kit-0.1.1 → docs_kit-0.1.2}/.gitignore

@@ -12,4 +12,5 @@ coverage/
 .docs-kit/
 downloaded-docs/
 /release-patch-pypi.sh
+/repush-release-tag.sh
 docs/

{docs_kit-0.1.1 → docs_kit-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: docs-kit
-Version: 0.1.1
+Version: 0.1.2
 Summary: Fetch docs, embed locally, expose via MCP for AI agents.
 License: MIT License
         
@@ -23,7 +23,7 @@ License: MIT License
         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.11
+Requires-Python: <3.14,>=3.11
 Requires-Dist: click>=8.0.0
 Requires-Dist: fastembed>=0.6.0
 Requires-Dist: httpx>=0.27.0
@@ -65,37 +65,54 @@ No API keys are required for the default local embedding path.
 
 ## Install
 
+The recommended install method is **`pipx`** — it puts `docs-kit` on your global PATH without touching your system Python or any project venv:
+
 ```bash
-pip install docs-kit
+pipx install docs-kit
 ```
 
-Or with `npx`:
+Install `pipx` first if you don't have it:
 
 ```bash
-npx docs-kit ingest https://docs.example.com
+brew install pipx
+pipx ensurepath   # adds ~/.local/bin to PATH
+```
+
+This matters for MCP installs. When `docs-kit` is on PATH, `docs-kit install claude-code` writes the absolute binary path into the agent config (e.g. `/Users/you/.local/pipx/venvs/docs-kit/bin/docs-kit`) so the MCP server works from any directory, not just your project folder.
+
+If you install globally with `pipx` and do not have a project yet, `docs-kit install <agent>` will bootstrap a user config at `~/.docs-kit/docs-kit.yaml` and point the MCP entry at it automatically.
+
+Or with plain `pip` (works, but binary won't be on global PATH unless you're in the right venv):
+
+```bash
+pip install docs-kit
 ```
 
 ## Quickstart
 
 ```bash
-# 1. Create a config file
-docs-kit init
+# 0. Install (once)
+pipx install docs-kit
+
+# 1. Install into your client
+docs-kit install codex
+docs-kit install claude-code
 
-# 2. Ingest docs (GitBook or Mintlify — auto-detected)
+# 2. Ingest docs (uses ~/.docs-kit/docs-kit.yaml if no local config exists)
 docs-kit ingest https://docs.elevenlabs.io
 
 # 3. Check the collection
 docs-kit inspect
 
-# 4. Install into your client
-docs-kit install claude-code
+# 4. Optional: create a project-local config instead
+docs-kit init
 ```
 
 ## Commands
 
 ### `docs-kit init`
 
-Create `docs-kit.yaml`.
+Create a project-local `docs-kit.yaml`.
 
 ```bash
 docs-kit init
@@ -135,6 +152,10 @@ docs-kit serve --transport sse --port 3001
 docs-kit serve --config ./docs-kit.yaml
 ```
 
+Without `--config`, `docs-kit` uses this precedence:
+1. `./docs-kit.yaml`
+2. `~/.docs-kit/docs-kit.yaml` (auto-created on first global use)
+
 ### `docs-kit install <agent>`
 
 Install docs-kit into a supported client config.
@@ -146,6 +167,8 @@ docs-kit install claude-code --project
 docs-kit install cursor --config ./docs-kit.yaml
 ```
 
+If you run `docs-kit install <agent>` outside a project and omit `--config`, docs-kit creates `~/.docs-kit/docs-kit.yaml` and installs the MCP server with an absolute `--config` pointing there.
+
 ### `docs-kit query <text>`
 
 Run retrieval directly from the CLI.
@@ -227,7 +250,7 @@ ChatGPT aliases are accepted for guidance only:
 
 ## Configuration
 
-`docs-kit.yaml` created by `docs-kit init`:
+Project-local `docs-kit.yaml` created by `docs-kit init`:
 
 ```yaml
 embedding:
@@ -250,6 +273,8 @@ mcp:
   port: 3001
 ```
 
+Global installs can also use a user config at `~/.docs-kit/docs-kit.yaml`, with data stored under `~/.docs-kit/qdrant`.
+
 ## Supported Sources
 
 | Source | Strategy |
@@ -263,6 +288,12 @@ Both GitBook and Mintlify support the [`llms.txt` standard](https://llmstxt.org)
 
 ## Requirements
 
-- Python 3.11+
+- Python 3.11–3.13 (3.14+ not yet supported — `onnxruntime` wheels are unavailable for 3.14)
 - Disk space for the local embedding model download
 - Local Qdrant storage under `.docs-kit/` by default
+
+If your system Python is 3.14, pass an explicit version to pipx:
+
+```bash
+pipx install docs-kit --python python3.13
+```

{docs_kit-0.1.1 → docs_kit-0.1.2}/README.md

@@ -20,37 +20,54 @@ No API keys are required for the default local embedding path.
 
 ## Install
 
+The recommended install method is **`pipx`** — it puts `docs-kit` on your global PATH without touching your system Python or any project venv:
+
 ```bash
-pip install docs-kit
+pipx install docs-kit
 ```
 
-Or with `npx`:
+Install `pipx` first if you don't have it:
 
 ```bash
-npx docs-kit ingest https://docs.example.com
+brew install pipx
+pipx ensurepath   # adds ~/.local/bin to PATH
+```
+
+This matters for MCP installs. When `docs-kit` is on PATH, `docs-kit install claude-code` writes the absolute binary path into the agent config (e.g. `/Users/you/.local/pipx/venvs/docs-kit/bin/docs-kit`) so the MCP server works from any directory, not just your project folder.
+
+If you install globally with `pipx` and do not have a project yet, `docs-kit install <agent>` will bootstrap a user config at `~/.docs-kit/docs-kit.yaml` and point the MCP entry at it automatically.
+
+Or with plain `pip` (works, but binary won't be on global PATH unless you're in the right venv):
+
+```bash
+pip install docs-kit
 ```
 
 ## Quickstart
 
 ```bash
-# 1. Create a config file
-docs-kit init
+# 0. Install (once)
+pipx install docs-kit
+
+# 1. Install into your client
+docs-kit install codex
+docs-kit install claude-code
 
-# 2. Ingest docs (GitBook or Mintlify — auto-detected)
+# 2. Ingest docs (uses ~/.docs-kit/docs-kit.yaml if no local config exists)
 docs-kit ingest https://docs.elevenlabs.io
 
 # 3. Check the collection
 docs-kit inspect
 
-# 4. Install into your client
-docs-kit install claude-code
+# 4. Optional: create a project-local config instead
+docs-kit init
 ```
 
 ## Commands
 
 ### `docs-kit init`
 
-Create `docs-kit.yaml`.
+Create a project-local `docs-kit.yaml`.
 
 ```bash
 docs-kit init
@@ -90,6 +107,10 @@ docs-kit serve --transport sse --port 3001
 docs-kit serve --config ./docs-kit.yaml
 ```
 
+Without `--config`, `docs-kit` uses this precedence:
+1. `./docs-kit.yaml`
+2. `~/.docs-kit/docs-kit.yaml` (auto-created on first global use)
+
 ### `docs-kit install <agent>`
 
 Install docs-kit into a supported client config.
@@ -101,6 +122,8 @@ docs-kit install claude-code --project
 docs-kit install cursor --config ./docs-kit.yaml
 ```
 
+If you run `docs-kit install <agent>` outside a project and omit `--config`, docs-kit creates `~/.docs-kit/docs-kit.yaml` and installs the MCP server with an absolute `--config` pointing there.
+
 ### `docs-kit query <text>`
 
 Run retrieval directly from the CLI.
@@ -182,7 +205,7 @@ ChatGPT aliases are accepted for guidance only:
 
 ## Configuration
 
-`docs-kit.yaml` created by `docs-kit init`:
+Project-local `docs-kit.yaml` created by `docs-kit init`:
 
 ```yaml
 embedding:
@@ -205,6 +228,8 @@ mcp:
   port: 3001
 ```
 
+Global installs can also use a user config at `~/.docs-kit/docs-kit.yaml`, with data stored under `~/.docs-kit/qdrant`.
+
 ## Supported Sources
 
 | Source | Strategy |
@@ -218,6 +243,12 @@ Both GitBook and Mintlify support the [`llms.txt` standard](https://llmstxt.org)
 
 ## Requirements
 
-- Python 3.11+
+- Python 3.11–3.13 (3.14+ not yet supported — `onnxruntime` wheels are unavailable for 3.14)
 - Disk space for the local embedding model download
 - Local Qdrant storage under `.docs-kit/` by default
+
+If your system Python is 3.14, pass an explicit version to pipx:
+
+```bash
+pipx install docs-kit --python python3.13
+```

docs_kit-0.1.2/docs_kit/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.2"

{docs_kit-0.1.1 → docs_kit-0.1.2}/docs_kit/cli/commands.py

@@ -21,6 +21,8 @@ INSTALL_TARGETS = [
     "chatgpt",
     "chatgpt-desktop",
 ]
+
+
 def _get_agent_class():
     from docs_kit.agent import DocsKitAgent
 
@@ -51,6 +53,35 @@ def _get_qdrant_client_class():
     return QdrantClient
 
 
+def _get_user_config_dir() -> Path:
+    return Path.home() / ".docs-kit"
+
+
+def _get_user_config_path() -> Path:
+    return _get_user_config_dir() / "docs-kit.yaml"
+
+
+def _build_user_bootstrap_config():
+    DocsKitConfig = _get_config_class()
+    config = DocsKitConfig()
+    config.vector_store.local_path = str((_get_user_config_dir() / "qdrant").resolve())
+    return config
+
+
+def _ensure_user_config() -> Path:
+    import yaml as _yaml
+
+    config_path = _get_user_config_path()
+    if config_path.exists():
+        return config_path
+
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    config = _build_user_bootstrap_config()
+    with open(config_path, "w") as f:
+        _yaml.dump(config.model_dump(), f, default_flow_style=False, sort_keys=False)
+    return config_path
+
+
 def _load_config(config_path: str | None):
     DocsKitConfig = _get_config_class()
     if config_path:
@@ -58,7 +89,7 @@ def _load_config(config_path: str | None):
     default_yaml = Path("docs-kit.yaml")
     if default_yaml.exists():
         return DocsKitConfig.from_yaml(default_yaml)
-    return DocsKitConfig()
+    return DocsKitConfig.from_yaml(_ensure_user_config())
 
 
 def _describe_vector_store(config) -> str:
@@ -509,10 +540,11 @@ def install_cmd(agent: str, project: bool, config_path: str | None):
     # Resolve the binary to an absolute path so the entry works from any CWD.
     command, prefix_args = _resolve_command()
 
+    created_user_config = False
+
     # Resolve --config to an absolute path. If not passed, auto-discover
-    # docs-kit.yaml in the current directory. Warn if neither is found on a
-    # global install, because the server will fall back to default config and
-    # may not find the user's ingested data.
+    # docs-kit.yaml in the current directory. For global installs with no
+    # project config, bootstrap a stable user-level config automatically.
     if config_path:
         config_path = str(Path(config_path).resolve())
     else:
@@ -520,12 +552,10 @@ def install_cmd(agent: str, project: bool, config_path: str | None):
         if default_yaml.exists():
             config_path = str(default_yaml.resolve())
         elif not project:
-            click.echo(
-                "Warning: No docs-kit.yaml found in current directory and --config not set.\n"
-                "The MCP server will use default config and may not find your ingested data.\n"
-                "Run from your project directory or pass --config /absolute/path/to/docs-kit.yaml",
-                err=True,
-            )
+            user_config_already_exists = _get_user_config_path().exists()
+            user_config_path = _ensure_user_config()
+            config_path = str(user_config_path.resolve())
+            created_user_config = not user_config_already_exists
 
     args = prefix_args + ["serve"]
     if config_path:
@@ -535,8 +565,14 @@ def install_cmd(agent: str, project: bool, config_path: str | None):
         _install_codex_mcp_server(settings_path, "docs-kit", command, args)
         click.echo(f"✓ Installed docs-kit MCP server into {settings_path}")
         click.echo("  Codex CLI and the Codex IDE extension share this config.")
+        if created_user_config:
+            click.echo(f"  Created user config at {config_path}")
+            click.echo(f"  Local data will be stored under {_get_user_config_dir() / 'qdrant'}")
         return
 
     _install_json_mcp_server(settings_path, "docs-kit", command, args)
     click.echo(f"✓ Installed docs-kit MCP server into {settings_path}")
+    if created_user_config:
+        click.echo(f"  Created user config at {config_path}")
+        click.echo(f"  Local data will be stored under {_get_user_config_dir() / 'qdrant'}")
     _print_restart_instructions(normalized_agent)

{docs_kit-0.1.1 → docs_kit-0.1.2}/pyproject.toml

@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Fetch docs, embed locally, expose via MCP for AI agents."
 readme = "README.md"
 license = { file = "LICENSE" }
-requires-python = ">=3.11"
+requires-python = ">=3.11,<3.14"
 dependencies = [
     "pydantic>=2.0.0",
     "pydantic-settings>=2.2.1",

{docs_kit-0.1.1 → docs_kit-0.1.2}/tests/test_cli.py

@@ -1,9 +1,44 @@
+import os
+from pathlib import Path
+
+import yaml
 from click.testing import CliRunner
 from unittest.mock import MagicMock, patch
 
 from docs_kit.cli.__main__ import cli
 
 
+class FakeDocsKitConfig:
+    def __init__(self, data=None):
+        self._data = data or {
+            "embedding": {"provider": "fastembed", "model": "BAAI/bge-small-en-v1.5"},
+            "vector_store": {
+                "provider": "qdrant",
+                "url": "",
+                "collection_name": "knowledge_base",
+                "local_path": ".docs-kit/qdrant",
+            },
+            "ingestion": {"chunk_size": 800, "chunk_overlap": 120, "bm25_model": "Qdrant/bm25"},
+            "mcp": {"transport": "stdio", "host": "localhost", "port": 3001},
+        }
+        vector_store = type("VectorStore", (), {})()
+        vector_store.local_path = self._data["vector_store"]["local_path"]
+        self.vector_store = vector_store
+
+    def model_dump(self):
+        self._data["vector_store"]["local_path"] = self.vector_store.local_path
+        return self._data
+
+    @classmethod
+    def from_yaml(cls, path):
+        with open(path) as f:
+            data = yaml.safe_load(f) or {}
+        local_path = data["vector_store"]["local_path"]
+        if not Path(local_path).is_absolute():
+            data["vector_store"]["local_path"] = str((Path(path).parent / local_path).resolve())
+        return cls(data)
+
+
 PUBLIC_COMMAND_HELP_CASES = [
     ("init", ["docs-kit init --dir ./sandbox"]),
     ("ingest", ["docs-kit ingest https://docs.example.com"]),
@@ -68,6 +103,50 @@ def test_cli_init_creates_config(tmp_path):
     assert "local_path" in config_file.read_text()
 
 
+def test_load_config_bootstraps_user_config_when_no_local_config(tmp_path):
+    fake_home = tmp_path / "home"
+    fake_home.mkdir()
+
+    with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
+         patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
+        from docs_kit.cli.commands import _load_config
+
+        cwd = Path.cwd()
+        try:
+            os.chdir(tmp_path)
+            config = _load_config(None)
+        finally:
+            os.chdir(cwd)
+
+    user_config = fake_home / ".docs-kit" / "docs-kit.yaml"
+    assert user_config.exists()
+    assert config.vector_store.local_path == str((fake_home / ".docs-kit" / "qdrant").resolve())
+
+    data = yaml.safe_load(user_config.read_text())
+    assert data["vector_store"]["local_path"] == str((fake_home / ".docs-kit" / "qdrant").resolve())
+
+
+def test_load_config_prefers_local_docs_kit_yaml(tmp_path):
+    fake_home = tmp_path / "home"
+    fake_home.mkdir()
+    local_config = tmp_path / "docs-kit.yaml"
+    local_config.write_text("vector_store:\n  local_path: .docs-kit/qdrant\n")
+
+    with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
+         patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
+        from docs_kit.cli.commands import _load_config
+
+        cwd = Path.cwd()
+        try:
+            os.chdir(tmp_path)
+            config = _load_config(None)
+        finally:
+            os.chdir(cwd)
+
+    assert config.vector_store.local_path == str((tmp_path / ".docs-kit" / "qdrant").resolve())
+    assert not (fake_home / ".docs-kit" / "docs-kit.yaml").exists()
+
+
 def test_ingest_shows_total_and_calls_agent(tmp_path):
     """ingest_cmd should call agent.ingest() and print total chunk count."""
     runner = CliRunner()

{docs_kit-0.1.1 → docs_kit-0.1.2}/tests/test_install_cmd.py

@@ -10,6 +10,36 @@ from docs_kit.cli.__main__ import cli
 FAKE_DOCS_KIT_BIN = "/usr/local/bin/docs-kit"
 
 
+class FakeDocsKitConfig:
+    def __init__(self, data=None):
+        self._data = data or {
+            "embedding": {"provider": "fastembed", "model": "BAAI/bge-small-en-v1.5"},
+            "vector_store": {
+                "provider": "qdrant",
+                "url": "",
+                "collection_name": "knowledge_base",
+                "local_path": ".docs-kit/qdrant",
+            },
+            "ingestion": {"chunk_size": 800, "chunk_overlap": 120, "bm25_model": "Qdrant/bm25"},
+            "mcp": {"transport": "stdio", "host": "localhost", "port": 3001},
+        }
+        vector_store = type("VectorStore", (), {})()
+        vector_store.local_path = self._data["vector_store"]["local_path"]
+        self.vector_store = vector_store
+
+    def model_dump(self):
+        self._data["vector_store"]["local_path"] = self.vector_store.local_path
+        return self._data
+
+    @classmethod
+    def from_yaml(cls, path):
+        import yaml
+
+        with open(path) as f:
+            data = yaml.safe_load(f) or {}
+        return cls(data)
+
+
 class TestInstallCmd(unittest.TestCase):
 
     def test_install_claude_code_creates_settings(self):
@@ -18,7 +48,8 @@ class TestInstallCmd(unittest.TestCase):
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 self.assertIn("Installed docs-kit MCP server", result.output)
@@ -30,7 +61,8 @@ class TestInstallCmd(unittest.TestCase):
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".claude" / "settings.json"
@@ -41,7 +73,10 @@ class TestInstallCmd(unittest.TestCase):
                 self.assertIn("docs-kit", data["mcpServers"])
                 entry = data["mcpServers"]["docs-kit"]
                 self.assertEqual(entry["command"], str(Path(FAKE_DOCS_KIT_BIN).resolve()))
-                self.assertEqual(entry["args"], ["serve"])
+                self.assertEqual(
+                    entry["args"],
+                    ["serve", "--config", str((fake_home / ".docs-kit" / "docs-kit.yaml").resolve())],
+                )
 
     def test_install_python_module_fallback_when_no_binary(self):
         """Falls back to sys.executable -m docs_kit when docs-kit is not on PATH."""
@@ -50,7 +85,8 @@ class TestInstallCmd(unittest.TestCase):
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=None):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=None), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".claude" / "settings.json"
@@ -58,7 +94,10 @@ class TestInstallCmd(unittest.TestCase):
                     data = json.load(f)
                 entry = data["mcpServers"]["docs-kit"]
                 self.assertEqual(entry["command"], sys.executable)
-                self.assertEqual(entry["args"], ["-m", "docs_kit", "serve"])
+                self.assertEqual(
+                    entry["args"],
+                    ["-m", "docs_kit", "serve", "--config", str((fake_home / ".docs-kit" / "docs-kit.yaml").resolve())],
+                )
 
     def test_install_with_config_writes_absolute_config_path(self):
         """--config is resolved to an absolute path in the written settings."""
@@ -70,7 +109,8 @@ class TestInstallCmd(unittest.TestCase):
             config_file = Path(tmp_dir) / "custom.yaml"
             config_file.write_text("vector_store:\n  local_path: .docs-kit/qdrant\n")
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code", "--config", str(config_file)])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".claude" / "settings.json"
@@ -93,7 +133,8 @@ class TestInstallCmd(unittest.TestCase):
             config_file = Path(tmp_dir) / "docs-kit.yaml"
             config_file.write_text("vector_store:\n  local_path: .docs-kit/qdrant\n")
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"], catch_exceptions=False)
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".claude" / "settings.json"
@@ -105,24 +146,33 @@ class TestInstallCmd(unittest.TestCase):
                 self.assertTrue(Path(config_arg).is_absolute())
 
     def test_install_warns_when_no_config_on_global_install(self):
-        """Prints a warning when no config found on a global install."""
+        """Global install bootstraps a user config when no config is present."""
         runner = CliRunner()
         with runner.isolated_filesystem() as tmp_dir:
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
-            # No docs-kit.yaml in CWD
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"])
                 self.assertEqual(result.exit_code, 0, result.output)
-                self.assertIn("Warning", result.output)
-                self.assertIn("docs-kit.yaml", result.output)
+                self.assertNotIn("Warning", result.output)
+                self.assertIn("Created user config", result.output)
+                settings_file = fake_home / ".claude" / "settings.json"
+                user_config = fake_home / ".docs-kit" / "docs-kit.yaml"
+                self.assertTrue(user_config.exists())
+                with open(settings_file) as f:
+                    data = json.load(f)
+                args = data["mcpServers"]["docs-kit"]["args"]
+                self.assertIn("--config", args)
+                self.assertEqual(args[args.index("--config") + 1], str(user_config.resolve()))
 
     def test_install_no_warning_on_project_install_without_config(self):
         """--project install does not warn about missing config (project-local is expected)."""
         runner = CliRunner()
         with runner.isolated_filesystem() as tmp_dir:
-            with patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+            with patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code", "--project"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 self.assertNotIn("Warning", result.output)
@@ -140,7 +190,8 @@ class TestInstallCmd(unittest.TestCase):
                 "mcpServers": {"other-tool": {"command": "other", "args": []}}
             }))
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 with open(settings_file) as f:
@@ -152,7 +203,8 @@ class TestInstallCmd(unittest.TestCase):
         """--project flag writes to .claude/settings.json in current dir."""
         runner = CliRunner()
         with runner.isolated_filesystem() as tmp_dir:
-            with patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+            with patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "claude-code", "--project"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = Path(tmp_dir) / ".claude" / "settings.json"
@@ -164,13 +216,14 @@ class TestInstallCmd(unittest.TestCase):
         self.assertNotEqual(result.exit_code, 0)
 
     def test_install_codex_writes_toml_config(self):
-        """Codex install writes absolute command path and serve args to TOML."""
+        """Codex install writes bootstrap config path when no local config exists."""
         runner = CliRunner()
         with runner.isolated_filesystem() as tmp_dir:
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "codex"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".codex" / "config.toml"
@@ -181,7 +234,10 @@ class TestInstallCmd(unittest.TestCase):
                 self.assertIn("docs-kit", data["mcp_servers"])
                 entry = data["mcp_servers"]["docs-kit"]
                 self.assertEqual(entry["command"], str(Path(FAKE_DOCS_KIT_BIN).resolve()))
-                self.assertEqual(entry["args"], ["serve"])
+                self.assertEqual(
+                    entry["args"],
+                    ["serve", "--config", str((fake_home / ".docs-kit" / "docs-kit.yaml").resolve())],
+                )
 
     def test_install_codex_with_config_uses_absolute_path(self):
         """Codex install resolves --config to an absolute path."""
@@ -192,7 +248,8 @@ class TestInstallCmd(unittest.TestCase):
             config_file = Path(tmp_dir) / "custom.yaml"
             config_file.write_text("vector_store:\n  local_path: .docs-kit/qdrant\n")
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "codex", "--config", str(config_file)])
                 self.assertEqual(result.exit_code, 0, result.output)
                 settings_file = fake_home / ".codex" / "config.toml"
@@ -209,11 +266,24 @@ class TestInstallCmd(unittest.TestCase):
             fake_home = Path(tmp_dir) / "home"
             fake_home.mkdir()
             with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
-                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN):
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
                 result = runner.invoke(cli, ["install", "codex-desktop"])
                 self.assertEqual(result.exit_code, 0, result.output)
                 self.assertIn(".codex/config.toml", result.output)
 
+    def test_install_project_does_not_bootstrap_user_config(self):
+        runner = CliRunner()
+        with runner.isolated_filesystem() as tmp_dir:
+            fake_home = Path(tmp_dir) / "home"
+            fake_home.mkdir()
+            with patch("docs_kit.cli.commands.Path.home", return_value=fake_home), \
+                 patch("docs_kit.cli.commands.shutil.which", return_value=FAKE_DOCS_KIT_BIN), \
+                 patch("docs_kit.cli.commands._get_config_class", return_value=FakeDocsKitConfig):
+                result = runner.invoke(cli, ["install", "claude-code", "--project"])
+                self.assertEqual(result.exit_code, 0, result.output)
+                self.assertFalse((fake_home / ".docs-kit" / "docs-kit.yaml").exists())
+
     def test_install_chatgpt_shows_remote_mcp_guidance(self):
         runner = CliRunner()
         result = runner.invoke(cli, ["install", "chatgpt"])

docs_kit-0.1.1/docs_kit/_version.py

@@ -1 +0,0 @@
-__version__ = "0.1.1"