Add a repo

Goal: bring a GitHub repository’s pull requests and issues into the inbox, then narrow the list to the rows that matter to you.

Prerequisites

• lazybox is running (see the Quickstart).
• gh auth login has been run, so gh auth token resolves a token with access to the repository.

Add the repo

You can add a repo in two ways, depending on where you are.

First run

On the very first launch the setup wizard walks you through adding your first repository. Follow the prompts; lazybox starts polling it immediately.

Any time after

Press , to open the settings palette, then choose the option to add a repository and enter its owner/name. lazybox begins polling it (default every 60 seconds) and your PRs and issues appear in the sidebar, grouped under that repo.

A repo group can be folded or unfolded with Space on the group row.

Filter by your role

Once rows arrive, you usually don’t want all of them at once. From the sidebar:

• Press f to open the filter menu — a multi-select over state, role, and kind predicates (unread, CI-failing, with-agent, author, reviewer, assignee, mentioned, PR/issue, …), each shown with a live match count. Toggle predicates and confirm; active filters appear as removable chips in the sidebar header.
• Press o to cycle the sort order: recent → by-role → split.

So to see only the PRs where you’ve been asked to review, press f, toggle the reviewer predicate, and press Enter. Press Shift-R at any time to force a manual refresh instead of waiting for the next poll.

Verify

You should now see the repository’s rows in the sidebar with unread markers on items that have new activity. Selecting a row populates the activity pane on the right.

Don’t see anything yet?

A blank sidebar just after adding a repo is normal, not a bug:

• The first poll can take up to ~60s (providers.github.poll_interval). Press Shift-R to force a refresh instead of waiting.
• Rows may be hidden by active filters — press f and clear any toggled predicates (or remove the chips shown in the sidebar header).
• If the repo simply has little activity tied to you, there may be nothing to show. Press x n to spin up a fresh scratch workspace and open a session in it.

Related

• Configure polling and other per-repo behaviour in the configuration reference.
• Then run an agent per workspace on one of the rows.
• With multiple repo groups active, coordinate selected agents across them from one broadcast.