Skip to content

Tuskway for GitHub Issues

GitHub issues that start from a reviewed plan.

If your team already lives in GitHub, your tickets should too. Tuskway keeps the plan for each feature, reviewed line by line, and publishes its tickets to the repository's issues. The pull request an agent opens then points at an issue that has a real brief behind it.

What changes

What GitHub Issues gets from Tuskway.

  • Installed as a GitHub App

    You choose the account or organisation and the repositories. Tuskway stores the installation, not a token tied to one person's GitHub account, and asks GitHub for a short-lived token only when it needs to call GitHub.

  • Issues, labels and status in step

    Each ticket becomes an issue. Labels are created when they are missing. Closing the issue or moving the ticket updates the other side.

  • Edits are flagged, not lost

    Change an issue's title or description on GitHub and Tuskway shows the difference next to the brief. An editor decides which version wins.

How it works

From a reviewed plan to GitHub Issues.

  1. 01

    A workspace owner installs the Tuskway GitHub App from the Trackers page and picks the repositories.

  2. 02

    On an epic, pick the repository to publish to.

  3. 03

    Publish. Each ticket brief becomes an issue, and the issue number is written into the design index.

  4. 04

    An agent runs /tackle-ticket, opens a pull request, and the ticket moves to review in Tuskway. The GitHub issue stays open until the ticket is done.

FAQ

GitHub Issues questions.

Does the GitHub App get access to our code?

Tuskway does not read your source code. The app is used to list repositories, create and update issues, and receive issue changes.

Can different epics publish to different repositories?

Yes. The repository is chosen per epic, among those on your installation.

What if we disconnect?

Tuskway stops reading and updating issues. The issues already published stay on GitHub.

Publish to GitHub Issues from a plan your team agreed on.

Connecting a tracker is optional. Tuskway never needs access to the code.