GHManage v0.7.0

GHManage 0.7.0

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

This release adds the last part of a repository GHManage could not show you: the
website it publishes.

GitHub Pages

Press Ctrl+0 on a repository that publishes a site and you get its publish
history — one row per publish, with whether it succeeded, the commit it came
from, who pushed it, and how long it took. The status bar carries the address the
site lives at, its current state, and the branch and folder it is published from.
The details panel adds the rest: whether HTTPS is enforced, any custom domain,
whether the site is public, whether it has a custom 404 page.

If the repository has no site, GHManage says so instead of showing you an empty
list you have to interpret.

Pages is on Ctrl+0 rather than in among the other repository views, because
slotting it into the middle would have shifted the number of every view below it.
The ones already in your fingers stay where they are.

Browsing the pages

From the publish history, Enter opens Published Pages — every file the site
serves, each listed with the address it is served at. Enter on one opens it in
your default browser. S opens the site's home page from either view, and
Backspace returns to the publish history. The Actions menu has Open Published
Site as well, enabled once a site is found.

F favorites a page the same as anything else, so a page you check often is one
keystroke away from any repository you happen to be in.

What the list can and cannot tell you

GitHub has no API that answers "what does this site serve", so GHManage works it
out from the branch the site publishes from. That is exact in the common cases
and an informed guess in two others, and the details panel tells you which one
you are looking at rather than leaving you to find out from a broken link.

Jekyll sites serve Markdown as HTML. A file stored as guide/setup.md is
served at guide/setup.html, and the address GHManage lists is the one that
works. A site with a .nojekyll file skips Jekyll and is served exactly as
committed, so the two match.

A site built by Actions is listed from its source, not its output. GitHub
publishes those through a workflow, and the workflow decides what actually ships
— possibly a subset of the files listed, possibly something it generated that is
not in the repository at all. For sites GitHub builds itself, the list is what is
served.

The publish history has the same split. Sites GitHub builds report a full build
log, with durations and the error message when one fails. Sites built by Actions
have no build log at all, so their history is read from their deployments
instead, which record a state but not a duration.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

This release is signed, so Windows can name the publisher rather than warning
about an unknown one. SmartScreen also weighs reputation, so a mild prompt may
persist for a while on a signing identity this new.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.6.3

GHManage 0.6.3

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

One bug fix, and it is the kind worth explaining.

A slow fetch can no longer land in the wrong view

Every list in GHManage is fetched on a background thread so the window stays
responsive. Nothing cancels a gh call once it has started, though, and until now
nothing checked whether the answer was still wanted when it arrived.

So if you selected a large repository and pressed Ctrl+8 before its issues
finished loading, the issues would arrive a few seconds later and fill the Labels
list anyway — a hundred blank rows sitting under the Label, Description, and
Colour headings, with a status bar cheerfully reporting "100 issues, 0 PRs". The
data was fine; it was simply being poured into the wrong container. Refreshing
fixed it, once you worked out what had happened.

This affected every view, not just Labels. The bigger the repository and the
faster you move, the easier it was to hit — which is to say it hit exactly the
people the app is built for.

Every list load now carries a token, and results whose token is stale are
discarded. A failed fetch in a view you have left no longer replaces the status
of the view you are looking at, and Go To Issue no longer inserts into a list
that is no longer on screen.

Everything else

No other changes. 0.6.2 turned on code signing; 0.6.1 added the Actions menu and
Ctrl+I / Ctrl+D.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

This release is signed, so Windows can name the publisher rather than warning
about an unknown one. SmartScreen also weighs reputation, so a mild prompt may
persist for a while on a signing identity this new.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.6.2

GHManage 0.6.2

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

This is the first signed release. The app itself is unchanged from 0.6.1.

No more "unknown publisher"

Every release until now was unsigned, so Windows met you at the door with a
SmartScreen warning: a blue box saying "Windows protected your PC" and an
"unknown publisher" line, with the button that actually installs the app hidden
behind More info. That was never a sign anything was wrong — it is what
Windows says about any program whose author it cannot identify — but "unknown
publisher" is a poor first impression, and telling people to click through a
security warning is a bad habit to teach.

GHManage-win-Setup.exe and the app's own binaries are now signed through Azure
Trusted Signing. Windows can name the publisher, and the first-run warning goes
away.

Two honest caveats:

