diffmap Aims to Help Coding Agents Explain Code Changes Visually

diffmap is an open-source agent skill designed to help coding agents explain code changes visually through interactive diagrams and specs. It allows an agent to create specifications with diagrams where individual elements link back to source code files.

Core Features and Operation

• Visual Explanations: The skill lets agents generate specs using service diagrams, Mermaid diagrams, and call stacks to depict code changes.
• Source Linking: Diagram components and call stacks can link directly to files, line ranges, or specific Git commits.
• Local and Hosted Viewing: Specs are served locally by default, or they can be shared as unlisted GitHub gists viewable on diffmap.dev.

Commands and Verification

• Validation: Users can check Markdown files, diagrams, and annotations without starting a server by running the validate command.
• Server Controls: The local server can be managed via the command line, with options to specify ports and workspace roots.
• Telemetry: The CLI sends anonymous usage data to PostHog, which can be disabled using environment variables such as `DIFFMAP_TELEMETRY=0` or `DO_NOT_TRACK=1`.

To verify the original announcement or review installation instructions, consult the official repository on GitHub or test the tool directly using the documented npx commands.