visual-docs

v1.12.3

Fully local visual plans and recaps with diagrams, rich diffs, live reload, and a browser feedback loop.

CodexClaude Code2 Skills

By Patrick D'appollonioLicense: MIT8 GitHub starsUpdated last week

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 2 skill or MCP entries
Source updated: Sep 17, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install visual-docs for Codex and Claude Code

Installs for the current user

codex plugin marketplace add patrickdappollonio/claude-plugins
codex plugin marketplace upgrade patrickdappollonio
codex plugin add visual-docs@patrickdappollonio

Paste and run these commands in a terminal with Codex. They add and refresh the patrickdappollonio catalog, then install this plugin.

Compatibility: the page URL and API slug “visual-docs” remain stable.

Codex: visual-docs@agent-plugin-marketplace → visual-docs@patrickdappollonio

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/patrickdappollonio/claude-plugins

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/visual-docs/.

Plugin files

plugins/visual-docs/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/visual-plan/SKILL.md
└── skills/visual-recap/SKILL.md

Included Skills2

visual-planskills/visual-plan/SKILL.md

Use when the user wants to review an implementation plan visually — "visual plan", "show me the plan in the browser", "render this plan" — or when a plan involves architecture, schema, or API changes worth reviewing before code is written. Writes the plan as markdown and serves it locally (bundled zero-dependency server) with Mermaid diagrams, rich diffs, DB migration cards, API call cards, live reload, and a comment feedback loop. Fully local; no remote services.

visual-recapskills/visual-recap/SKILL.md

Use when the user wants a visual summary of work that was done — "visual recap", "recap this PR/branch/commit visually", "show me what changed in the browser" — for a PR, branch, commit range, or uncommitted changes. Generates a markdown recap grounded in the real diff and serves it locally (bundled zero-dependency server) with Mermaid diagrams, annotated rich diffs, DB migration cards, API call cards, live reload, and a comment feedback loop. Fully local; no remote services.

Plugin manifests2

plugins/visual-docs/.codex-plugin/plugin.json

{
  "name": "visual-docs",
  "version": "1.12.3",
  "description": "Fully local visual plans and recaps with diagrams, rich diffs, live reload, and a browser feedback loop.",
  "author": {
    "name": "Patrick D'appollonio",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/patrickdappollonio/claude-plugins/tree/main/plugins/visual-docs",
  "license": "MIT",
  "keywords": [
    "visual-plan",
    "visual-recap",
    "markdown",
    "mermaid",
    "planning"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Visual Docs",
    "shortDescription": "Review plans and completed work visually.",
    "longDescription": "Creates local browser-based implementation plans and change recaps with diagrams, diffs, API cards, live reload, and comments.",
    "developerName": "Patrick D'appollonio",
    "category": "Productivity",
    "capabilities": [
      "Visualize",
      "Plan",
      "Review"
    ],
    "defaultPrompt": [
      "Show me a visual plan.",
      "Give me a visual recap of this change."
    ]
  }
}

plugins/visual-docs/.claude-plugin/plugin.json

{
  "name": "visual-docs",
  "description": "Fully local visual plans and recaps — the agent writes markdown, a bundled zero-dependency server renders it in your browser with Mermaid diagrams, rich diffs, styled DB migrations, API call cards, and a read-only OpenAPI view. Live reload plus a comment box that feeds your feedback back to the agent. No remote services, no accounts.",
  "version": "1.12.3",
  "author": {
    "name": "Patrick D'appollonio",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/patrickdappollonio/claude-plugins/tree/main/plugins/visual-docs",
  "license": "MIT",
  "keywords": [
    "visual-plan",
    "visual-recap",
    "markdown",
    "mermaid",
    "diff",
    "local-server",
    "planning"
  ]
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[visual-docs on Agent Plugins Marketplace](https://pluginsmp.com/plugins/visual-docs)