Tangleflow: Converts GitHub Actions workflows to tangled workflows and back

Hacker News Top Tools

Summary

Tangleflow is a CLI and library that converts GitHub Actions workflows to tangled workflows and back, enabling developers to work with both formats.

No content available
Original Article
View Cached Full Text

Cached at: 07/24/26, 02:01 PM

43081j/tangleflow

Source: https://github.com/43081j/tangleflow

🪢 tangleflow

Converts GitHub Actions workflows into tangled workflows and vice versa.

Use it as a command-line tool to convert the workflow files in a repository, or as a library to convert parsed workflow objects in your own code.

Usage

npx tangleflow --target=<tangled|gh> [file...]
OptionDescription
--target=tangledConvert GitHub Actions workflows to tangled
--target=gh, --target=githubConvert tangled workflows to GitHub Actions

If no files are given, every workflow in the source directory is converted:

  • --target=tangled reads .github/workflows/*.{yml,yaml} and writes to .tangled/workflows/
  • --target=gh reads .tangled/workflows/*.{yml,yaml} and writes to .github/workflows/

When converting to tangled, each independent job becomes its own .tangled/workflows/<job>.yml file. Jobs linked by needs collapse into a single workflow whose steps run in dependency order.

Install (as a library)

npm install tangleflow

API

convertWorkflowToTangled(workflow)

Converts a parsed GitHub Actions workflow object into a tangled Pipeline (an array of workflows, one per GitHub job).

convertWorkflowToGitHub(workflow, path)

Converts a parsed tangled workflow object into a GitHub Actions workflow object.

License

MIT

Similar Articles

Tangle – Visual ML Pipeline Editor

Hacker News Top

Tangle is an open-source visual ML pipeline editor that enables collaborative building of machine learning workflows with drag-and-drop functionality, supporting any language or framework.