# swark-io/swark

Create architecture diagrams from code automatically using large language models (LLMs).

Repository: https://github.com/swark-io/swark
Canonical: https://ross.abutalabs.com/products/swark
Homepage: https://swark.io
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: architecture, llm, system-design, visualization, vscode-extension, language-model, developer-tools
Last push: 2025-03-21T09:51:01+00:00

## Health v2 (maintenance only)
Score: 29/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 12, release rhythm 40, longevity 48
- inputs: {"age_days": 677, "days_push": 530, "days_rel": 530, "gap_med": 2, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1696, forks 106 (observed 2026-08-28T04:05:23.873125+00:00)

## What it is
Swark is a VS Code extension that automatically generates architecture diagrams from source code using large language models, integrated directly with GitHub Copilot. It outputs Mermaid.js diagrams that can be edited and refined, supporting all programming languages without additional API keys or setup.

## Use cases
- generate architecture diagrams from a codebase automatically
- understand an unfamiliar repository before onboarding
- visualize the structure of legacy code for refactoring
- review the architecture of AI-generated code
- keep documentation up to date with fresh architecture diagrams
- spot design flaws by visualizing dependency graphs

## When to choose
- you use VS Code with GitHub Copilot and want zero-setup diagram generation
- you need language-agnostic architecture visualization without per-language tooling
- you want Mermaid.js output you can edit and version in your docs

## When to avoid
- you need deterministic, precisely controlled diagrams rather than LLM-generated ones
- you don't use VS Code or GitHub Copilot
- your codebase can't be shared with GitHub Copilot due to privacy or compliance constraints

## Facets
- artifact type: plugin
- maturity: active
- function: documentation, data-visualization, developer-tools, llm-inference
- domain: developer-tools, documentation, web-development, large-language-models
- platform: editor-plugin, cross-platform
- tags: architecture-diagrams, vscode-extension, mermaid, github-copilot, diagram-as-code, code-visualization

## Member repositories
- swark-io/swark (main) score 29

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:23.873125+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:37:55.040108+00:00, confidence not recorded.
  - readme: https://github.com/swark-io/swark (fetched 2026-08-28T04:05:23.873125+00:00, sha edb2c3bd76fc)
- Data as of 2026-08-30T08:39:29.467469+00:00.