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
Navigation
| Shortcut | Action |
|---|---|
| Arrow Up/Down or K/J | Navigate releases |
| Enter | Open 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.