d2plugin-tala(1)	    General Commands Manual	      d2plugin-tala(1)

NAME
     d2plugin-tala – plugs into d2(1) to layout diagrams via TALA

SYNOPSIS
     d2plugin-tala [---version]

DESCRIPTION
     d2plugin-tala plugs into d2(1) to layout diagrams via TALA. TALA is a
     diagram layout engine designed specifically for software architecture
     diagrams, though it works well in other domains too. It stands for
     Terrastruct's Auto-Layout Approach.

     TALA is free to try and evaluate, but requires an API token to use
     without watermark. You can get an API token through your Terrastruct
     account, or purchase a standalone one at https://d2lang.com/buy-tala.

     You can set the API token as environment variable $TSTRUCT_TOKEN, or in
     the config authfile at ~/.config/tstruct/auth.json under the field
     api_token.

     The advantage to using ~/.config/tstruct/auth.json over $TSTRUCT_TOKEN is
     that d2plugin-tala will automatically update the api_token stored in the
     config authfile as your subscription renews.

     It does this by making a ping to Terrastruct's servers when your
     subscription is set to renew. For example, if you purchased a monthly
     subscription on January 1, d2plugin-tala will make a ping to Terrastruct
     servers when it's next run after February 1. The new renewal date will be
     written to your local authfile. The only data sent in this ping is the
     API token, and you can use TALA completely offline before the expiration.

     After 12 months of subscription, your copy of TALA is valid forever.

     We do give a grace period of 30 days in case of payment issues where only
     a warning is displayed. After the 30 days, d2plugin-tala reverts to
     evaluation mode.

     For further docs see:

     -	 https://github.com/terrastruct/TALA

     -	 https://terrastruct.com/tala

     Check out https://text-to-diagram.com for a comprehensive comparison
     against other layout engines and diagramming technologies.

SEE ALSO
     d2(1)

AUTHORS
     Terrastruct Inc.

Debian			       October 18, 2025				Debian