Skip to content

The inbox

The inbox is where your agents’ reviews wait. When you open a review, its plugin’s view shows the work. You decide in the view and hand the decision over, and the agent continues. Reviews that have ended move to the inbox’s History tab.

Questions an agent asks with pinrail ask wait in the inbox too, marked with a question icon and asks you. They open in the thread of the agent’s session. See Questions and sessions.

Eleven reviews waiting, across eight projects.

The inbox has three tabs. Pending lists every review that waits, newest first. New rounds lists only the waiting reviews that revise an earlier one. History lists the reviews that have ended.

On the Pending tab, each row shows the title, the plugin, where it came from and who asked, and a summary of what the review asks. A paperclip icon shows that a review includes attachments, and how many. Hover over it to see their total size.

The summary is a set of counts, such as 1 blocker · 2 major · 1 nit for a code review or 3 drafts for emails, colored by importance. Each plugin decides what it counts, and a plugin that counts nothing shows no summary. The same counts appear in the notification for a new review and at the top of the review while it waits.

Display options, the button at the right of the header, chooses how Pending and New rounds list the reviews: grouped by project, grouped by repository, or in one list, newest first. Grouped by project, a repository in no project is a group of its own, and in a project with several repositories each review names its repository. The app remembers your choice.

The filters apply to every tab, and keep their values when you switch tabs or go to another page and come back. Each filter that is on shows as a chip under the tabs: click its × to remove it, or Clear filters to remove them all.

  • Filter by project, repository or plugin. The sidebar lists your projects or repositories. Click one, or choose one or a plugin in the Filter menu at the right of the header, to see only those reviews. Choosing a project shows the reviews from all of its repositories.
  • Show the starred reviews. Turn on Starred in the Filter menu. See Stars.
  • Search. Press / and type. The inbox shows the reviews whose title, plugin, requester, project, workflow or reference contains the text you typed. The content of a review is not searched. Esc leaves the search field and keeps the search, so J and K move through the results; the same goes for the search on every page.
  • Jump to what waits. The sidebar lists what waits under the session that sent it, one click away on every screen. See Sessions in the sidebar. ⌥↓ and ⌥↑ step through what is waiting, oldest first.

Open a review with Enter or a click. It opens in a panel beside the inbox, which stays in view. Depending on the plugin, the view shows a list, a diff, draft emails or a form.

  • Open as a page with the button at the right of the panel’s header, when the view needs more room. The page has a button that shows the review in the panel again.
  • Close the panel with its Close button, or press Esc, from the view too. When the view has something of its own open, such as a comment, the first Esc closes that, and the next closes the panel.
  • Go to the next or previous review with J and K, in the order the inbox lists them. They work while you work in the view too, unless you are typing in a field, and go round at the ends of the list: J on the last review goes to the first. ⌥↓ and ⌥↑ do the same.
  • Resize the panel by dragging its left edge. Pinrail remembers the width.

The History tab opens a review in the same panel. To open reviews as a page of their own instead, set Settings › General › Opening a review to As a page.

  1. Decide in the view. Use the controls that the plugin provides, for example to accept, reject, edit or comment. Your work is saved as a draft as you go, so you can open another review and come back to it.
  2. Add a note to the agent, if you want to, in the box below the view. In the macOS app you can dictate it: click the microphone, speak, and click it again or press Esc to stop. The first time, macOS asks for access to the microphone and to speech recognition.
  3. Hand over with the button, or ⌘Enter. The button says what will happen, such as Hand over 3 of 5. In the panel, Pinrail then opens the next review in the list, and closes the panel after the last one. On a review’s page, Pinrail returns to the inbox.

A review that includes attachments lists them above the view. Click N files to list each attachment with its name, size and type, and choose Save… to save one.

If the whole review is wrong, discard it with the Discard button at the right of the review’s header, or press ⌘D on the review or on its row in the inbox list. The agent is told to stop and is given your reason. From the review’s header, Pinrail then returns to the inbox. See Deciding and discarding.

When you discard a review, nothing is decided, and the agent is told to stop and is given your reason.

When an agent revises a review you asked it to change, the new round opens with your previous verdicts beside each item. Step between the rounds of one review with [ and ].

Every review that has ended is on the inbox’s History tab: decided, discarded, withdrawn or expired. Each row shows the outcome, who ended the review and when. Open one and it renders read-only, with the release of the plugin it was submitted to. Open the tab with ⌘⇧H.

Each decided review shows what was decided, as its plugin counts it: for example 2 accepted · 1 rejected, or a verdict such as approved in place of decided. The review’s header shows the same, and so does the decision the agent receives.

Reviews that were decided, discarded or withdrawn, newest first.

To search the history, press / on the History tab and type one or more words. A review matches when each word appears in its title, plugin, requester, project, workflow or reference, or in the name of the person who decided it. As in the inbox, the content of a review is not searched. You can also filter by project, repository, plugin or outcome. The Filter menu has Outcome on the History tab only.

To choose how long history is kept, see Keep reviews for in Settings.

To delete a review, choose Delete review… from the … menu at the end of its row on the History tab, or click the trash button in the review’s header. The command palette has Delete this review… while a review is open. Every round of the review is deleted, with its decisions and comments, and this cannot be undone. If a round still waits, it is discarded first, so the agent waiting on it is told to stop.

Star a review to find it again later. Click the star in the review’s header, on its page or in the side panel, or press ⌘⇧S. In the inbox, the star sits at the end of each row: it shows on a starred review, and on the others when the pointer is over the row. Click it again to remove the star. On the History tab, a starred round shows its star, and the … menu at the end of the row has Star and Remove star. Questions cannot be starred.

A star belongs to the round you starred. A review is shown as starred when any of its rounds is.

To list the starred reviews, turn on the star filter in the inbox, beside the project and plugin filters. On the Pending and New rounds tabs, it lists the waiting reviews with a starred round. On the History tab, it lists only the rounds you starred. A starred review is deleted with the rest of your history after the time set in Keep reviews for.

⌘K opens a palette that searches every review, pending or decided, the stages agents started in their sessions, and every action in the app, such as going to a screen, opening settings or switching the theme. Choose a stage to open its session’s thread where the stage started.

The command palette lists pending reviews, recent decisions and plugins.

Press ? anywhere in the app to see the keys, in sections: those of the page you are on first, then the general ones. Show all shortcuts lists every section, and a search looks through all of them. On Linux, use Ctrl for ⌘ and ⌥ for ⌥.

KeysAction
J / KNext / previous review
EnterOpen the focused review
⌥↓ / ⌥↑Next / previous waiting review
EscClose the review panel
⌘DDiscard the focused or open review
/Search the page
⌘KSearch everything
⌘1 or ⌘IInbox
⌘2 / ⌘3 / ⌘4Sessions / Work items / Projects
⌘⇧H / ⌘⇧PThe inbox’s History tab / Plugins
⌘,Settings
⌘⇧LSwitch theme
⌘BShow or hide the sidebar
⌘[ / ⌘]Back / forward
⌘EnterHand over to the agent
⌘⇧SStar or remove the star of the review
EArchive or unarchive the session
⌘⇧MMaximize / restore the view
⌘FFind in the view
[ / ]Previous / next round
?Keyboard shortcuts

A plugin can add keys of its own. They are listed under the plugin in the ? dialog while one of its reviews is open.

⌥⇧W brings Pinrail forward from any app and opens the oldest waiting review. You can change the shortcut, and have it open the inbox instead, in Settings › Shortcuts.