• SmartScreen also weighs reputation, not just signature. A brand-new signing
  identity can still draw a milder warning until Microsoft has seen the
  certificate on enough installs. This gets better on its own; nothing to do.
• Signing does not reach backwards. 0.6.1 and earlier are still unsigned on
  the releases page. If you have one of those, updating to 0.6.2 is the fix.

Everything else

No functional changes. If you are coming from 0.6.0, the
0.6.1 notes cover
the Actions menu, Ctrl+I / Ctrl+D, and the label-key fixes.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.6.1

GHManage 0.6.1

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

0.6.0 added labels but hid the actions behind keys you had to find. This release
gives them a menu, better keys, and makes the ones that were already documented
actually work everywhere.

An Actions menu

Everything that acts on what the list is showing now lives in one menu, whichever
view it belongs to: open in browser, close, reopen, comment, create and delete
labels, delete a workflow run, run a workflow on a branch, download an artifact,
select a branch, compare branches.

Several of these were previously reachable only by pressing Enter on the right
row or by finding the right-click menu, which meant discovering them by accident.
Now there is one place to look.

The menu answers "what can I do here?" rather than listing everything and letting
you find out by trying. Entries are labelled for the current view and greyed out
where they do not apply — Delete reads "Delete Label…" in the Labels view and
"Delete Workflow Run…" in Workflow Runs, so the menu never offers a bare "Delete"
whose object you have to guess.

Ctrl+I and Ctrl+D

Insert is an awkward key — small, easy to miss, and missing outright on some
compact keyboards. It still works, but it is no longer the only way:

Key	Action
Ctrl+I or Insert	Create a label
Ctrl+D or Delete	Delete the selected label, or the selected workflow run

Ctrl+D follows the same rule as the menu: it deletes whatever the current view
can delete, and does nothing in views where nothing can be.

Insert and Delete now work from the details panel

The details panel for a label described Insert and Delete, but those keys only
worked while the list itself had focus. Reading the text put focus in the one
place the keys it described did nothing. They now work from anywhere in the
window, and the text says so. Delete in the Workflow Runs view gained the same
reach.

The label details panel now reads as a key list rather than a run of "press X to
Y" sentences, and names the label that Delete would remove.

Smaller fixes

• The status bar no longer advertises Ctrl+B=select branch in the Labels, Tags,
  Releases, and other lists. That key only works in Commits; everywhere else it
  answered "Select Branch is only available in Commits view."
• The Workflow Runs status bar and details panel now mention that Delete deletes
  a run — that has always worked, but nothing said so.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

Windows may show a SmartScreen "unknown publisher" warning until code signing is
switched on — choose More info → Run anyway.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.
  Creating and deleting labels needs write access to the repository, which is
  the same permission the GitHub website would ask of you.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.6.0

GHManage 0.6.0

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

This release adds labels: a view of them, a way to read a repository through
them, and the two actions that were missing.

Labels are a view now

Ctrl+8 lists the repository's labels by name, with their descriptions and
colours, the same way Ctrl+2 lists branches and Ctrl+5 lists releases. The
details panel below spells out the label, its description, its colour, and
whether it is one of the defaults GitHub creates with a repository.

Enter on a label reads the repository through it

Press Enter on a label and the Issues & PRs view comes back holding only the
issues and pull requests that carry it. Everything you already know still works
there — the state filter, the columns, the sort order, C to close, M to
comment — because it is the same view, not a new one.

The restriction is applied by GitHub, not by the quick filter, so it finds items
that were never on the page you were looking at. A repository with 800 open
issues will happily tell you the 6 tagged accessibility, and you never have to
press Ctrl++ to go looking for them.

While a label is on, the window title and the status bar both name it, so it is
never a mystery why the list is short. Backspace returns to the labels.
Ctrl+1 — asking for Issues & PRs by name — drops the label and shows
everything again.

Creating and deleting labels

In the Labels view, Insert creates one and Delete removes the selected one.
Right-click offers both, and File ▸ New Label… / Delete Label… reach them from
the menu bar.

A new label needs a name. The description and the colour are optional; leave the
colour blank and GitHub picks one, or give it six hex digits and GHManage checks
them before it asks GitHub for anything. The form labels every field for a
screen reader and opens with focus in the name box.

