This action installs and runs treefmt on your repository.

Currently, if you run this action on a Windows-based runner, it will use the older treefmt version 0.6.1. This is because the newer versions of treefmt are not yet supported on Windows.

I would recommend using a Linux-based runner if you want to use the latest version of treefmt. I doubt you will need to run this action on Windows anyway, as it is intended for CI/CD pipelines.

This example is more or less taken from the test.yml workflow in this repo.

name: Format Code

on: [push, pull_request]

jobs:
  format:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    # setup some formatters
    - uses: biomejs/setup-biome@v2.2.1
    - uses: uncenter/setup-taplo@v1.0.8
    - name: Run treefmt
      uses: isbecker/treefmt-action@v2
      with:
        github-token: ${{ secrets.GITHUB_TOKEN }}
        version: 'latest'
        ci: true

Note that you need to set up the formatters you want to use before running treefmt. Many formatters are available as actions on the GitHub Marketplace.

Optional The version of treefmt to install. Default "latest".

Required GitHub token for accessing the API.

Optional Path to the treefmt configuration file. Default "treefmt.toml".

Optional Do not exit with error if a configured formatter is missing. Default "false".

Optional Run as if treefmt was started in the specified working directory instead of the current working directory. Default ".".

Optional Run treefmt in CI mode, which implies --no-cache, --fail-on-change, and a few other CI-friendly settings. Default "true".

Optional Ignore the evaluation cache entirely. Useful for CI. Default "false".

Optional Exit with error if any changes were made. Useful for CI. Default "false".

Optional Specify formatters to apply. Defaults to all formatters.

Optional The root directory from which treefmt will start walking the filesystem.

Optional File to search for to find the project root (if --tree-root is not passed).

Optional Command to execute for discovering the tree root. Useful when non-standard tooling determines the project root.

Optional The method used to traverse the files within --tree-root. Supports 'auto', 'git' or 'filesystem'. Default "auto".

Optional Set the verbosity of logs e.g. -vv. Default "false".

Optional Log paths that did not match any formatters at the specified log level. Default "info".

Optional Disable all logs except errors.

Optional Reset the evaluation cache; useful when you suspect the cache is stale.

Optional Exclude files or directories matching the supplied glob patterns.