# ellmos-ai/ellmos-codecommander-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/ellmos-ai/ellmos-codecommander-mcp  
**GitHub Stars:** 3  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ellmos-ai-ellmos-codecommander-mcp

## Description
Developer-focused MCP server for code analysis, JSON repair, encoding fixes, and import organization across local projects.

## Tools
Capabilities this server exposes over MCP:

- **cc_analyze_code** — Full code analysis: classes, functions, imports, LOC, complexity
- **cc_analyze_methods** — Detailed method analysis: params, decorators, visibility, data flow, BACH guardrails
- **cc_extract_classes** — Extract Python classes/functions as separate text blocks, optionally including pycutter-style inline content
- **cc_organize_imports** — Sort & deduplicate Python imports per PEP 8
- **cc_diagnose_imports** — Detect unused imports, duplicates, circular import risks
- **cc_runtime_import_diagnose** — Run isolated Python runtime imports with timeouts, __init__.py analysis, and circular-import hints
- **cc_fix_json** — Repair broken JSON (BOM, trailing commas, comments, single quotes)
- **cc_validate_json** — Validate JSON with detailed error position and context
- **cc_fix_encoding** — Fix Mojibake / double-encoded UTF-8 (27+ patterns)
- **cc_cleanup_file** — Remove BOM, NUL bytes, trailing whitespace, normalize line endings
- **cc_fix_umlauts** — Repair broken German umlauts (70+ patterns, HTML entities, escapes)
- **cc_scan_emoji** — Scan files for emojis with codepoint info
- **cc_convert_format** — Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats
- **cc_generate_licenses** — Generate third-party license file (npm/pip)
- **cc_diff_files** — Compare two files with unified diff output (configurable context lines)
- **cc_regex_test** — Test regex patterns against text/files with match details, groups, and replace preview
- **cc_check_indentation** — Detect missing colons, unindented return/yield statements, and mixed tab/space indentation
- **cc_generate_python_code** — Generate Python functions, classes, dataclasses, CLI stubs, tests, exceptions, and modules from templates
- **cc_python_structural_edit** — Inspect and apply structural Python edits with preview, test-file, syntax-check and backup modes
- **cc_md_to_html** — Markdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes)
- **cc_md_to_pdf** — Markdown to PDF via headless browser (Edge/Chrome). Falls back to HTML if no browser is available

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "ellmos-codecommander-mcp": {
    "command": "npx",
    "args": ["-y","ellmos-ai-ellmos-codecommander-mcp"]
  }
}
```

## Documentation & README

<p align="center">
  <img src="https://raw.githubusercontent.com/ellmos-ai/.github/master/profile/logo-ellmos-codecommander.jpg" alt="ellmos CodeCommander MCP emblem" width="400">
</p>

# ellmos CodeCommander MCP Server

**🇩🇪 [Deutsche Version](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/README_de.md)**

*Part of the [ellmos-ai](https://github.com/ellmos-ai) family.*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![npm version](https://img.shields.io/npm/v/ellmos-codecommander-mcp.svg)](https://www.npmjs.com/package/ellmos-codecommander-mcp)
[![CI Tests](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml)
[![Tests](https://img.shields.io/badge/tests-292%20passed%20%7C%20100%25-brightgreen.svg)](https://github.com/ellmos-ai/ellmos-codecommander-mcp)
[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://nodejs.org/)
[![Privacy](https://img.shields.io/badge/Privacy-100%25%20Offline%20%7C%20Zero--Egress-success.svg)](SECURITY.md)
[![Security](https://img.shields.io/badge/Security-Local--First%20%7C%20Preview--Safe-blue.svg)](SECURITY.md)
[![Security SLA](https://img.shields.io/badge/security-48h%20Response%20%7C%205d%20Triage-blue.svg)](SECURITY.md)
[![Third-Party Audited](https://img.shields.io/badge/third--party-audited-success.svg)](THIRD_PARTY_LICENSES.md)
[![Marketing Log](https://img.shields.io/badge/marketing-audited-blueviolet.svg)](MARKETING-LOG.txt)
[![Ecosystem](https://img.shields.io/badge/ellmos--ai-Ecosystem-blue.svg)](https://github.com/ellmos-ai)
[![Umbrella](https://img.shields.io/badge/open--bricks-Umbrella-purple.svg)](https://github.com/open-bricks)
[![LLM Indexing](https://img.shields.io/badge/LLM--Ready-llms.txt-blue.svg)](llms.txt)

> [!NOTE]
> **For AI Assistants & LLMs:** Machine-readable indexing documentation for this repository is available at [`llms.txt`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/llms.txt). The server exposes 23 specialized tools under the `cc_` prefix.

A developer-focused **Model Context Protocol (MCP) server** that gives AI assistants code analysis, structural Python editing, JSON repair, encoding fix, import organization, format conversion, file diff, and regex testing capabilities.

**23 tools** optimized for developers - the coding companion to [FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp).

**Discoverability:** Published on [npm](https://www.npmjs.com/package/ellmos-codecommander-mcp) as `ellmos-codecommander-mcp`, visible on [Glama](https://glama.ai/mcp/servers/b9kjs4uaav), and prepared for the official MCP Registry with [`server.json`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/server.json) under `io.github.ellmos-ai/ellmos-codecommander-mcp`. Registry and directory manifests [`server.json`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/server.json), [`glama.json`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/glama.json), [`smithery.yaml`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/smithery.yaml), and [`llms.txt`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/llms.txt) are maintained in full parity.

---

## Quick Navigation

1. [Overview & Highlights](#1-overview--highlights)
2. [Architecture & System Overview](#2-architecture--system-overview)
3. [Safe Structural Edit Lifecycle](#3-safe-structural-edit-lifecycle)
4. [Governance & Runtime Invariants](#4-governance--runtime-invariants)
5. [Developer Tool Suite (23 Tools)](#5-developer-tool-suite-23-tools)
6. [Shared Tools with FileCommander](#6-shared-tools-with-filecommander)
7. [Installation & Quickstart](#7-installation--quickstart)
8. [Configuration & MCP Client Setup](#8-configuration--mcp-client-setup)
9. [Multi-Language Support (i18n)](#9-multi-language-support-i18n)
10. [Development & Quality Assurance](#10-development--quality-assurance)
11. [Sibling Ecosystem & Partner Matrix](#11-sibling-ecosystem--partner-matrix)
12. [Third-Party Licenses & Transparency](#12-third-party-licenses--transparency)
13. [Security Policy & Response SLA](#13-security-policy--response-sla)
14. [Changelog & Version History](#14-changelog--version-history)
15. [License & Liability Notice](#15-license--liability-notice)

---

## 1. Overview & Highlights

While FileCommander handles filesystem operations and system processes, CodeCommander focuses specifically on **code intelligence and developer precision**:

- **Python, JavaScript & TypeScript Analysis** — Extension-dispatched classes, methods, functions, complexity metrics, and import analysis; JS/TS analysis is regex-based and read-only.
- **BACH-derived Python Helpers** — Runtime import diagnostics, structural edits, indentation checks, and template-based code generation.
- **Explicit Language Gates** — Python-only path tools reject non-`.py` files explicitly instead of producing Python-shaped false findings.
- **JSON Repair & Validation** — Automatically repair broken JSON (trailing commas, single quotes, BOM, comments) with precise error locations.
- **PEP 8 Import Organization** — Sort and deduplicate Python imports per PEP 8 guidelines.
- **Encoding & Mojibake Repair** — Fix Mojibake and double-encoded UTF-8 (27+ patterns) and broken German characters (70+ umlaut patterns).
- **Universal Format Conversion** — Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats losslessly.
- **Unified File Diff** — Compare two files with LCS unified diff output and configurable context lines.
- **Regex Testing Workbench** — Test regular expressions with match details, capturing groups, and replace previews.
- **Markdown Export** — Convert Markdown to standalone HTML or PDF with syntax-styled code blocks, tables, and blockquotes.
- **Cross-Platform Native** — Full support on Windows, macOS, and Linux.

---

## 2. Architecture & System Overview

```mermaid
graph TD
    Client["MCP Clients<br/>(Claude Desktop / Claude Code / Cursor / Windsurf)"]
    Server["ellmos CodeCommander MCP Server<br/>(stdio transport • Node.js)"]

    subgraph Tools["Developer Tool Suites (23 Tools)"]
        subgraph CodeIntel["Code & Python Intelligence"]
            C1["cc_analyze_code"]
            C2["cc_analyze_methods"]
            C3["cc_extract_classes"]
            C4["cc_check_indentation"]
            C5["cc_generate_python_code"]
            C6["cc_python_structural_edit"]
        end

        subgraph Imports["Import Management"]
            I1["cc_organize_imports"]
            I2["cc_diagnose_imports"]
            I3["cc_runtime_import_diagnose"]
        end

        subgraph Repair["Text, JSON & Encoding Repair"]
            R1["cc_fix_json"]
            R2["cc_validate_json"]
            R3["cc_fix_encoding"]
            R4["cc_cleanup_file"]
            R5["cc_fix_umlauts"]
        end

        subgraph Utility["Utilities & Conversion"]
            U1["cc_convert_format (JSON/CSV/YAML/TOML/XML/TOON)"]
            U2["cc_diff_files (Unified Diff)"]
            U3["cc_regex_test (Regex Tester)"]
            U4["cc_scan_emoji"]
            U5["cc_generate_licenses"]
        end

        subgraph Export["Export & i18n"]
            E1["cc_md_to_html"]
            E2["cc_md_to_pdf"]
            E3["cc_set_language"]
            E4["cc_get_language"]
        end
    end

    Client -->|Stdio JSON-RPC| Server
    Server --> CodeIntel
    Server --> Imports
    Server --> Repair
    Server --> Utility
    Server --> Export
