{
  "markdown": "\n\n<p align=\"center\">\n  <a href=\"https://tldiagram.com\">\n    <img src=\"./frontend/logo/tld.svg\" alt=\"Logo\" width=\"200\">\n  </a>\n</p>\n\n<p align=\"center\">\n<img width=\"900\" height=\"900\" alt=\"explore\" src=\"https://github.com/user-attachments/assets/4a85bdda-b51f-4c4f-946f-30ba5dacd26a\" />\n</p>\n\n\n`tld` is an opinionated, flexible diagramming tool with rich featureset to help you visualize, understand, and maintain your software architecture. Inspired by C4 model, designed with multiple opt-in features to answer evolving needs of software teams. \n\n<p align=\"center\">\n  <a href=\"https://go.dev/\"><img src=\"https://img.shields.io/github/go-mod/go-version/mertcikla/tld\" alt=\"Go Version\"></a>\n  <a href=\"./LICENSE\"><img src=\"https://img.shields.io/github/license/mertcikla/tld\" alt=\"License\"></a>\n  <a href=\"https://github.com/mertcikla/tld/actions\"><img src=\"https://img.shields.io/github/actions/workflow/status/mertcikla/tld/test.yml?branch=main\" alt=\"Build Status\"></a>\n  <a href=\"https://goreportcard.com/report/github.com/mertcikla/tld\"><img src=\"https://goreportcard.com/badge/github.com/mertcikla/tld\" alt=\"Go Report Card\"></a>\n  <a href=\"https://deepwiki.com/Mertcikla/tld\"><img src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"></a>\n</p>\n\n\n## Highlights\n\n- **UI**: A frontend optimized to handle complex architectures, with intuitive design and polished with tools to manage contextual views.\n- **Standalone Distribution**: A single, dependency-free binary containing both the server and the web application. Available as CLI + WebUI or Native app(windows and macOS).\n- **CLI that speaks agent**: Use the [agent skill](./skills/create-diagram/SKILL.md) and use your agent to create a diagram of your codebase with the exact detail level you need. Prompt the agent to add/remove details you see fit. \nHere are some examples that were generated using the agent skill.\n\n  - [Kubernetes](https://tldiagram.com/app/explore/shared/827bc17d-7d9b-411f-9d03-179fab99bcbd)\n\n  - [pytorch](https://tldiagram.com/app/explore/shared/abc56a26-3e20-4235-90fa-e045b2b2ac74)\n \n  - [kafka](https://tldiagram.com/app/explore/shared/9d415d7f-b91f-47c0-9dc7-756de2860695)\n\n  - [.NET eShop reference](https://tldiagram.com/app/explore/shared/ba6cbf2a-e0ff-468a-87e5-f720d35f448d)\n\n- **Editor and Github Integration**: Jump to the code in your editor or Github from diagrams, or open the code symbol in diagram from your editor to visualize the code using the [VSCode extension](https://marketplace.visualstudio.com/items?itemName=tlDiagram-com.tldiagram). \n- **Mermaid Integration**: Paste your mermaid diagrams into canvas to import them or export as mermaid for quick sharing.\n- **Markdown Notes Support**: Add notes and documentation for your diagram or link an existing one, preview and edit diagrams and markdown side-by-side. \n- **Mermaid Integration**: Easily sync your diagrams with mermaid blocks in a markdown file for portable viewing in any markdown viewer. [Link to docs](https://tldiagram.com/docs/ui/mermaid/)\n- **Bi-directional Sync**: (Experimental) Seamlessly sync changes between your local YAML files, the self-hosted web UI, and the cloud version at tlDiagram.com.\n- **Git diff visualization**: (Experimental) Sync and visualize the changes you or your agent are making live in diagram form. Inspect the dependencies and intervene when necessary.\n- **Diagrams as Code**: (Experimental) A git/terraform like workflow (`plan`/`apply`) to manage architectural evolution alongside your source code.\n- **Automated Codebase Analysis**: (Experimental) Built-in tree-sitter integration to automatically discover architecture components in Go, Java, Python, C++, and TypeScript (more soon™ (hopefully)).\n\n<p align=\"center\">\n<img width=\"1280\" height=\"882\" alt=\"editor\" src=\"https://github.com/user-attachments/assets/4ee283b0-ee45-4a04-86e4-f477c26e9977\" />\n</p>\n\n\n## Quick Start\n\nmacOS and Linux\n```bash\ncurl -LsSf https://tldiagram.com/install.sh | sh -s serve --open\n```\n\nWindows\n```powershell\npowershell -ExecutionPolicy ByPass -c \"irm https://tldiagram.com/install.ps1 | iex; tld serve --open\"\n```\n\n## Documentation\n\nVisit [docs](https://tldiagram.com/docs) for more info.\n\n\n## Deployment & Self-Hosting\n\ntld has native-desktop builds for macOS and windows. Look for tld-desktop binaries in releases.\n\n\n\n`tld` designed to be run fully offline, behind a reverse-proxy or in your infrastructure or as a local development tool.\n\nRun `tld serve` to start a local SQLite-backed instance, or configure PostgreSQL in `~/.config/tldiagram/tld.yaml` or via env vars\n\n```bash\nexport TLD_DB_DRIVER=postgres\nexport TLD_DATABASE_URL='postgres://user:pass@postgres:5432/tld?sslmode=require'\nexport TLD_PUBLIC_URL='https://example.com'\nexport TLD_HOST=127.0.0.1\nexport PORT=8060\n\ntld serve\n```\n\nThe PostgreSQL database must have `pgvector` support.\n\n## Mobile \n\nThere are Mobile apps available in both [App Store](https://apps.apple.com/us/app/tldiagram/id6760236883) and [Play Store](https://play.google.com/store/apps/details?id=com.mertcikla.tldiagram) they are mostly cloud-oriented and free but require [tldiagram.com](https://tldiagram.com) account. They are good for quickly checking stuff on-the-go, small screens are hard for full featured diagram authoring but they still received some development effort and attention to make authoring possible on mobile. \n\n## Commands Reference \n`tld --help`\n\nor \n\nUse `tld [command] --help` for more information about a command\n",
  "bytes": 5464,
  "sha": "05b7c852a540d4733935f082848427258ff61759289c505294d98b15f4c3ecd4",
  "repo_slug": "mertcikla/tld",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mertcikla_tld_0fcce3b9/readme"
}