{
  "markdown": "# PLwC — Personality Layer with Conscience\n\n<p align=\"center\">\n  <img src=\"plwc-icon-512.png\" alt=\"PLwC Gateway logo\" width=\"192\">\n</p>\n\nPLwC is a local, model-independent governance gateway for AI tool access,\npersistent context and controlled memory. It is not the agent and it is not the\nlanguage model. It is the independent control layer between the AI host, the\nmodel and local tools.\n\n```text\nAI host / model\n       |\n       v\nPLwC governance gateway\n       |\n       v\ntools, files, profiles, memory and sandbox\n```\n\nPLwC exposes **one visible MCP server**, routes all capabilities through policy\nand governance checks, and provides workspace, document, sandbox, profile,\nreflection and audit-oriented controls. The gateway is designed for MCP-capable\nhosts in general. Claude Desktop is a packaged and smoke-tested route, but the\nboundary remains useful when a host, such\nas ChatGPT Work, Claude or another MCP client, also offers its own file access\nor agent features.\n\n## Status\n\n- Current product version: **PLwC 1.0.0**; distribution remains a pre-release\n  until the external browser Store gates pass.\n- This repository retains a privacy-filtered public release boundary. Private\n  development history, local evidence, real profiles and workspace data are\n  intentionally not included.\n- Version `1.0.0` contains the complete eight-tool governed Gateway and the\n  PLwC Chat Bridge 1.0 integration for Chrome, Brave and Edge.\n- The explicit unsigned Windows candidate is\n  `PLwC-Setup-1.0.0-installer-r24.exe`, SHA-256\n  `b00c5298bf6faa76c5910ecbb36497a8aa4764a8a3720f73a450851a3fc3e4d0`.\n  It is available from the versioned\n  [GitHub pre-release](https://github.com/mhoedt-ai/PLwC/releases/tag/plwc-setup-1.0.0-installer-r24).\n- Internal source, installed-update, Bridge, extension and installer gates\n  pass. On 2026-08-30, the private Chrome submission entered pending review\n  with automatic publication disabled, and the hidden/link-only Edge submission\n  entered review. Store approval, controlled availability and Store-signed\n  live-browser acceptance remain separate gates.\n- The current Windows Setup and packaged MCPB are **not signed**.\n\nPLwC is not production-certified. It is local infrastructure under\nactive development.\n\n## What PLwC is - and what it is not\n\nPLwC is:\n\n- an MCP gateway, not its own agent;\n- a local governance boundary between model requests and tool execution;\n- model- and host-independent policy for MCP-capable hosts;\n- controlled memory, profile and persona management through explicit profile,\n  reflection and Governor flows;\n- a single public MCP boundary named `plwc-gateway`.\n\nPLwC is not:\n\n- a standalone AI platform;\n- a desktop agent;\n- the language model or a replacement for the user's chosen AI host;\n- a full proxy for all model traffic;\n- protection for data that a user or host sends directly to a cloud model\n  outside PLwC;\n- permission to expose raw PLfC/PBA or Desktop Commander MCP servers beside the\n  gateway.\n\n## What PLwC does\n\n- Exposes exactly **one** visible MCP server: `plwc-gateway`.\n- Provides exactly **eight** public facade tools (see below).\n- Controls workspace operations (read / write / search / move / rename\n  / exact replace / batch read).\n- Creates and reads `DOCX`, `XLSX`, `PPTX` and `PDF` artifacts.\n- Inspects, extracts, merges, splits and rotates PDFs.\n- Inspects, extracts and creates ZIP archives with bounded safety\n  limits.\n- Reads workspace raster images and returns them as MCP image content\n  blocks (PNG, JPEG, WEBP, first-frame GIF).\n- Runs sandboxed Python and Shell snippets through Docker, with no\n  silent fallback to a host shell.\n- Manages profiles, reflection writes, memory and persona governance,\n  and Governor `plan` / `apply` flows including\n  `reflection_condensation` with `plan_id` apply.\n- Blocks protected profile and governance paths from direct workspace\n  writes.\n- Emits structured local audit events for high-risk operations.\n\n## Public tools\n\nPLwC 1.0 exposes exactly these eight public facade tools:\n\n| Tool | What it does |\n|---|---|\n| `plwc_status` | Reports gateway, sandbox, and profile runtime state; generates a ready-to-paste Claude Desktop config snippet. |\n| `plwc_describe` | Returns a self-description of all supported tools, operations, plan types, and capability boundaries — the single source of truth for what PLwC can do in the current session. |\n| `plwc_profile` | Loads, inspects, and activates profiles; compiles the configured profile into the active session context. |\n| `plwc_reflection` | Writes governed reflection entries to `reflection.md` with semantic validation — rejects pure technical logs and requires a reusable user, collaboration, or system insight. |\n| `plwc_governor` | Two-stage plan / apply flow for promoting insights to `memory.md` or `PERSONA.md`, condensing stale reflection candidates, and creating new profiles — all requiring explicit confirmation before any write. |\n| `plwc_sandbox_run` | Executes Python or Shell snippets in an isolated Docker container with no network access and no silent fallback to a host shell. |\n| `plwc_workspace_operation` | Reads, writes, lists, searches, copies, moves, and renames files within configured workspace roots; includes binary and base64 paths and an exact-replace mode. Delete is not public. |\n| `plwc_document_operation` | Creates and manipulates DOCX, XLSX, PPTX, and PDF files; inspects, merges, splits, rotates, and extracts text from PDFs; handles ZIP archives; reads workspace images as MCP image content blocks. |\n\nThe 19 individual public tool names from earlier scaffolds\n(`plwc_compile_profile`, `plwc_write_workspace_file`,\n`plwc_governor_plan`, `plwc_write_reflection`, ...) are **no longer\npublic** in v1.0. Their behavior is reachable through the eight facade\ntools above via `operation` / `scope` / `lang` dispatch parameters.\n\n## Document capabilities\n\n- DOCX Creation V2 (layouts, styles, runs, lists, tables, images,\n  page breaks).\n- XLSX Creation V2 (multi-sheet, formatting, formulas-as-written\n  (not executed), freeze panes, boolean `auto_filter`, merges).\n- PPTX Creation V2 (five slide layouts, content elements, tables,\n  images, slide sizes, plain-text speaker notes).\n- PDF Creation V2 (layout-PDF builder with A4/A5/landscape/custom page\n  sizes, headings, paragraph runs, bullet/numbered lists, tables,\n  images, explicit page breaks).\n- `read_image` (governed workspace image reads).\n- ZIP create / inspect / extract.\n- PDF inspect / extract / merge / split / rotate / extract_pdf_text.\n\n## Security model\n\n- One visible gateway server. No bypass MCP servers are exposed.\n- Protected profile and governance files (`PERSONA.md`, `memory.md`,\n  `reflection.md`, `governance/config.yaml`, ...) cannot be edited\n  through workspace operations.\n- Workspace operations are scoped to configured roots; parent\n  traversal, absolute host paths, UNC paths and protected segments are\n  rejected.\n- Docker-backed Python and Shell sandbox; **no silent host-shell\n  fallback**.\n- Fail-closed behavior on missing engines, missing Docker image, or\n  policy denial.\n- No external URL fetching for document assets (PDF V2, PPTX V2 and\n  DOCX V2 image paths must be workspace-relative).\n\n## Known limitations\n\nThe following are intentionally **not implemented** in v1.0:\n\n- No OCR.\n- No PDF redaction.\n- No digital signing.\n- No form filling or form creation.\n- No PDF/A claim.\n- No LibreOffice or Pandoc conversion.\n- No macro execution (no `.docm` / `.xlsm` / `.pptm` generation).\n- No external URL fetching, no network access at runtime.\n- No JavaScript in PDFs.\n- No HTML/CSS rendering pipeline.\n\n## Installation\n\nFor step-by-step installation, see\n[`docs/QUICKSTART_CLAUDE_DESKTOP.md`](docs/QUICKSTART_CLAUDE_DESKTOP.md).\n\nFor full installation context, prerequisites and configuration\noptions, including local GPT and Odysseus stdio setup plus hosted ChatGPT\nweb/custom-app status, see [`docs/INSTALLATION.md`](docs/INSTALLATION.md).\n\nThe selectable Windows EXE installer is maintained under\n[`installer/windows`](installer/windows/README.md). The current r24 candidate\npackages the Gateway, Claude MCPB, Codex and Odysseus STDIO preparation, and the\nlocal PLwC Chat Bridge. It detects complete existing installations, preserves\ntheir paths and settings, and uses stable `gateway` and `bridge` directory\nnames for new installs. Its gated build and validation status is documented in\n[`installer/windows/V_MODEL.md`](installer/windows/V_MODEL.md). The public r24\nartifact is explicitly unsigned and remains a pre-release candidate.\n\nThe bilingual end-user flow, including language selection, administrator\napproval, download/storage estimates and Chrome/Edge Bridge setup, is described\nin [`docs/WINDOWS_INSTALLER_GUIDE.md`](docs/WINDOWS_INSTALLER_GUIDE.md).\n\n## Documentation\n\n- Current 1.0 program and software description:\n  [`docs/PROGRAM_AND_SOFTWARE_DESCRIPTION_1_0.md`](docs/PROGRAM_AND_SOFTWARE_DESCRIPTION_1_0.md)\n- Historical rc18 Open Beta program and software description:\n  [`docs/PROGRAM_AND_SOFTWARE_DESCRIPTION_OPEN_BETA.md`](docs/PROGRAM_AND_SOFTWARE_DESCRIPTION_OPEN_BETA.md)\n- Install / quickstart: [`docs/INSTALLATION.md`](docs/INSTALLATION.md),\n  [`docs/QUICKSTART_CLAUDE_DESKTOP.md`](docs/QUICKSTART_CLAUDE_DESKTOP.md),\n  [`docs/WINDOWS_INSTALLER_GUIDE.md`](docs/WINDOWS_INSTALLER_GUIDE.md)\n- Tool reference: [`docs/TOOLS.md`](docs/TOOLS.md)\n- Project scope: [`docs/PROJECT_SCOPE.md`](docs/PROJECT_SCOPE.md)\n- Security model and protected boundary:\n  [`docs/SECURITY_MODEL.md`](docs/SECURITY_MODEL.md),\n  [`docs/SAFE_MODE.md`](docs/SAFE_MODE.md)\n- Onboarding / profile setup:\n  [`docs/ONBOARDING.md`](docs/ONBOARDING.md),\n  [`docs/FIRST_RUN.md`](docs/FIRST_RUN.md)\n- Configuration and troubleshooting:\n  [`docs/CONFIGURATION.md`](docs/CONFIGURATION.md),\n  [`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md)\n- Maintainer client-integration design and scaffold:\n  [`docs/LOCAL_CHATGPT_CLIENT_ADAPTER.md`](docs/LOCAL_CHATGPT_CLIENT_ADAPTER.md),\n  [`integrations/plwc-chat-bridge/`](integrations/plwc-chat-bridge/)\n- Open beta / external testing - **start here:**\n  [`BETA_TESTING.md`](BETA_TESTING.md). Details:\n  [`docs/EXTERNAL_TESTER_GUIDE.md`](docs/EXTERNAL_TESTER_GUIDE.md),\n  [`docs/EXTERNAL_TEST_PLAN.md`](docs/EXTERNAL_TEST_PLAN.md),\n  [`docs/BUG_REPORT_TEMPLATE.md`](docs/BUG_REPORT_TEMPLATE.md),\n  [`docs/GITHUB_BETA_WORKFLOW.md`](docs/GITHUB_BETA_WORKFLOW.md)\n- Audit behavior: [`docs/AUDIT_LOG.md`](docs/AUDIT_LOG.md)\n\n## Project Website and Contact\n\n- Official website: [plwc.de](https://plwc.de/)\n- General inquiries: [info@plwc.de](mailto:info@plwc.de)\n\nUse [GitHub Issues](https://github.com/mhoedt-ai/PLwC/issues) for reproducible\nbugs and feature requests. For security-sensitive reports, contact\n[info@plwc.de](mailto:info@plwc.de) privately. Do not include secrets, real\nprofile content, private paths or other sensitive details in public issues.\n\n## Support\n\nIf PLwC helps you, you can support development via Ko-fi:\n\nhttps://ko-fi.com/mhoedtai\n\nKo-fi support is voluntary and not required to use PLwC.\n\n## License\n\nPLwC is licensed under the Apache License 2.0. See [LICENSE](LICENSE).\n",
  "bytes": 11166,
  "sha": "92a721a6967c9b14715db4d02129a25c5f0382d77a68cd56cad74364ffc7b9aa",
  "repo_slug": "mhoedt-ai/plwc",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mhoedt_ai_plwc_gateway_7feee654/readme"
}