Tags
The Tags tab is a singleton tab for managing git tags — both lightweight and annotated.
Tag List
Tags are displayed in a filterable, sortable list. Each tag row shows:
- Tag name with icon
- Commit hash (clickable — opens the Commit tab)
- Remote status badge — pushed (green), diverged (warning), local (gray), or a Push button
- Delete button
Annotated tags can be expanded to show the tagger name, creation date, and full message.
Toolbar
| Control | Purpose |
|---|---|
| Sort | Sort by date (newest/oldest) or name (A–Z / Z–A) |
| Annotations | Toggle display of tag annotations |
| Filter | Search tags by name |
Creating Tags
Press N or use the create button. The dialog provides:
- Tag name — validated against git ref rules, with a suggested next semver version
- Message — optional; providing one creates an annotated tag, leaving it empty creates a lightweight tag
- Replace existing — overwrite a tag with the same name
- Push to remote — push immediately after creation
Deleting Tags
Deleting a tag that exists on the remote shows a scope dialog:
- Delete local and remote (default)
- Delete local only
- Delete remote only
Local-only tags are deleted immediately.
Pushing Tags
Tags with a “local” status can be pushed to the remote. Diverged tags can be force-pushed or re-fetched from the remote.
Pruning Tags
Remove local tags that no longer exist on the remote with the prune action.
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| N | Create new tag |
| Delete | Delete selected tag |
| Ctrl+A | Select all tags |
Context Menu
Right-click a tag for options including force push, re-fetch, copy tag name, copy commit hash, view commit, and delete.