What is tangleflow?

Tangleflow is a tool that converts workflow files between two formats: GitHub Actions and Tangled. You can think of a workflow file as a set of instructions that tells a code hosting platform what to do when certain events happen, like when someone submits new code. GitHub Actions is the automation system built into GitHub, while Tangled is a separate platform for managing code. Tangleflow translates between the two so you are not locked into either one. You can use it in two ways. The first is as a command-line tool that reads your existing workflow files and writes converted versions in the other format. You point it at specific files, or if you give it no files, it finds them automatically based on standard folder locations. Converting to Tangled reads from the standard GitHub workflows folder and writes to the Tangled one. Converting to GitHub does the reverse. When converting from GitHub Actions to Tangled, each independent job in your workflow becomes its own separate file. If jobs depend on each other, meaning one needs to finish before the next starts, those linked jobs combine into a single workflow where the steps run in the correct order. This preserves the logic of your original setup. The second way to use Tangleflow is as a library inside your own TypeScript or JavaScript program. After installing it through npm, you can call two functions. One takes a GitHub Actions workflow object and returns a Tangled pipeline. The other takes a Tangled workflow object and returns the GitHub Actions equivalent. This lets developers build conversion logic directly into their own applications. The project is written in TypeScript and has a small set of features focused on the conversion task. Its license is MIT, which allows broad use and modification.