setup-tessl

A GitHub Action to use the Tessl CLI in your workflows

Usage

- uses: tesslio/setup-tessl@v2

Authentication

1. Create an API token in your workspace settings in the Tessl Web UI
2. Store the token as a repository or organization secret and reference it with ${{ secrets.TESSL_TOKEN }}.

- uses: tesslio/setup-tessl@v2
  with:
    token: ${{ secrets.TESSL_TOKEN }}

Once configured, all later steps in the same job can call the Tessl CLI as authenticated without any extra setup:

- run: tessl publish

Examples

Review a skill on pull request

This will trigger a review of a given skill, on pull request. You can optionally set a score threshold to ensure skills don't degrade over time.

name: Review
on: pull_request

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: tesslio/setup-tessl@v2
        with:
          token: ${{ secrets.TESSL_TOKEN }}
      - run: tessl skill review path/to/SKILL.md
      # Optionally gate on review score
      # - run skill review --threshold 80

Publish a tile on push

name: Publish
on:
  push:
    branches: [main]

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: tesslio/setup-tessl@v2
        with:
          token: ${{ secrets.TESSL_TOKEN }}
      - run: tessl tile publish

Publish multiple tiles

name: Publish
on:
  push:
    branches: [main]

jobs:
  publish:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        tile: [tiles/auth, tiles/payments, tiles/notifications]
    defaults:
      run:
        working-directory: ${{ matrix.tile }}
    steps:
      - uses: actions/checkout@v6
      - uses: tesslio/setup-tessl@v2
        with:
          token: ${{ secrets.TESSL_TOKEN }}
      - run: tessl tile lint
      - run: tessl tile publish

Pin a CLI version

- uses: tesslio/setup-tessl@v2
  with:
    version: "0.73.0"
    token: ${{ secrets.TESSL_TOKEN }}

Extensions

Community actions that build on top of setup-tessl:

Action	Description	How to use
tesslio/patch-version-publish	Publish tiles with automatic patch version bumping — queries the registry for the latest version, bumps patch, publishes, and commits the updated tile.json back. Respects manual version bumps.	Use instead of setup-tessl + tessl tile publish. It includes setup-tessl internally.

License

MIT

Supported Platforms

Runner	Platform
ubuntu-latest	linux-x64
ubuntu-24.04-arm	linux-arm64
Alpine-based	linux-x64-musl
Alpine-based ARM	linux-arm64-musl
macos-latest	darwin-arm64
macos-13	darwin-x64