footprinter-cli 1.0.0rc3__tar.gz → 1.0.1__tar.gz

{footprinter_cli-1.0.0rc3 → footprinter_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: footprinter-cli
-Version: 1.0.0rc3
+Version: 1.0.1
 Summary: A local context layer for your files, browser history, chats, and email — searchable, user-owned, MCP-served.
 Author: SwellCity Group
 License: MIT
@@ -8,9 +8,8 @@ Project-URL: Homepage, https://github.com/swellcitygroup/footprinter
 Project-URL: Repository, https://github.com/swellcitygroup/footprinter
 Project-URL: Issues, https://github.com/swellcitygroup/footprinter/issues
 Project-URL: Documentation, https://github.com/swellcitygroup/footprinter/blob/main/README.md
-Project-URL: Changelog, https://github.com/swellcitygroup/footprinter/blob/main/CHANGELOG.md
 Keywords: indexer,mcp,metadata,model-context-protocol,file-indexing,sqlite,context-engineering,personal-information-management
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
@@ -58,18 +57,62 @@ Requires-Dist: httpx<1.0,>=0.27.0; extra == "dev"
 
 Your work lives across a filesystem, a browser, an inbox, a chat history, and whatever other tools you reach for. Footprinter indexes those sources into a single local store, organizes them into the projects and groupings *you* define, and serves the result to AI agents through a governed access layer. You control what the agent can see. Everything stays on your machine.
 
+## Prerequisites
+
+- **Python 3.11 or newer.** Stock macOS ships with Python 3.9, which won't work — install a newer Python from [python.org](https://www.python.org/downloads/) (recommended) or via `brew install python@3.11`.
+- **macOS 13+** or **Linux**.
+- **Full Disk Access on macOS** for browser history indexing. Grant it to your terminal app under *System Settings → Privacy & Security → Full Disk Access*. `fp setup` will guide you through this when needed.
+
 ## Install
 
+The fastest path on a clean machine is the install script — it ensures Python 3.11+ is present and installs `footprinter-cli`:
+
+```bash
+# Base install (CLI + MCP + HTTP API)
+curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install.sh | bash
+
+# Full install (adds semantic search + document parsing)
+curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install-full.sh | bash
+```
+
+If you prefer to manage the install yourself, use **pipx** (recommended) — modern macOS Python ships PEP 668 enabled, which blocks bare `pip install`:
+
 ```bash
-pip install footprinter-cli
+brew install pipx
+pipx ensurepath           # then restart your terminal
+pipx install footprinter-cli
+pipx install 'footprinter-cli[full]'   # with semantic + parse
 ```
 
-The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more capabilities:
+Inside an existing venv, `pip` works as expected:
+
+```bash
+./venv/bin/pip install footprinter-cli
+./venv/bin/pip install 'footprinter-cli[full]'
+```
+
+The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more:
+
+| Extra | What it adds |
+|-------|-------------|
+| `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
+| `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
+| `[full]` | All optional extras (semantic + parse) |
+
+> **Privacy note:** The `[semantic]` extra installs ChromaDB. Footprinter initializes
+> the ChromaDB client with `anonymized_telemetry=False`, so no telemetry is sent
+> regardless of which version pip resolves. ChromaDB also removed product telemetry
+> entirely in version 1.5.4. See
+> [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss) for details.
+
+### Uninstall
+
+`fp uninstall` cleans up the MCP entry and user data first, then run the appropriate package uninstall:
 
 ```bash
-pip install footprinter-cli[full]       # All optional extras (semantic + parse)
-pip install footprinter-cli[semantic]   # Semantic search (ChromaDB + ONNX embeddings)
-pip install footprinter-cli[parse]      # PDF, Word, Excel, PowerPoint content extraction
+fp uninstall                                    # remove MCP entry + user data
+pipx uninstall footprinter-cli                  # if you installed via pipx
+./venv/bin/pip uninstall footprinter-cli        # if you installed inside a venv
 ```
 
 ## Quick Start
@@ -81,16 +124,22 @@ fp status    # See what's indexed
 fp search "meeting notes"   # Find things
 ```
 
-**macOS note:** Browser history indexing requires Full Disk Access for your terminal app (System Settings > Privacy & Security > Full Disk Access).
+A few first-run notes:
+
+- The first ingest is implicitly full; subsequent runs are incremental. If you change exclusions or add directories after the first run, re-run with `fp ingest --full` so previously skipped files get picked up.
+- With `[semantic]` or `[full]`, the **first ingest downloads ~80MB** of ONNX embedding model weights. It's a one-time cost — subsequent ingests are fast.
+- Keep the directories you want indexed **outside `~/Downloads`** — the default exclusion list skips it.
 
 ## Connect to Claude Desktop
 
 Footprinter includes an MCP server that gives Claude Desktop (or any MCP client) structured access to your indexed data:
 
 ```bash
-fp setup mcp    # Configure MCP for Claude Desktop
+fp setup mcp --claude    # Configure MCP for Claude Desktop
 ```
 
+After running this, **fully quit Claude Desktop (Cmd+Q) and relaunch** before the Footprinter tools appear in the conversation tools list. A simple window close isn't enough — the app keeps running in the menu bar.
+
 Once configured, Claude can search your files, browse projects, and find related conversations — through natural language.
 
 ## What It Indexes
@@ -104,6 +153,8 @@ Once configured, Claude can search your files, browse projects, and find related
 | **Documents** | PDF, Word, Excel, PowerPoint content (with `[parse]` extra) |
 | **Semantic embeddings** | Conceptual similarity across all sources (with `[semantic]` extra) |
 
+What lands in the database — and when — is controlled by the **content storage tier** you opt into. By default, Footprinter only indexes metadata; it does not read your file content until you explicitly enable it. See [Content Storage](https://github.com/swellcitygroup/footprinter/blob/main/reference/content-storage.md) for the full breakdown.
+
 Additional sources are available through [connector plugins](#connectors).
 
 ## CLI Commands
@@ -124,6 +175,8 @@ All commands use the `fp` entry point.
 | `fp data` | Export data, generate templates, or import metadata corrections |
 | `fp delete` | Soft-delete a record |
 | `fp vectorize` | Manage per-record vectorization control |
+| `fp doctor` | Post-install health check (Python version, install location, FDA, MCP wiring) |
+| `fp uninstall` | Remove Footprinter — MCP entry, user data, package |
 
 Run `fp <command> --help` for full usage.
 
@@ -145,23 +198,10 @@ Single-process CLI with optional MCP server. SQLite database. No containers, no
 
 Sources are scanned into SQLite with bidirectional links connecting local files to remote backups via content hash matching. Embeddings are generated at ingest time for semantic search. The MCP server exposes indexed data with two-layer access control (visibility + permissions) — you decide what agents can see.
 
-## Optional Extras
-
-| Extra | What it adds |
-|-------|-------------|
-| `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
-| `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
-| `[full]` | All optional extras (semantic + parse) |
-
-> **Privacy note:** The `[semantic]` extra installs ChromaDB, which bundles PostHog analytics.
-> ChromaDB collects anonymous usage telemetry by default. Set `ANONYMIZED_TELEMETRY=False`
-> in your environment to disable it. See
-> [ChromaDB telemetry docs](https://docs.trychroma.com/docs/overview/telemetry) for details.
-
 ## Requirements
 
 - Python 3.11+
-- macOS or Linux
+- macOS 13+ or Linux
 - Full Disk Access on macOS (for browser history)
 
 ## Documentation
@@ -169,6 +209,7 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 - [Interfaces](https://github.com/swellcitygroup/footprinter/blob/main/reference/interfaces.md) — CLI commands, MCP tools, Python API
 - [Data Model](https://github.com/swellcitygroup/footprinter/blob/main/reference/data-model.md) — database schema
 - [Pipeline](https://github.com/swellcitygroup/footprinter/blob/main/reference/pipeline.md) — indexing stages and configuration
+- [Content Storage](https://github.com/swellcitygroup/footprinter/blob/main/reference/content-storage.md) — metadata vs. snippet vs. full-content tiers
 - [Access Control](https://github.com/swellcitygroup/footprinter/blob/main/reference/mcp-access-control.md) — MCP security model
 
 ## Contributing
@@ -189,7 +230,7 @@ python3 -m venv venv
 ### Running tests
 
 ```bash
-pytest tests/ -v --tb=short
+./venv/bin/pytest tests/ -v --tb=short
 ```
 
 ### Code style

{footprinter_cli-1.0.0rc3 → footprinter_cli-1.0.1}/README.md

@@ -6,18 +6,62 @@
 
 Your work lives across a filesystem, a browser, an inbox, a chat history, and whatever other tools you reach for. Footprinter indexes those sources into a single local store, organizes them into the projects and groupings *you* define, and serves the result to AI agents through a governed access layer. You control what the agent can see. Everything stays on your machine.
 
+## Prerequisites
+
+- **Python 3.11 or newer.** Stock macOS ships with Python 3.9, which won't work — install a newer Python from [python.org](https://www.python.org/downloads/) (recommended) or via `brew install python@3.11`.
+- **macOS 13+** or **Linux**.
+- **Full Disk Access on macOS** for browser history indexing. Grant it to your terminal app under *System Settings → Privacy & Security → Full Disk Access*. `fp setup` will guide you through this when needed.
+
 ## Install
 
+The fastest path on a clean machine is the install script — it ensures Python 3.11+ is present and installs `footprinter-cli`:
+
+```bash
+# Base install (CLI + MCP + HTTP API)
+curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install.sh | bash
+
+# Full install (adds semantic search + document parsing)
+curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install-full.sh | bash
+```
+
+If you prefer to manage the install yourself, use **pipx** (recommended) — modern macOS Python ships PEP 668 enabled, which blocks bare `pip install`:
+
 ```bash
-pip install footprinter-cli
+brew install pipx
+pipx ensurepath           # then restart your terminal
+pipx install footprinter-cli
+pipx install 'footprinter-cli[full]'   # with semantic + parse
 ```
 
-The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more capabilities:
+Inside an existing venv, `pip` works as expected:
+
+```bash
+./venv/bin/pip install footprinter-cli
+./venv/bin/pip install 'footprinter-cli[full]'
+```
+
+The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more:
+
+| Extra | What it adds |
+|-------|-------------|
+| `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
+| `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
+| `[full]` | All optional extras (semantic + parse) |
+
+> **Privacy note:** The `[semantic]` extra installs ChromaDB. Footprinter initializes
+> the ChromaDB client with `anonymized_telemetry=False`, so no telemetry is sent
+> regardless of which version pip resolves. ChromaDB also removed product telemetry
+> entirely in version 1.5.4. See
+> [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss) for details.
+
+### Uninstall
+
+`fp uninstall` cleans up the MCP entry and user data first, then run the appropriate package uninstall:
 
 ```bash
-pip install footprinter-cli[full]       # All optional extras (semantic + parse)
-pip install footprinter-cli[semantic]   # Semantic search (ChromaDB + ONNX embeddings)
-pip install footprinter-cli[parse]      # PDF, Word, Excel, PowerPoint content extraction
+fp uninstall                                    # remove MCP entry + user data
+pipx uninstall footprinter-cli                  # if you installed via pipx
+./venv/bin/pip uninstall footprinter-cli        # if you installed inside a venv
 ```
 
 ## Quick Start
@@ -29,16 +73,22 @@ fp status    # See what's indexed
 fp search "meeting notes"   # Find things
 ```
 
-**macOS note:** Browser history indexing requires Full Disk Access for your terminal app (System Settings > Privacy & Security > Full Disk Access).
+A few first-run notes:
+
+- The first ingest is implicitly full; subsequent runs are incremental. If you change exclusions or add directories after the first run, re-run with `fp ingest --full` so previously skipped files get picked up.
+- With `[semantic]` or `[full]`, the **first ingest downloads ~80MB** of ONNX embedding model weights. It's a one-time cost — subsequent ingests are fast.
+- Keep the directories you want indexed **outside `~/Downloads`** — the default exclusion list skips it.
 
 ## Connect to Claude Desktop
 
 Footprinter includes an MCP server that gives Claude Desktop (or any MCP client) structured access to your indexed data:
 
 ```bash
-fp setup mcp    # Configure MCP for Claude Desktop
+fp setup mcp --claude    # Configure MCP for Claude Desktop
 ```
 
+After running this, **fully quit Claude Desktop (Cmd+Q) and relaunch** before the Footprinter tools appear in the conversation tools list. A simple window close isn't enough — the app keeps running in the menu bar.
+
 Once configured, Claude can search your files, browse projects, and find related conversations — through natural language.
 
 ## What It Indexes
@@ -52,6 +102,8 @@ Once configured, Claude can search your files, browse projects, and find related
 | **Documents** | PDF, Word, Excel, PowerPoint content (with `[parse]` extra) |
 | **Semantic embeddings** | Conceptual similarity across all sources (with `[semantic]` extra) |
 
+What lands in the database — and when — is controlled by the **content storage tier** you opt into. By default, Footprinter only indexes metadata; it does not read your file content until you explicitly enable it. See [Content Storage](https://github.com/swellcitygroup/footprinter/blob/main/reference/content-storage.md) for the full breakdown.
+
 Additional sources are available through [connector plugins](#connectors).
 
 ## CLI Commands
@@ -72,6 +124,8 @@ All commands use the `fp` entry point.
 | `fp data` | Export data, generate templates, or import metadata corrections |
 | `fp delete` | Soft-delete a record |
 | `fp vectorize` | Manage per-record vectorization control |
+| `fp doctor` | Post-install health check (Python version, install location, FDA, MCP wiring) |
+| `fp uninstall` | Remove Footprinter — MCP entry, user data, package |
 
 Run `fp <command> --help` for full usage.
 
@@ -93,23 +147,10 @@ Single-process CLI with optional MCP server. SQLite database. No containers, no
 
 Sources are scanned into SQLite with bidirectional links connecting local files to remote backups via content hash matching. Embeddings are generated at ingest time for semantic search. The MCP server exposes indexed data with two-layer access control (visibility + permissions) — you decide what agents can see.
 
-## Optional Extras
-
-| Extra | What it adds |
-|-------|-------------|
-| `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
-| `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
-| `[full]` | All optional extras (semantic + parse) |
-
-> **Privacy note:** The `[semantic]` extra installs ChromaDB, which bundles PostHog analytics.
-> ChromaDB collects anonymous usage telemetry by default. Set `ANONYMIZED_TELEMETRY=False`
-> in your environment to disable it. See
-> [ChromaDB telemetry docs](https://docs.trychroma.com/docs/overview/telemetry) for details.
-
 ## Requirements
 
 - Python 3.11+
-- macOS or Linux
+- macOS 13+ or Linux
 - Full Disk Access on macOS (for browser history)
 
 ## Documentation
@@ -117,6 +158,7 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 - [Interfaces](https://github.com/swellcitygroup/footprinter/blob/main/reference/interfaces.md) — CLI commands, MCP tools, Python API
 - [Data Model](https://github.com/swellcitygroup/footprinter/blob/main/reference/data-model.md) — database schema
 - [Pipeline](https://github.com/swellcitygroup/footprinter/blob/main/reference/pipeline.md) — indexing stages and configuration
+- [Content Storage](https://github.com/swellcitygroup/footprinter/blob/main/reference/content-storage.md) — metadata vs. snippet vs. full-content tiers
 - [Access Control](https://github.com/swellcitygroup/footprinter/blob/main/reference/mcp-access-control.md) — MCP security model
 
 ## Contributing
@@ -137,7 +179,7 @@ python3 -m venv venv
 ### Running tests
 
 ```bash
-pytest tests/ -v --tb=short
+./venv/bin/pytest tests/ -v --tb=short
 ```
 
 ### Code style

{footprinter_cli-1.0.0rc3 → footprinter_cli-1.0.1}/footprinter/cli/__init__.py

@@ -63,6 +63,12 @@ def main(argv=None) -> None:
             "  fp api                     Start the HTTP API server\n"
             "  fp mcp check ~/Work/file   Check access resolution for a path\n"
             "\n"
+            "diagnostics:\n"
+            "  fp doctor                  Check installation health\n"
+            "\n"
+            "cleanup:\n"
+            "  fp uninstall               Remove Footprinter (MCP entry, data, package)\n"
+            "\n"
             "tip: use 'fp <command> --help' for details on any command."
         ),
         formatter_class=FORMATTER,
@@ -80,11 +86,13 @@ def main(argv=None) -> None:
         connect,
         data,
         delete,
+        doctor,
         ingest,
         mcp_cmd,
         search_cmd,
         setup,
         status_cmd,
+        uninstall,
         upsert,
         vectorize_cmd,
         view,
@@ -103,6 +111,8 @@ def main(argv=None) -> None:
         data,
         delete,
         vectorize_cmd,
+        uninstall,
+        doctor,
     ]:
         mod.register(subparsers)
 

footprinter_cli-1.0.1/footprinter/cli/doctor.py

@@ -0,0 +1,247 @@
+"""fp doctor — post-install health check command.
+
+Diagnostic checks for installation and environment issues.
+Like ``brew doctor`` or ``gh auth status`` — reports problems,
+doesn't fix them.
+"""
+
+import importlib.util
+import json
+import platform
+import shutil
+import sqlite3
+import sys
+from dataclasses import asdict, dataclass
+from pathlib import Path
+
+from footprinter.cli._common import FORMATTER, add_json_flag, console, output_json
+
+
+@dataclass
+class Check:
+    """Result of a single diagnostic check."""
+
+    name: str
+    status: str  # OK, WARN, FAIL
+    message: str = ""
+
+
+def _get_python_version() -> tuple:
+    return sys.version_info[:3]
+
+
+def _find_spec(name: str):
+    try:
+        return importlib.util.find_spec(name)
+    except (ModuleNotFoundError, ValueError):
+        return None
+
+
+def _probe_fda() -> bool:
+    """Return True if Safari History.db is readable (macOS FDA check)."""
+    safari_db = Path.home() / "Library" / "Safari" / "History.db"
+    if not safari_db.exists():
+        return True  # no Safari DB means nothing to check
+    try:
+        with sqlite3.connect(f"file:{safari_db}?mode=ro", uri=True) as conn:
+            conn.execute("SELECT count(*) FROM sqlite_master")
+        return True
+    except Exception:
+        return False
+
+
+def _check_python_version() -> Check:
+    major, minor, micro = _get_python_version()
+    if (major, minor) >= (3, 11):
+        return Check("python_version", "OK", f"Python {major}.{minor}.{micro}")
+    return Check(
+        "python_version",
+        "FAIL",
+        f"Python {major}.{minor}.{micro} — requires 3.11 or later",
+    )
+
+
+def _check_platform() -> Check:
+    system = platform.system()
+    machine = platform.machine()
+    return Check("platform", "OK", f"{system} ({machine})")
+
+
+def _check_config() -> Check:
+    from footprinter.paths import get_config_path
+
+    config_path = get_config_path()
+    if not config_path.exists():
+        return Check(
+            "config",
+            "WARN",
+            f"No config at {config_path} — run 'fp setup' to create one",
+        )
+    try:
+        import yaml
+
+        with open(config_path) as f:
+            yaml.safe_load(f)
+        return Check("config", "OK", str(config_path))
+    except Exception as e:
+        return Check("config", "FAIL", f"Config at {config_path} is not valid YAML: {e}")
+
+
+def _check_database() -> Check:
+    from footprinter.paths import get_db_path
+
+    db_path = get_db_path()
+    if not db_path.exists():
+        return Check(
+            "database",
+            "WARN",
+            f"No database at {db_path} — run 'fp ingest' to create one",
+        )
+    try:
+        with sqlite3.connect(f"file:{db_path}?mode=ro", uri=True) as conn:
+            conn.execute("SELECT count(*) FROM sqlite_master")
+        return Check("database", "OK", str(db_path))
+    except Exception as e:
+        return Check("database", "FAIL", f"Database at {db_path} is not readable: {e}")
+
+
+def _check_fda() -> Check:
+    if platform.system() != "Darwin":
+        return Check("fda", "OK", "Not macOS — Full Disk Access not applicable")
+    if _probe_fda():
+        return Check("fda", "OK", "Safari History.db is readable")
+    return Check(
+        "fda",
+        "WARN",
+        "Cannot read Safari History.db — grant Full Disk Access to your terminal in System Settings > Privacy & Security",
+    )
+
+
+def _check_semantic_deps() -> Check:
+    missing = []
+    for mod in ("chromadb", "sentence_transformers"):
+        if _find_spec(mod) is None:
+            missing.append(mod)
+    if not missing:
+        return Check("semantic_deps", "OK", "chromadb and sentence_transformers available")
+    return Check(
+        "semantic_deps",
+        "WARN",
+        f"Optional semantic search dependencies not installed: {', '.join(missing)} — install with: pipx install --force 'footprinter-cli[full]'",
+    )
+
+
+def _check_parse_deps() -> Check:
+    missing = []
+    for mod in ("docx", "pdfplumber"):
+        if _find_spec(mod) is None:
+            missing.append(mod)
+    if not missing:
+        return Check("parse_deps", "OK", "Document parsing dependencies available")
+    return Check(
+        "parse_deps",
+        "WARN",
+        f"Optional parsing dependencies not installed: {', '.join(missing)} — install with: pipx install --force 'footprinter-cli[full]'",
+    )
+
+
+def _check_mcp_config() -> Check:
+    if platform.system() == "Darwin":
+        config_path = (
+            Path.home()
+            / "Library"
+            / "Application Support"
+            / "Claude"
+            / "claude_desktop_config.json"
+        )
+    else:
+        config_dir = Path.home() / ".config" / "Claude"
+        config_path = config_dir / "claude_desktop_config.json"
+
+    if not config_path.exists():
+        return Check("mcp_config", "OK", "No Claude Desktop config found (optional)")
+
+    try:
+        with open(config_path) as f:
+            data = json.load(f)
+        servers = data.get("mcpServers", {})
+        if "footprinter" not in servers:
+            return Check("mcp_config", "OK", "Claude Desktop config exists but no footprinter entry (optional)")
+
+        entry = servers["footprinter"]
+        command = entry.get("command", "")
+        if command:
+            resolved = Path(command).exists() if Path(command).is_absolute() else shutil.which(command)
+            if not resolved:
+                return Check(
+                    "mcp_config",
+                    "WARN",
+                    f"MCP command not found: {command}",
+                )
+        return Check("mcp_config", "OK", "footprinter MCP server configured in Claude Desktop")
+    except Exception as e:
+        return Check("mcp_config", "WARN", f"Could not read Claude Desktop config: {e}")
+
+
+def run_checks() -> list[Check]:
+    """Run all diagnostic checks and return the results."""
+    return [
+        _check_python_version(),
+        _check_platform(),
+        _check_config(),
+        _check_database(),
+        _check_fda(),
+        _check_semantic_deps(),
+        _check_parse_deps(),
+        _check_mcp_config(),
+    ]
+
+
+def register(subparsers) -> None:
+    """Register ``fp doctor`` on the CLI router."""
+    parser = subparsers.add_parser(
+        "doctor",
+        help="Check installation health",
+        description=(
+            "Run diagnostic checks on your Footprinter installation.\n"
+            "Reports environment, configuration, and dependency status.\n"
+            "Diagnostic only — does not modify anything."
+        ),
+        epilog=(
+            "examples:\n"
+            "  fp doctor                  Run all health checks\n"
+            "  fp doctor --json           Machine-readable output"
+        ),
+        formatter_class=FORMATTER,
+    )
+    add_json_flag(parser)
+    parser.set_defaults(func=_handle)
+
+
+def _handle(args) -> None:
+    checks = run_checks()
+
+    if getattr(args, "json", False):
+        output_json([asdict(c) for c in checks])
+    else:
+        from rich.table import Table
+
+        table = Table(show_header=False, box=None, pad_edge=False)
+        table.add_column("check", style="bold")
+        table.add_column("status", width=6)
+        table.add_column("message")
+
+        for c in checks:
+            if c.status == "OK":
+                status_cell = f"[green]{c.status}[/green]"
+            elif c.status == "WARN":
+                status_cell = f"[yellow]{c.status}[/yellow]"
+            else:
+                status_cell = f"[red]{c.status}[/red]"
+            table.add_row(c.name, status_cell, c.message)
+
+        console.print(table)
+
+    has_fail = any(c.status == "FAIL" for c in checks)
+    if has_fail:
+        sys.exit(1)

{footprinter_cli-1.0.0rc3 → footprinter_cli-1.0.1}/footprinter/cli/mcp_setup.py

@@ -275,6 +275,65 @@ def write_config(snippet: dict, config_path: Path = None, dry_run: bool = False)
     return True
 
 
+def unregister_mcp_server(config_path: Path = None, dry_run: bool = False) -> bool:
+    """Remove the footprinter entry from the Claude Desktop MCP config.
+
+    Mirrors :func:`write_config` — backs up the existing file before mutating.
+    Idempotent: missing file or missing entry both return True without error.
+
+    Args:
+        config_path: Override config path (default: auto-detected).
+        dry_run: If True, report intent without writing.
+
+    Returns:
+        True on success (including no-op cases — missing file, missing
+        ``mcpServers`` key, or no footprinter entry). False when the
+        platform is unsupported (no config path) or the config file
+        exists but cannot be parsed as JSON.
+    """
+    path = config_path or detect_config_path()
+
+    if path is None:
+        console.print("[yellow]Unsupported platform — cannot detect MCP config path.[/yellow]")
+        return False
+
+    if not path.exists():
+        console.print(f"  [dim]No MCP config at {path} — nothing to remove.[/dim]")
+        return True
+
+    try:
+        with open(path, "r") as f:
+            existing = json.load(f)
+    except (json.JSONDecodeError, OSError) as e:
+        console.print(f"[red]Cannot read existing config:[/red] {e}")
+        return False
+
+    # Hand-edited configs may have ``"mcpServers": null`` — coerce to {}.
+    servers = existing.get("mcpServers") or {}
+    if "footprinter" not in servers:
+        console.print(f"  [dim]No footprinter entry in {path}.[/dim]")
+        return True
+
+    if dry_run:
+        console.print(f"[dim]Would remove footprinter from:[/dim] {path}")
+        return True
+
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")
+    backup = path.with_suffix(f".backup_{timestamp}.json")
+    shutil.copy2(path, backup)
+    console.print(f"  Backed up to [dim]{backup}[/dim]")
+
+    del servers["footprinter"]
+    existing["mcpServers"] = servers
+
+    with open(path, "w") as f:
+        json.dump(existing, f, indent=2)
+        f.write("\n")
+
+    console.print(f"  Removed footprinter from [bold]{path}[/bold]")
+    return True
+
+
 def print_client_paths():
     """Render a table of known MCP clients and their config locations."""
     table = Table(title="MCP Client Config Paths", show_header=True)