{"id":49234301,"url":"https://github.com/mertcikla/tld","last_synced_at":"2026-05-31T01:00:31.535Z","repository":{"id":353398395,"uuid":"1219018593","full_name":"Mertcikla/tld","owner":"Mertcikla","description":"Software architecture diagramming tool. Includes a modern easy to use Frontend + Backend + CLI to enable managing diagrams from the shell or in CI.","archived":false,"fork":false,"pushed_at":"2026-05-24T10:13:03.000Z","size":44664,"stargazers_count":8,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T10:21:32.015Z","etag":null,"topics":["agent-skill","c4model","claude-code-plugin","diagram","diagramming-as-code","diagramming-tool","drawio","excalidraw","gemini-cli-extension","gliffy","icepanel","lucidchart","mermaid","miro","reactflow","structurizr"],"latest_commit_sha":null,"homepage":"https://tldiagram.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mertcikla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-23T12:55:32.000Z","updated_at":"2026-05-24T08:42:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"d56480fa-be3e-406b-90e4-1d72be4d532b","html_url":"https://github.com/Mertcikla/tld","commit_stats":null,"previous_names":["mertcikla/tld"],"tags_count":51,"template":false,"template_full_name":null,"purl":"pkg:github/Mertcikla/tld","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mertcikla%2Ftld","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mertcikla%2Ftld/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mertcikla%2Ftld/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mertcikla%2Ftld/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mertcikla","download_url":"https://codeload.github.com/Mertcikla/tld/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mertcikla%2Ftld/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33715211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skill","c4model","claude-code-plugin","diagram","diagramming-as-code","diagramming-tool","drawio","excalidraw","gemini-cli-extension","gliffy","icepanel","lucidchart","mermaid","miro","reactflow","structurizr"],"created_at":"2026-04-24T14:04:44.273Z","updated_at":"2026-05-31T01:00:31.528Z","avatar_url":"https://github.com/Mertcikla.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://tldiagram.com\"\u003e\n    \u003cimg src=\"./frontend/logo/tld.svg\" alt=\"Logo\" width=\"200\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\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\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://go.dev/\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/mertcikla/tld\" alt=\"Go Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/mertcikla/tld\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/mertcikla/tld/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/mertcikla/tld/test.yml?branch=main\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/mertcikla/tld\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/mertcikla/tld\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://deepwiki.com/Mertcikla/tld\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"1280\" height=\"882\" alt=\"editor\" src=\"https://github.com/user-attachments/assets/4ee283b0-ee45-4a04-86e4-f477c26e9977\" /\u003e\n\u003c/p\u003e\n\n\n## Highlights\n\n- **UI**: A frontend optimized to handle complex architectures while attempting to intelligently show and hide details.\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**: Copy 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 with rich UI. \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\u003cp align=\"center\"\u003e\u003cimg width=\"1280\" height=\"720\" alt=\"explore\" src=\"https://github.com/user-attachments/assets/0b194071-d411-449a-87bd-2d4883e9c354\" /\u003e\n\n\n\u003c/p\u003e\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## Deployment \u0026 Self-Hosting\n\n`tld` designed to be run fully offline, behind a reverse-proxy or in your infrastructure or as a local development tool.\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://app.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\nRun `tld serve` without PostgreSQL settings to start a local SQLite-backed instance.\n\n### Configuration\nVarious configuration options are available in `~/.config/tldiagram/tld.yaml`\n\n# Documentation\n\nVisit [docs](https://tldiagram.com/docs) for more info.\n\n## Commands Reference \n`tld --help`\n\n```text\nUsage:\n  tld [command]\n\nCRUD actions on resources:\n  add         Add or update an element in elements.yaml\n  connect     Add a connector between two elements\n  remove      Remove workspace resources\n  rename      Rename an element in elements.yaml\n  update      Update a resource field with a value\n\nSecondary actions:\n  analyze     Extract symbols from source files and upsert them as workspace elements\n  apply       Apply plan to the tldiagram.com\n  check       Check workspace health and diagram freshness\n  completion  Generate the autocompletion script for the specified shell\n  diff        Show differences between local workspace and server\n  export      Export all diagrams from an organization to the local workspace\n  help        Help about any command\n  init        Initialize a new tld workspace\n  login       Authenticate the CLI with a tlDiagram server\n  plan        Show what would be applied\n  pull        Pull the current server state into local YAML files\n  render      Render a workspace view to text output formats\n  serve       Start the local tlDiagram web server\n  status      Show running local tlDiagram processes\n  stop        Stop the local tlDiagram web server\n  sync        Inspect and reconcile workspace sync state\n  validate    Validate the workspace YAML files\n  version     Print the version number of tld\n  views       Show derived view structure for the workspace\n\nFlags:\n      --compact            compact JSON output (no whitespace)\n      --format string      output format: text or json (default \"text\")\n  -h, --help               help for tld\n  -v, --version            version for tld\n  -w, --workspace string   workspace directory (prefers .tld, then tld; empty when neither exists)\n\nUse \"tld [command] --help\" for more information about a command\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmertcikla%2Ftld","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmertcikla%2Ftld","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmertcikla%2Ftld/lists"}