Deleting is the one that deserves a warning: a deleted label is stripped from
every issue and pull request that carries it, and GitHub offers no undo.
GHManage names the label and says so before it does anything, and does nothing
unless you answer yes.

Favorites moved to Ctrl+9

Labels took Ctrl+8 and Favorites moved down to Ctrl+9. The numbers follow the
order of the View ▸ View Mode menu and are printed next to each item there, which
is the whole point of them — so the menu still tells you the answer.

Key	View
Ctrl+1	Issues & PRs
Ctrl+2	Branches
Ctrl+3	Commits
Ctrl+4	Tags
Ctrl+5	Releases
Ctrl+6	Workflows
Ctrl+7	Workflow Runs
Ctrl+8	Labels
Ctrl+9	★ Favorites

A note on forks

On a fork, the labels come from the upstream repository — the same place the
fork's issues and pull requests come from, since forks have issues disabled.
That means the labels you see always match the issues you are reading.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

Windows may show a SmartScreen "unknown publisher" warning until code signing is
switched on — choose More info → Run anyway.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.
  Creating and deleting labels needs write access to the repository, which is
  the same permission the GitHub website would ask of you.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.5.0

GHManage 0.5.0

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

This release makes moving between the views of a repository a single keystroke.

Ctrl and a number switches views

A repository has a lot of faces — issues and PRs, branches, commits, tags,
releases, workflows, the runs of those workflows. Getting from one to another
meant walking the View menu into the View Mode submenu every time. Now each view
has a number:

Key	View
Ctrl+1	Issues & PRs
Ctrl+2	Branches
Ctrl+3	Commits
Ctrl+4	Tags
Ctrl+5	Releases
Ctrl+6	Workflows
Ctrl+7	Workflow Runs
Ctrl+8	★ Favorites

The numbers follow the order of the View ▸ View Mode menu and are shown next to
each item there, so there is nothing extra to memorize — the menu tells you. The
shortcuts work from anywhere in the window: the repository list, the item list,
or the details panel. You do not have to move focus first.

The status bar names the view as it loads, so the switch is confirmed out loud
rather than only appearing in the list. Every view except Favorites belongs to a
repository; press one of these with no repository selected and GHManage says
"Select a repository first" and stays where it is, instead of dropping you into
an empty list.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

Windows may show a SmartScreen "unknown publisher" warning until code signing is
switched on — choose More info → Run anyway.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.4.0

GHManage 0.4.0

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

This release fills in the last gap in running workflows from the app: workflows
that ask for input now ask you for it too.

Running a workflow with inputs

Many workflows take inputs — a target architecture, an environment to deploy to,
a flag to turn something on. GHManage could already start a workflow on the
branch of your choosing, but it always ran with whatever defaults the workflow
declared. There was no way to pick.

Now, when a workflow declares inputs, GHManage asks for them:

1. Choose the workflow and press R.
2. Pick the branch to run on.
3. If the workflow takes inputs, a form appears — one field per input, using the
   workflow's own descriptions as labels and its declared defaults as starting
   values.
4. Press Enter to run.

Each input gets the control that suits it. A list of allowed values becomes a
combo box, a true/false input becomes a checkbox, and everything else is a text
field. Required inputs will not let you continue while empty, and the message
names the field that needs filling in. Workflows with no inputs behave exactly as
before — you pick a branch and it runs, with nothing extra in the way.

The status bar reports what was started and with which values, so you can confirm
the run went out the way you intended without switching to the browser.

Every part of the form is keyboard-reachable and properly labelled: the fields
are generated on the fly from the workflow file, so each one is explicitly given
the name a screen reader reads, rather than being left to whatever the toolkit
would guess.

Also in this release

• A workflow that only mentions workflow_dispatch in a comment is no longer
  treated as manually runnable. GHManage used to offer the run and GitHub would
  reject it.
• The inputs are read from the branch you chose, not from the default branch. A
  branch that adds or changes an input now shows the right form — previously it
  would have shown the default branch's fields and quietly discarded anything you
  entered.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Help ▸
Check for Updates checks on demand and offers to restart.

Windows may show a SmartScreen "unknown publisher" warning until code signing is
switched on — choose More info → Run anyway.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

If you already have GHManage installed, you do not need to download anything —
this version will arrive on its own.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.3.0

GHManage 0.3.0

