Skip to content

PROJECTS Mode

PROJECTS mode is the entry point. It lists your repos and routes each selection into the action you want.

  • Repositories are fetched from authenticated GitHub APIs.
  • List is ordered by activity, with last-selected repo pinned first.
  • Viewport shows 5 rows at a time; move with j/k.
  • Press enter to open the action chooser for the selected repo.

The chooser appears under the selected repo card:

  • Diff
  • Git
  • Pi

Once selected, glib resolves workspace state (clone on first use, then reuse) and routes to that mode.

Press b to switch backend:

  • local for persistent checkouts
  • ephemeral for temporary worktrees/clones

When a PI session is active for the selected repo, footer shows:

● pi active i resume

KeyAction
j / kMove repo selection
enterOpen action chooser / confirm action
bToggle backend (local / ephemeral)
rRefresh repository list
escBack or close transient UI

Next: DIFF mode, GIT mode, PI mode.