Gambuzin

Gambuzin Public Beta is a local-first VS Code extension for building, reviewing, synchronizing, and narrating software architecture from Mermaid documentation and AIR models.

What Gambuzin does

• Tracks supported Mermaid sequence, class, and state documentation.
• Creates and maintains editable AIR models while keeping acceptance explicit.
• Calculates canonical architecture from established models, including participants, messages, states, occurrences, and payload relationships.
• Reviews synchronization changes before applying them to documentation or AIR.
• Generates reviewed AsyncAPI contracts for messages with established payloads.
• Prepares snapshot-based technical narration through the bundled Gambuzin narration skill.
• Supports architecture-aware local and remote Git workflows.

Gambuzin keeps generated exports separate from canonical truth. API contracts and technical narration never replace source documentation, AIR models, canonical architecture, or payload relationships.

Requirements

• VS Code 1.90 or later
• A compatible .NET 9 runtime
• Git for Architecture Sharing operations
• A trusted local filesystem workspace

This release is intended for x64 Windows and Linux, and Apple Silicon (ARM64) macOS. Intel macOS, ARM64 Windows, ARM64 Linux, browser-hosted, remote, virtual, and restricted workspaces are not currently claimed as supported.

Privacy and network behavior

Gambuzin does not collect telemetry or analytics, and it does not send workspace content to a Gambuzin-operated service. Ordinary modelling, synchronization, export, and local Git operations stay on your machine.

Network access occurs only when you request an operation that needs it. Git remote operations use your installed Git client and the remote you configured. If you confirm creation of a merge request, Gambuzin contacts the Forgejo or GitLab service you configured and sends the reviewed branch, revision, title, description, and architecture-change information required for that request. Provider API tokens are stored in VS Code SecretStorage; they are not written to the workspace, Git, Gambuzin operation records, events, or logs.

Technical narration is an optional workflow performed by separately invoked AI tooling through the bundled skill. That tooling and its provider settings govern any data it processes; Gambuzin does not autonomously submit the narration package to an AI service.

Getting started

Open the Gambuzin view in the Activity Bar, then create, acquire, or open a workspace. The command palette also exposes the current Gambuzin commands, including Gambuzin: Open User Guide.

Public beta

This is prerelease software. Keep recoverable copies of important work and review every proposed architecture change before applying it. Dedicated support is not guaranteed for this free public beta.

Use Gambuzin: Show License to read the controlling license terms packaged with the extension.