GHManage is a Windows desktop app for reading and managing your GitHub
repositories from a fast, keyboard-driven list.

Issues, pull requests, branches, commits, tags, releases, workflows, and workflow
runs all appear in a single list-and-details layout, the way an email client lays
out a mailbox. Every view is reachable from the keyboard and reads cleanly with a
screen reader — there are no custom-drawn controls to get lost in.

This is the first release worth pointing anyone at: GHManage now installs itself
properly and keeps itself up to date, so getting the next version no longer means
going and fetching one.

Install

1. Install the GitHub CLI and sign in — GHManage uses
   it for every GitHub request:

   gh auth login
   

2. Download GHManage-win-Setup.exe below and run it.

It installs for your account only, with no administrator prompt, and adds a Start
menu shortcut. From here on it updates itself: a new version downloads
quietly in the background and is applied the next time you start the app. Nothing
to click, nothing to download again. Help ▸ Check for Updates checks on demand
and offers to restart.

Windows may show a SmartScreen "unknown publisher" warning until code signing is
switched on — choose More info → Run anyway.

GHManage-win-Portable.zip is the same app as a folder you can run from
anywhere. It does not update itself.

What it does

Pick a repository. The app opens on a list of your GitHub repositories —
arrow to one and press Enter. Repositories you add by URL stay pinned near the
top. Press F on any item, in any view, to star it; everything you star collects
in a single ★ Favorites view that spans repositories. Or skip the chooser and
launch with --repo owner/name.

Issues and pull requests together. One inbox-style list, filtered by state
(open, closed, all) and type (issues, PRs, or both), sorted by number, title,
created date, updated date, or comment count. The details panel below shows the
full body, metadata, comments, and — for PRs — the file changes. Alt+N and
Alt+P jump between comments without scrolling.

Git views. Switch the list to branches, commits, tags, releases, workflows,
or workflow runs from the View menu. Press Enter on a branch to see its commits,
or Ctrl+B to pick a branch from within the commits view. Ctrl+Shift+B compares
two branches to see what's ahead and behind.

Releases with download counts. The Releases view shows how many times each
release was downloaded, with a repo-wide total in the status bar. Press Enter for
a per-file breakdown, most-downloaded first.

Drill down and download. Enter on a workflow run lists its artifacts and
downloads the one you pick; Backspace steps back out to where you were.

Act without leaving the app. Close and reopen issues and PRs, add comments,
run a workflow on a branch you choose, delete workflow runs, and open anything on
GitHub in your browser.

Built for screen readers. Quick list mode shows compact rows; Full list mode
includes field names in each row ("number: 208, type: PR, state: OPEN, title: …")
so a screen reader announces what each value means. Columns are configurable per
view, and every action has a keybinding — the
README has the full table.

Also in this release

• The app has a real icon, in the Start menu, the taskbar, and Alt+Tab.
• ghmanage.exe now carries version information, so Properties ▸ Details tells
  you which build you are running.

Requirements

• Windows 10 or 11, 64-bit
• The GitHub CLI, installed and authenticated with
  gh auth login. GHManage never asks for or stores credentials of its own.

Your favorites and pinned repositories live in %APPDATA%\ghmanage and are kept
across updates.

Downloads

File	Use it if
GHManage-win-Setup.exe	You want GHManage installed and updating itself
GHManage-win-Portable.zip	You want a folder to run from anywhere, no install, no updates

