Skip to content
Back to search

dsh-doc

MarketplaceWorks with Claude CodeGitHub

Universal document editor, layout/rendering engine, conversion engine, MCP server and agent skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahmadfarizoffice-dotcom--dsh-doc-editor/badge.svg)](/listings/ahmadfarizoffice-dotcom--dsh-doc-editor)

HTML

<a href="/listings/ahmadfarizoffice-dotcom--dsh-doc-editor"><img src="/api/listings/ahmadfarizoffice-dotcom--dsh-doc-editor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: **Node.js ≥ 22** and **pnpm** (the repository pins `packageManager: pnpm@11.28.5`).

pnpm install
pnpm run build          # core library, MCP server, CLI, web editor
pnpm test               # unit + integration + fixture + MCP protocol tests

Editor

pnpm run web:dev        # Vite dev server (http://127.0.0.1:5173, proxies /api to :4317)
# or, after a build:
pnpm run web:start      # serves the built UI + HTTP API on :4317 (PORT overrides)

The editor is model-first: typing, formatting, lists, tables, images, comments and AI applications are all translated into deterministic document operations, so undo, auditing and import/export see exactly the same document.

MCP server (stdio)

pnpm run mcp:start
# equivalent: node apps/mcp/dist/main.js

Add it to an MCP client:

{
  "mcpServers": {
    "dsh-doc": {
      "command": "node",
      "args": ["/absolute/path/to/dsh-doc-editor/apps/mcp/dist/main.js"],
      "env": {
        "DSH_DOC_WORKSPACE": "/absolute/path/to/document-workspace"
      }
    }
  }
}

CLI

node apps/cli/dist/main.js info fixtures/docx_docs_renderer_feature_test_cases.docx
node apps/cli/dist/main.js render fixtures/docx_docs_renderer_feature_test_cases.docx --format pdf --out out/fixture.pdf
node apps/cli/dist/main.js verify fixtures/docx_docs_renderer_feature_test_cases.docx
node apps/cli/dist/main.js roundtrip fixtures/docx_docs_renderer_feature_test_cases.docx

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines
  1. {
  2. "name": "dsh-doc",
  3. "owner": {
  4. "name": "ahmadfarizoffice-dotcom"
  5. },
  6. "metadata": {
  7. "description": "Document engine plugins for Claude Code: read, edit, convert and export DOCX/Pages/DOC/ODT/RTF/HTML/Markdown documents through the dsh-doc MCP server."
  8. },
  9. "plugins": [
  10. {
  11. "name": "dsh-doc",
  12. "source": "./integrations/claude-code",
  13. "description": "Document tools, skills and slash commands backed by the dsh-doc MCP server (50 document_* tools, resources and prompts).",
  14. "version": "1.0.0",
  15. "author": {
  16. "name": "ahmadfarizoffice-dotcom"
  17. },
  18. "homepage": "https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor",
  19. "repository": "https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor",
  20. "license": "MIT",
  21. "keywords": ["documents", "docx", "pages", "pdf", "mcp", "conversion"]
  22. }
  23. ]
  24. }
