Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.swisstools.dev/llms.txt

Use this file to discover all available pages before exploring further.

Before Swisstools can generate release notes, it needs access to your GitHub account and at least one repository. The setup takes two steps: authorize GitHub OAuth so Swisstools can read your account, then connect the specific repositories you want to include.

​
Connect GitHub and add repositories

1

Authorize GitHub OAuth

  1. Open your project and go to the Release section.
  2. Click the GitHub Repos tab.
  3. Click Connect with GitHub.
  4. GitHub opens an authorization screen — review the requested permissions and click Authorize.
  5. You are redirected back to your project with GitHub connected.
2

Connect a repository

  1. Click Connect a Repository.
  2. Select the organization or personal account that owns the repository.
  3. Browse the list and click the repository you want to connect.
  4. Click Connect Repository to confirm.
You can connect multiple repositories to a single project. When you generate a release, Swisstools fetches commits from all connected repositories within the selected date range.
3

Generate a release

  1. Go to the Releases tab.
  2. Click the + button to open the Generate Release dialog.
  3. Choose a From date and a To date — commits in that window are analyzed.
  4. Click Generate.
The release appears in the list immediately with a Processing status. Swisstools fetches commits from your connected repositories, reads the commit messages and diffs, and uses AI to produce structured Markdown release notes. When generation finishes, the status changes to Draft and the content is ready for you to review.
You must connect at least one repository before you can generate a release. If no repositories are connected, the Generate Release dialog will not proceed.

​
Disconnect GitHub

To remove Swisstools’ access to your GitHub account, go to the GitHub Repos tab and click Disconnect. This removes the OAuth connection and unlinks all connected repositories. You will need to go through the authorization flow again if you want to add repositories in the future. Removing an individual repository from the list without disconnecting GitHub does not affect your OAuth authorization — only that specific repo is removed from the project.