The remaining files (*.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed the installed app reads. Leave them alone.

GHManage v0.2.2

GHManage v0.2.2 Release Notes

GHManage is an accessible, keyboard-first wxPython desktop app for browsing and
managing GitHub repositories — issues, pull requests, and the git/Actions side
of a repo — built to work well with screen readers.

Download

Download	When to use
GHManage-win-Setup.exe — installer	Start here. Installs per-user (no administrator prompt) and keeps itself up to date automatically.
GHManage-win-Portable.zip — portable app folder	No installation. Unzip anywhere and run ghmanage.exe. Does not update itself.

The other files on this page (.nupkg, RELEASES, releases.win.json,
assets.win.json) are the update feed. The app downloads them itself — you do
not need them.

Both downloads include the Python runtime and wxPython, so you do not need to
install Python separately. You do need the
GitHub CLI (gh) installed and authenticated
(gh auth login).

Windows will show a SmartScreen "unknown publisher" warning — these builds are
not code-signed yet. Choose More info, then Run anyway.

---

New: GHManage updates itself

This is the headline change, and the reason for the new installer.

Install once with GHManage-win-Setup.exe and you should not have to think
about updating again. Shortly after startup GHManage quietly checks for a new
version. If it finds one it downloads it in the background and installs it the
next time you start the app, before any window appears.

Deliberately, the startup check never interrupts you:

• It does not open a dialog and does not steal focus.
• It announces itself in the status bar — "GHManage 0.2.3 downloaded — it will
  be installed next time you start GHManage" — and otherwise leaves you alone.
• It never restarts the app out from under you.

If you would rather check on demand, Help → Check for Updates… does so and
tells you either way. That one is user-initiated, so it does offer a dialog with
Restart Now if you want the update immediately, or Later to let it land
on the next launch.

Help → About GHManage reports the version you are running.

Where it installs

The installer is per-user: GHManage goes into your local application data
folder, adds a Start Menu entry, and never asks for administrator rights. That
last part matters for updating — because nothing needs elevation, updates can
install silently instead of prompting you every time.

The portable zip is unchanged in spirit from the old ghmanage.exe download:
copy it where you like and run it. It simply cannot update itself, and the app
will tell you so if you use Help → Check for Updates.

If an update ever goes wrong

Update activity is logged to %APPDATA%\GHManage\ghmanage-update.log. Starting
GHManage with --debug makes that log more detailed.

Also in this release

• New command-line options: --version prints the version and exits, --debug
  turns on verbose update logging, and --update-feed <folder> points the update
  check at a local folder instead of GitHub (used for testing the update cycle
  offline).
• A Help menu has been added, with Check for Updates… and About
  GHManage.

Note for existing users

If you are running the portable ghmanage.exe from v0.2.1 or earlier, it cannot
update itself to this release — that is exactly the limitation this release
fixes. Download GHManage-win-Setup.exe once, and updates are automatic from
here on. You can delete the old ghmanage.exe afterwards; your pinned repos and
favorites are stored separately and are not affected.

GHManage v0.2.1

GHManage v0.2.1 Release Notes

GHManage is an accessible, keyboard-first wxPython desktop app for browsing and
managing GitHub repositories — issues, pull requests, and the git/Actions side
of a repo — built to work well with screen readers.

Download

Download	When to use
ghmanage.exe — standalone portable executable	No installation required. Copy it anywhere and run.

The executable includes the Python runtime and wxPython — you do not need to install Python separately.

You do need the GitHub CLI (gh) installed and authenticated (gh auth login).

---

New: release download counts

GitHub records how many times every file attached to a release has been
downloaded, and shows that number nowhere in its web interface. GHManage now
surfaces it.

In the Releases view, a downloads column gives the total across all files
attached to each release, and the status bar totals every release currently
loaded — press Ctrl++ to load more and the total grows with the list. An
assets column is available too, if you turn it on under View → Columns.

Press Enter on a release to drill into its individual files, ordered
most-downloaded first, because the count is the reason you opened the view. The
status bar reports that release's total. Backspace returns to the releases
list, the same way it steps back out of a workflow run's artifacts. Enter on
a file downloads it in your browser.

The details panel breaks a release down file by file without leaving the
list, so arrowing through releases reads out each one's totals in turn.

Reading the numbers

The counts are worth a little care. A download is an HTTP request, not a person —
nothing deduplicates by user. The count is a lifetime running total with no
date breakdown, and no GitHub API offers one, so a trend has to be built by
recording the numbers over time and comparing them.

Most usefully: if your release contains several files, they describe different
groups of people and should not be averaged. An installer counts people
acquiring the software; an updater package counts installs that were still
running when you shipped the next version. The second is a far better measure of
whether anyone stayed.

There is a full write-up of the method and the interpretation traps at
How to Get GitHub Release Download Numbers.

Also in this release

• Source archives ("Source code (zip/tar.gz)") are not counted anywhere by
  GitHub — they are not release assets — so they correctly do not appear in the
  new view.
• Byte-size formatting is now shared between artifacts and release assets rather
  than duplicated.

Keybindings added

Key	Action
Enter (in Releases view)	Drill into the selected release's files and download counts
Enter (in Release Assets view)	Download the selected file in your browser
Backspace (in Release Assets view)	Step back to the releases list