Skip to content

Releases

The Releases tab is a singleton tab for managing GitHub releases.

Release List

Releases are displayed as cards showing:

  • Tag name and release name
  • Status badges — Draft, Pre-release, or Latest
  • Asset count with a download button
  • Author with avatar
  • Relative timestamp

Filtering

A status dropdown filters the list:

  • All releases
  • Published only
  • Drafts only
  • Pre-releases only
ShortcutAction
Arrow Up/Down or K/JNavigate releases
EnterOpen selected release

Release Detail

The Releases tab uses a master-detail layout. In split mode, clicking a release shows its detail inline within the tab. In list mode, clicking opens a separate detail tab in the adjacent pane. Ctrl+Click always opens a separate tab.

The detail view has two modes:

View Mode

  • Header — release name with action buttons (Edit, status toggles, Delete, Open on GitHub)
  • Meta row — tag name, status badges, author, and publication date
  • Body — rendered markdown release notes
  • Assets table — name, file size, download count, download button, and delete button
  • Source archives — auto-generated tar.gz and zip downloads

Edit Mode

  • Title input
  • Release notes with edit/preview tabs
  • Pre-release and Draft checkboxes
  • Save and Cancel buttons

Status Actions

  • Publish — convert a draft to a published release
  • Promote — mark as the latest release
  • Mark Pre-release — toggle pre-release status
  • Delete — remove the release (with confirmation)

Asset Management

Upload new assets with the upload button. Delete existing assets individually.

Creating Releases

Click New Release in the release list to open the creation form:

  • Tag input — validates against existing tags; shows a status indicator for new vs. existing tags
  • Target branch — shown only when creating a new tag
  • Release title
  • Release notes — edit/preview tabs with a Generate notes button that auto-generates notes from the commit history using the GitHub API
  • Pre-release checkbox
  • Publish or Save as Draft buttons

Context Menu

Right-click a release in the list for:

  • Open detail tab
  • Edit
  • Delete (with confirmation)
  • Open on GitHub

Auto-Refresh

The release list refreshes automatically via GitHub polling.