README.md · README · 258 lines
  1. # DSH Document Engine (`dsh-doc-editor`)
  2. A universal document platform: a Word/Google-Docs-style editor, an independent
  3. layout and rendering engine, a conversion engine, and a programmable document
  4. service exposed through MCP, native agent tools and reusable skills.
  5. The whole platform operates on **one versioned, format-independent document
  6. model**. The editor, renderer, converter, AI assistant and MCP server are all
  7. clients of that model — there is no second parser, no HTML-only shortcut and no
  8. duplicated business logic.
  9. ```
  10. ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
  11. │ Editor UI │ │ MCP server │ │ Agent tools│ │ CLI │
  12. └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘
  13. └───────────────┴───────────────┴───────────────┘
  14. │ DocumentService (single API)
  15. ┌───────────────┼───────────────┬───────────────┐
  16. ┌─────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
  17. │ Document │ │ Layout │ │ Conversion │ │ AI assistant│
  18. │ model+ops │ │ engine │ │ engine │ │ (providers) │
  19. └─────┬──────┘ └──────┬──────┘ └──────┬──────┘ └─────────────┘
  20. │ │ │
  21. ┌─────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
  22. │ OOXML │ │ HTML / SVG │ │ HTML, MD, │
  23. │ DOCX import│ │ PDF │ │ TXT, RTF, │
  24. │ / export │ │ renderers │ │ ODT adapters│
  25. └────────────┘ └─────────────┘ └─────────────┘
  26. ```
  27. ## Quick start
  28. Requirements: **Node.js ≥ 22** and **pnpm** (the repository pins
  29. `packageManager: pnpm@11.28.5`).
  30. ```bash
  31. pnpm install
  32. pnpm run build # core library, MCP server, CLI, web editor
  33. pnpm test # unit + integration + fixture + MCP protocol tests
  34. ```
  35. ### Editor
  36. ```bash
  37. pnpm run web:dev # Vite dev server (http://127.0.0.1:5173, proxies /api to :4317)
  38. # or, after a build:
  39. pnpm run web:start # serves the built UI + HTTP API on :4317 (PORT overrides)
  40. ```
  41. The editor is model-first: typing, formatting, lists, tables, images, comments
  42. and AI applications are all translated into deterministic document operations,
  43. so undo, auditing and import/export see exactly the same document.
  44. ### MCP server (stdio)
  45. ```bash
  46. pnpm run mcp:start
  47. # equivalent: node apps/mcp/dist/main.js
  48. ```
  49. Add it to an MCP client:
  50. ```json
  51. {
  52. "mcpServers": {
  53. "dsh-doc": {
  54. "command": "node",
  55. "args": ["/absolute/path/to/dsh-doc-editor/apps/mcp/dist/main.js"],
  56. "env": {
  57. "DSH_DOC_WORKSPACE": "/absolute/path/to/document-workspace"
  58. }
  59. }
  60. }
  61. }
  62. ```
  63. ### CLI
  64. ```bash
  65. node apps/cli/dist/main.js info fixtures/docx_docs_renderer_feature_test_cases.docx
  66. node apps/cli/dist/main.js render fixtures/docx_docs_renderer_feature_test_cases.docx --format pdf --out out/fixture.pdf
  67. node apps/cli/dist/main.js verify fixtures/docx_docs_renderer_feature_test_cases.docx
  68. node apps/cli/dist/main.js roundtrip fixtures/docx_docs_renderer_feature_test_cases.docx
  69. ```
  70. ## Install as an agent plugin (no build)
  71. ### DeepSeek Harness
  72. Paste this into **Plugins → Add plugin** (verified on DSH `0.2.2-rc.3`):
  73. ```text
  74. https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor-plugin
  75. ```
  76. The bundle is self-contained (the engine is inlined, no dependencies, no install
  77. scripts) and adds a **Documents panel** — a real Word-like editor with the seven
  78. tabs **File · Home · Insert · Design · Layout · References · View**, icon-only
  79. commands with hover tooltips, native folder/file pickers that open a document as
  80. a workspace plus chat session, and 26 `document_*` tools. Agent equivalent:
  81. ```text
  82. plugin_manager action: install_bundle target: github:ahmadfarizoffice-dotcom/dsh-doc-editor-plugin
  83. ```
  84. ![Documents panel inside DeepSeek Harness](docs/screenshots/dsh-panel-editor.png)
  85. After installing or updating the bundle, reload the Harness page (and restart
  86. the runtime if the panel still shows the previous version) so the browser loads
  87. the new client module.
  88. Source: [`dsh-plugin/`](dsh-plugin) in this repository; published from
  89. [dsh-doc-editor-plugin](https://github.com/ahmadfarizoffice-dotcom/dsh-doc-editor-plugin).
  90. ### Claude Code
  91. ```text
  92. /plugin marketplace add ahmadfarizoffice-dotcom/dsh-doc-editor
  93. /plugin install dsh-doc@dsh-doc
  94. ```
  95. The plugin lives in [`integrations/claude-code`](integrations/claude-code)
  96. (MCP server launch, the 12 skills, and slash commands). A plain `.mcp.json` is
  97. included for projects that do not use plugins.
  98. ### Codex CLI, Google Antigravity, OpenCode
  99. Ready-made configs and installers live in [`integrations/`](integrations):
  100. `codex/config.toml` plus an idempotent `install.mjs`, `antigravity/mcp_config.json`,
  101. and `opencode/opencode.json` with an optional 3-tool plugin. All of them launch
  102. the same MCP server; see [INSTALL.md](INSTALL.md) for exact paths and the
  103. absolute-path placeholders you must fill in.
  104. ### Standalone editor
  105. `pnpm run web:start` serves the editor at `http://127.0.0.1:4317`.
  106. #### Editor skins
  107. The same document, selection and undo history render under four faithful
  108. chrome styles; the skin is presentation only and never touches the model:
  109. | Skin | What it reproduces |
  110. | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
  111. | **Google Docs** (`gdocs`, default) | white app bar with document glyph and File/Edit/View menus, compact formatting bar, share pill and avatar, blue-gray canvas, floating page/word pill |
  112. | **Microsoft Word** (`word`) | blue title bar with search, ribbon tabs and labelled groups, ruler, gray workspace, status bar with page/word count, language, zoom and view icons |
  113. | **Apple Pages** (`pages`) | light top bar with centred inline title, slim toolbar, Format inspector, warm canvas, page indicator |
  114. | **LibreOffice Writer** (`writer`) | menu bar, standard + formatting toolbars, gray canvas with ruler, sidebar deck, status bar with page style and insert mode |
  115. Switch skins from the skin menu in each app bar; the choice persists in
  116. `localStorage` (`dsh-doc:skin`). `?skin=word` (or `pages`, `writer`, `gdocs`)
  117. overrides it for a session without persisting. Controls whose backend is not
  118. implemented are rendered disabled with an explanation rather than as dead
  119. buttons.
  120. | Google Docs | Microsoft Word |
  121. | ----------------------------------------------- | ------------------------------------------------------- |
  122. | ![Google Docs skin](docs/screenshots/gdocs.png) | ![Microsoft Word skin](docs/screenshots/word.png) |
  123. | **Apple Pages** | **LibreOffice Writer** |
  124. | ![Apple Pages skin](docs/screenshots/pages.png) | ![LibreOffice Writer skin](docs/screenshots/writer.png) |
  125. ## The golden fixture
  126. `fixtures/docx_docs_renderer_feature_test_cases.docx` (the supplied acceptance
  127. fixture) is part of the test suite:
  128. ```bash
  129. pnpm run test:fixture # import, structure, layout/pagination, render, round-trip
  130. ```
  131. Current result on the fixture: **3 sections** (Letter portrait, A4 landscape,
  132. A4 portrait), **310 paragraphs**, **5 tables**, header/footer on every section,
  133. page-number field resolved, 8 rendered pages, and a **byte-identical text
  134. round-trip** through `DOCX → model → DOCX → model`.
  135. The fixture's written checklist covers more cases than the file physically
  136. contains (it describes images, footnotes, comments, tracked changes, equations
  137. and text boxes but embeds none of them). We therefore also ship an **extended
  138. fixture** generated from real OOXML that adds those constructs — see
  139. [TESTING.md](TESTING.md#the-fixture-family).
  140. ## What is implemented
  141. | Area | Status |
  142. | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
  143. | DOCX / DOTX / DOCM import + export (round-trip) | ✅ implemented, fixture-verified |
  144. | Shared document model with versioning, unknown-element preservation | ✅ |
  145. | Deterministic editing operations (text, formatting, lists, tables, sections, images, notes, comments, revisions, TOC, equations) | ✅ |
  146. | Layout engine (pagination, line breaking, tables, floats, headers/footers, footnotes, columns) | ✅ |
  147. | HTML, SVG and PDF renderers over the layout model | ✅ |
  148. | Conversion engine with capability matrix and loss reports | ✅ (adapters vary — see matrix) |
  149. | MCP server: 50 tools, 8 resources, 8 prompts, typed schemas | ✅ |
  150. | Native agent tool definitions (JSON Schema) | ✅ |
  151. | Reusable skills (12) | ✅ |
  152. | Editor UI (formatting, tables, images, comments, find/replace, outline, AI panel, print preview) | ✅ |
  153. | AI assistant (Ask / Suggest / Edit), provider independent | ✅ with provider caveats |
  154. | PDF **import** | ❌ not supported (documented) |
  155. | Google Drive / Google Docs API integration | ❌ not implemented (DOCX/HTML interoperability only) |
  156. | Macro execution, script execution, external entity resolution | ❌ never performed (by design) |
  157. Full detail: [FEATURES.md](FEATURES.md) · [SUPPORTED_FORMATS.md](SUPPORTED_FORMATS.md) · [ARCHITECTURE.md](ARCHITECTURE.md).
  158. ## Repository layout
  159. ```
  160. packages/core/src/
  161. model/ versioned document model + deterministic operations
  162. docx/ OOXML import/export (DOCX, DOTX, DOCM)
  163. formats/ HTML, Markdown, TXT, RTF, ODT, legacy DOC, Apple Pages, XLSX/PPTX preview
  164. layout/ pagination and line/table/float layout (font metrics included)
  165. render/ HTML, SVG, PDF renderers
  166. convert/ conversion engine: capability matrix, fidelity, loss reports
  167. service/ workspace, sessions, history, auditing, the unified API
  168. ai/ provider independent assistant (openai-compatible, ollama, offline)
  169. tools/ tool/resource/prompt registry shared by MCP and agents
  170. apps/
  171. web/ editor UI (React + Vite) and HTTP API server
  172. mcp/ Model Context Protocol server (stdio)
  173. cli/ `dsh-doc` command line interface
  174. dsh-plugin/ DeepSeek Harness bundle (Host tools + Documents panel + client half)
  175. integrations/ Claude Code, Codex, Antigravity and OpenCode packages
  176. skills/ 12 agent skills with routing and safety guidance
  177. fixtures/ golden DOCX fixtures and the extended acceptance fixture
  178. test/ fixture, render and round-trip acceptance tests
  179. ```
  180. ## Documentation
  181. - [INSTALL.md](INSTALL.md) — plugin install for DSH, Claude Code, Codex, Antigravity, OpenCode and the standalone editor
  182. - [ARCHITECTURE.md](ARCHITECTURE.md) — components, data flow, invariants, decisions
  183. - [FEATURES.md](FEATURES.md) — implemented feature inventory and honest status
  184. - [SUPPORTED_FORMATS.md](SUPPORTED_FORMATS.md) — import/export matrix and fidelity notes
  185. - [MCP.md](MCP.md) — tools, resources, prompts, security, configuration
  186. - [AGENT_SKILLS.md](AGENT_SKILLS.md) — skills inventory, routing, integration
  187. - [TESTING.md](TESTING.md) — fixture procedure, test suite, CI, regression policy
  188. - [AGENTS.md](AGENTS.md) — short agent-facing entry point
  189. - [CONTRIBUTING.md](CONTRIBUTING.md) — workflow, adding adapters/tools/skills
  190. - [SECURITY.md](SECURITY.md) — threat model and reporting
  191. ## Configuration
  192. Copy `.env.example` to `.env` and adjust. Nothing sensitive is committed.
  193. | Variable | Purpose |
  194. | ----------------------------------- | ------------------------------------------------- |
  195. | `DSH_DOC_WORKSPACE` | Workspace root for documents and audit log |
  196. | `DSH_DOC_READ_ONLY` | `1` disables all mutations |
  197. | `DSH_DOC_AUDIT_LOG` | Audit log path (JSON Lines) |
  198. | `DSH_DOC_ALLOWED_ROOTS` | Extra readable roots (path-delimited) |
  199. | `DSH_DOC_AI_PROVIDER` | `offline` \| `openai` \| `ollama` (default: auto) |
  200. | `DSH_DOC_AI_MODEL` | Model id for the selected provider |
  201. | `OPENAI_API_KEY`, `OPENAI_BASE_URL` | OpenAI-compatible endpoint |
  202. | `OLLAMA_HOST` | Local Ollama endpoint |
  203. | `PORT` | Web server port |
  204. ## License
  205. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.