```

---

## 3. Safe Structural Edit Lifecycle

```mermaid
sequenceDiagram
    autonumber
    actor Developer as Developer / LLM Client
    participant Stdio as CodeCommander Server (stdio)
    participant Core as AST & Code Intelligence Core
    participant Disk as Local Filesystem

    Developer->>Stdio: cc_python_structural_edit (mode: "preview" / "apply")
    Stdio->>Core: Parse Python AST & Validate Syntax
    alt Validation Failed
        Core-->>Stdio: Syntax / Parsing Diagnostics
        Stdio-->>Developer: Error Diagnostics & Line References
    else Validation Passed
        Core->>Disk: Read Original File
        Core->>Core: Compute Unified Structural Diff
        alt Mode == "preview"
            Core-->>Stdio: Return Diff Preview (Zero File Mutations)
            Stdio-->>Developer: Structural Diff Preview
        else Mode == "apply"
            Core->>Disk: Create .bak Backup File
            Core->>Disk: Write Modified AST Code In-Place
            Core-->>Stdio: Confirmation with Applied Diff & Backup Path
            Stdio-->>Developer: Success Payload
        end
    end
```

---

## 4. Governance & Runtime Invariants

`ellmos-codecommander-mcp` guarantees 10 core architectural and runtime invariants across all platforms:

| Invariant ID | Classification | Architectural Guarantee & Verification Mechanism |
| :--- | :--- | :--- |
| `INV-LOCAL-01` | Zero-Egress Privacy | Pure local stdio JSON-RPC transport; zero network telemetry, cloud beacons, or remote egress. |
| `INV-SEC-02` | Unprivileged Security | Standard user-space execution (`RunAsInvoker`) requiring zero root or administrative elevation. |
| `INV-PREV-03` | Preview Safety | Structural edits default to non-mutating preview mode (`mode: "preview"`) with unified diff generation. |
| `INV-BAK-04` | Automatic Backups | File modifications automatically generate timestamped `.bak` files before in-place disk writes. |
| `INV-ISOL-05` | Subprocess Isolation | Python runtime import diagnosis executes in isolated, timeout-bounded child processes. |
| `INV-GATE-06` | Explicit Language Gates | Python-specific path tools reject non-`.py` files explicitly; JS/TS analysis is read-only and regex-based. |
| `INV-ENC-07` | Non-Destructive Encoding | Repaired text restores 27+ Mojibake and 70+ German umlaut patterns without loss or binary corruption. |
| `INV-FMT-08` | Format Interchange Parity | Lossless format conversions across JSON, CSV, INI, YAML, TOML, XML, and TOON with schema preservation. |
| `INV-I18N-09` | Runtime Multi-Language | Dynamic runtime language switching across 6 languages (EN, DE, ES, ZH, JA, RU) via `cc_set_language`. |
| `INV-SLA-10` | 48h Security Response SLA | Verified across Ubuntu, Windows, macOS on Node 20, 22, 24 with public 48h response / 5-day triage commitment. |

---

## 5. Developer Tool Suite (23 Tools)

### Code Analysis (3 tools)

| Tool | Description |
|------|-------------|
| `cc_analyze_code` | Read-only Python or regex-based JavaScript/TypeScript analysis: classes, functions, imports, LOC, complexity |
| `cc_analyze_methods` | Read-only Python or regex-based JavaScript/TypeScript method analysis; Python retains its BACH guardrails |
| `cc_extract_classes` | Extract Python classes/functions as separate text blocks, optionally including pycutter-style inline content |

### Import Management (3 tools)

| Tool | Description |
|------|-------------|
| `cc_organize_imports` | Sort & deduplicate Python imports per PEP 8 |
| `cc_diagnose_imports` | Read-only Python or regex-based JavaScript/TypeScript import diagnostics |
| `cc_runtime_import_diagnose` | Run isolated Python runtime imports with timeouts, `__init__.py` analysis, and circular-import hints |

### JSON Tools (2 tools)

| Tool | Description |
|------|-------------|
| `cc_fix_json` | Repair broken JSON (BOM, trailing commas, comments, single quotes) |
| `cc_validate_json` | Validate JSON with detailed error position and context |

### Encoding & Text (3 tools)

| Tool | Description |
|------|-------------|
| `cc_fix_encoding` | Fix Mojibake / double-encoded UTF-8 (27+ patterns) |
| `cc_cleanup_file` | Remove BOM, NUL bytes, trailing whitespace, normalize line endings |
| `cc_fix_umlauts` | Repair broken German umlauts (70+ patterns, HTML entities, escapes) |

### Scanning (1 tool)

| Tool | Description |
|------|-------------|
| `cc_scan_emoji` | Scan files for emojis with codepoint info |

### Format & Documentation (2 tools)

| Tool | Description |
|------|-------------|
| `cc_convert_format` | Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats |
| `cc_generate_licenses` | Generate third-party license file (npm/pip) |

### Developer Utilities (2 tools)

| Tool | Description |
|------|-------------|
| `cc_diff_files` | Compare two files with unified diff output (configurable context lines) |
| `cc_regex_test` | Test regex patterns against text/files with match details, groups, and replace preview |

### Python Assistance (3 tools)

| Tool | Description |
|------|-------------|
| `cc_check_indentation` | Detect missing colons, unindented return/yield statements, and mixed tab/space indentation |
| `cc_generate_python_code` | Generate Python functions, classes, dataclasses, CLI stubs, tests, exceptions, and modules from templates |
| `cc_python_structural_edit` | Inspect and apply structural Python edits with preview, test-file, syntax-check and backup modes |

### Export (2 tools)

| Tool | Description |
|------|-------------|
| `cc_md_to_html` | Markdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes) |
| `cc_md_to_pdf` | Markdown to PDF via headless browser (Edge/Chrome). Falls back to HTML if no browser is available |

### Runtime Language Management (2 tools)

| Tool | Description |
|------|-------------|
| `cc_set_language` | Switch active runtime language (`en`, `de`, `es`, `zh`, `ja`, `ru`) |
| `cc_get_language` | Query currently active language and supported locale codes |

**Total: 23 developer tools** available under the `cc_` prefix.

---

## 6. Shared Tools with FileCommander

7 tools exist in both FileCommander and CodeCommander for convenience:

| FileCommander | CodeCommander | Function |
|---------------|---------------|----------|
| `fc_fix_json` | `cc_fix_json` | JSON repair |
| `fc_validate_json` | `cc_validate_json` | JSON validation |
| `fc_fix_encoding` | `cc_fix_encoding` | Encoding repair |
| `fc_cleanup_file` | `cc_cleanup_file` | File cleanup |
| `fc_convert_format` | `cc_convert_format` | Format conversion (JSON/CSV/INI/YAML/TOML/XML/TOON) |
| `fc_md_to_html` | `cc_md_to_html` | Markdown to HTML export |
| `fc_md_to_pdf` | `cc_md_to_pdf` | Markdown to PDF export |

All tools in CodeCommander use the `cc_` prefix to guarantee seamless coexistence with FileCommander's `fc_` namespace.

---

## 7. Installation & Quickstart

### Prerequisites

- [Node.js](https://nodejs.org/) 20 or higher
- npm 9 or higher

### Option 1: Install from NPM (Recommended)

```bash
npm install -g ellmos-codecommander-mcp
```

### Option 2: Install from Source

```bash
git clone https://github.com/ellmos-ai/ellmos-codecommander-mcp.git
cd ellmos-codecommander-mcp
npm install
npm run build
```

---

## 8. Configuration & MCP Client Setup

### Claude Desktop

Add to your `claude_desktop_config.json`:

- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

#### Global NPM Install:

```json
{
  "mcpServers": {
    "codecommander": {
      "command": "ellmos-codecommander"
    }
  }
}
```

#### From Source Build:

```json
{
  "mcpServers": {
    "codecommander": {
      "command": "node",
      "args": ["/absolute/path/to/ellmos-codecommander-mcp/dist/index.js"]
    }
  }
}
```

### Coexistence with FileCommander

FileCommander and CodeCommander are designed to run concurrently:

```json
{
  "mcpServers": {
    "filecommander": {
      "command": "ellmos-filecommander"
    },
    "codecommander": {
      "command": "ellmos-codecommander"
    }
  }
}
```

---

## 9. Multi-Language Support (i18n)

CodeCommander natively supports 6 languages for all tool descriptions, output notices, and diagnostic messages:
- `en` — English (Default)
- `de` — Deutsch (German)
- `es` — Español (Spanish)
- `zh` — 简体中文 (Chinese Simplified)
- `ja` — 日本語 (Japanese)
- `ru` — Русский (Russian)

Use `cc_get_language` to check the current language or `cc_set_language` to dynamically change it during an active MCP session.

---

## 10. Development & Quality Assurance

```bash
npm install
npm run dev               # TypeScript watch mode
npm run build             # Compile TypeScript to dist/
npm start                 # Run built server via stdio
npm test                  # Run Vitest unit suite (196 tests)
npm run test:integration  # Real MCP stdio test suite (52 assertions, build first)
npm run test:i18n         # Translation parity test suite (43 assertions)
npm run test:all          # Run full QA pipeline (build + vitest + integration + i18n)
```

The test gates are deliberately separated and automated in CI across **Ubuntu**, **macOS**, and **Windows** on Node.js 20, 22, and 24 (totaling 292 automated assertions, 100% green).

---

## 11. Sibling Ecosystem & Partner Matrix

Part of the **[ellmos-ai](https://github.com/ellmos-ai)** and **[open-bricks](https://github.com/open-bricks)** family of local-first tools:

### MCP Server Family

| Server | Tools | Focus | npm |
|--------|-------|-------|-----|
| [FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp) | 50 | Filesystem, process management, interactive sessions, cloud-lock-safe operations | [`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp) |
| **[CodeCommander](https://github.com/ellmos-ai/ellmos-codecommander-mcp)** | **23** | **Code analysis, AST edits, JSON repair, diff, regex** | **[`ellmos-codecommander-mcp`](https://www.npmjs.com/package/ellmos-codecommander-mcp)** |
| [Clatcher](https://github.com/ellmos-ai/ellmos-clatcher-mcp) | 12 | File repair, format conversion, batch operations | [`ellmos-clatcher-mcp`](https://www.npmjs.com/package/ellmos-clatcher-mcp) |
| [n8n Manager](https://github.com/ellmos-ai/n8n-manager-mcp) | 19 | n8n workflow management via AI assistants | [`n8n-manager-mcp`](https://www.npmjs.com/package/n8n-manager-mcp) |
| [ControlCenter](https://github.com/ellmos-ai/ellmos-controlcenter-mcp) | 34 | MCP stack discovery, profile management, control plane | [`ellmos-controlcenter-mcp`](https://www.npmjs.com/package/ellmos-controlcenter-mcp) |
| [Homebase](https://github.com/ellmos-ai/ellmos-homebase-mcp) | 51 | Local-first LLM memory, knowledge, state, routing, swarm orchestration | [`ellmos-homebase-mcp`](https://www.npmjs.com/package/ellmos-homebase-mcp) (alpha) |
| [ServerCommander](https://github.com/ellmos-ai/ellmos-servercommander-mcp) | 8 | Server operations: health checks, log analysis, deploy dry-runs, mail diagnostics | [`ellmos-servercommander-mcp`](https://www.npmjs.com/package/ellmos-servercommander-mcp) (alpha) |
| [Blender Use](https://github.com/ellmos-ai/ellmos-blender-use-mcp) | 4 | Headless Blender asset QA and FBX reimport verification | [`ellmos-blender-use-mcp`](https://www.npmjs.com/package/ellmos-blender-use-mcp) (alpha) |
| [Open Compute](https://github.com/ellmos-ai/open-compute-mcp) | 16 | Model-agnostic computer use: capture, safety-gated actions, Windows UIA | [`open-compute-mcp`](https://www.npmjs.com/package/open-compute-mcp) (alpha) |

### Sibling Developer, File & Document Tools

| Ecosystem | Tool / Project | Focus & Capabilities |
|---|---|---|
| **ellmos-ai** | [sqlite-transit-sync](https://github.com/ellmos-ai/sqlite-transit-sync) | Offline SQLite change distribution with HMAC verification |
| **ellmos-ai** | [policy-registry](https://github.com/ellmos-ai/policy-registry) | Cryptographically signed delegation policies for AI agents |
| **ellmos-ai** | [clutch](https://github.com/ellmos-ai/clutch) | Provider-neutral LLM orchestration with auto-routing and budget tracking |
| **ellmos-ai** | [BACH](https://github.com/ellmos-ai/bach) | Local-first text-based OS for LLM agents — 113+ handlers, 550+ tools |
| **dev-bricks** | [DevCenter](https://github.com/dev-bricks/DevCenter) | PySide6 Developer Desktop Suite & offline secret vault |
| **dev-bricks** | [CodeBox](https://github.com/dev-bricks/CodeBox) | Fast desktop code snippet manager & local AST indexing |
| **dev-bricks** | [MethodenAnalyser](https://github.com/dev-bricks/MethodenAnalyser) | Method flow & complexity diagnostic engine |
| **doc-bricks** | [PDFtoPDFocr](https://github.com/doc-bricks/PDFtoPDFocr) | Desktop OCR pipeline for searchable PDFs with Tesseract |
| **doc-bricks** | [DokuReader](https://github.com/doc-bricks/DokuReader) | Multi-format document workspace & offline PDF export |
| **file-bricks** | [ProFiler](https://github.com/file-bricks/ProFiler) | Multi-pane file management & bulk batch operations |
| **open-bricks** | [open-bricks](https://github.com/open-bricks) | Umbrella organization for AI-native desktop applications |

---

## 12. Third-Party Licenses & Transparency

This project strictly adheres to open-source transparency:
- All runtime and development dependencies are audited in [`THIRD_PARTY_LICENSES.md`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/THIRD_PARTY_LICENSES.md).
- Distributed exclusively under permissive open-source licenses (**MIT**, **BSD-2-Clause**, **BSD-3-Clause**, **Apache-2.0**).
- Comprehensive discoverability, personas, and marketing metrics are documented in [`MARKETING-LOG.txt`](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/MARKETING-LOG.txt).
- Zero proprietary tracking, zero telemetric beacons, and zero viral copyleft dependencies.

---

## 13. Security Policy & Response SLA

Please review [SECURITY.md](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/SECURITY.md) for full vulnerability disclosure procedures.

- **Zero-Egress Guarantee:** Completely local execution over stdio.
- **Preview & Backup Safety:** Destructive operations create `.bak` backups and support non-mutating preview.
- **Unprivileged User Mode:** Runs under standard unprivileged user permissions (`RunAsInvoker`).
- **Dedicated Response Channels:** Contact `security@ellmos.ai` and `support@lukasgeiger.com` with a guaranteed **48-hour initial response SLA** and **5-day triage commitment**.

---

## 14. Changelog & Version History

See [CHANGELOG.md](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/CHANGELOG.md) for release notes and version history.

---

## 15. License & Liability Notice

This project is licensed under the [MIT License](https://github.com/ellmos-ai/ellmos-codecommander-mcp/blob/HEAD/LICENSE) — Copyright © 2026 Lukas Geiger ([ellmos-ai](https://github.com/ellmos-ai)).

Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gilt der Haftungsausschluss der MIT-Lizenz. Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.

*This project is an unpaid open-source donation under German law. Liability is limited to intent and gross negligence (§ 521 German Civil Code), supplemented by the MIT License warranty disclaimer. Use at your own risk.*

