Apps and clients

Rivets has four clients. The web, Mac, and iOS apps are for people: create tasks, watch and steer agents, review and edit changes, and merge. The CLI is the worker that runs agents. Your account’s preferences, such as agent defaults, send key, keyboard shortcuts, and sidebar order, sync across all of them.

Web

Open app.rivets.dev in a current browser.

• Keyboard-first, with a command palette on ⌘K.
• Every keyboard shortcut can be rebound. Press ⌘/ to see and customize them.
• Inbox in the sidebar collects mentions and activity on the tasks you follow. Turn on Desktop notifications there to get a browser notification for new entries while Rivets is in a background tab.
• Browser tabs in a task open as new tabs in your browser.

The web app cannot run a worker. To run agents on the same machine, install the CLI or use the Mac app.

Mac

Requires macOS 15 or later. Download it from downloads.frontier.sh/rivets/Rivets-latest.dmg.

• A worker out of the box. The app includes a background worker, so your Mac can take tasks as soon as you sign in. Configure it under Settings › This Mac. See Connect a worker.
• One organization per window. Open another organization in its own window with File › New Window (⇧⌘N) or from the organization menu. Each organization can be open in one window at a time: choosing one that is already open brings its window forward. The bundled worker takes tasks for every organization you have open.
• Project tree in the sidebar and a ⌘K command palette for tasks, chats, organizations, and window commands.
• Inspector with Team, Files, Changes, and Checks, plus terminals. Showing or hiding the sidebar, inspector, or terminal applies to the current window only.
• Inbox opens as a page in the main area.
• Open in editor and Reveal in Finder for files in a task on this Mac.
• Native browser tabs inside a task, and a Preview tab for the task’s dev server that can also show an iOS Simulator running on this Mac. See Previews.
• Fast local reads. When a task runs on this Mac’s own worker, files and diffs are read straight from disk.
• Password manager support. Saved logins for app.rivets.dev and two-factor codes can be filled on the sign-in screens.
• Notifications when an agent run finishes. Turn them on under Settings › Notifications.
• Automatic updates through Sparkle. The bundled worker updates with the app.

iPhone and iPad

One universal app for iOS and iPadOS 18 or later, distributed through TestFlight and the App Store.

• iPhone has Tasks and Settings tabs. Automations, Inbox, and New task are buttons at the top of the Tasks screen. The inbox opens as a sheet.
• iPad uses an adaptive multi-pane workspace like the Mac app, with the inbox as a page. Where iPadOS allows multiple windows, each window shows one organization.
• Create tasks and conversations, watch agents live, steer, cancel, review changes, open terminals and previews, and publish pull requests.
• Select any range of an agent’s answer, including while it streams, and copy it with the system edit menu.
• Share to Rivets. From the share sheet in Photos or any app that shares images, send up to eight images to Rivets. Write what the agent should do, then under Send to choose a repository to start a new task in, or an existing task to add them to, and choose Send. They go out as soon as the Rivets app is in front. You need to be signed in to Rivets on the device first.
• Push notifications when an agent run finishes.

The iOS app observes and controls work. It never runs a worker.

CLI

The rivets CLI runs a worker on macOS, Linux, or Windows. It does not create tasks or browse work. See Connect a worker and the CLI reference.

Appearance

Every app has 39 built-in themes, from families including Rivets, GitHub, Catppuccin, Gruvbox, Tokyo Night, Ayu, Dracula, Nord, Rosé Pine, and One. Under Settings › General, set Appearance to Dark, Light, or Auto (Automatic on iPhone and iPad), then pick a Theme. With Auto, you pick a Dark theme and a Light theme, and Rivets follows the system between them. Themes color the whole app, including code and terminals. The choice is kept on each device rather than synced to your account.

Feature notes

Leaving review comments and approvals on GitHub from inside Rivets is not supported in any client yet.

Keyboard shortcuts

These are the defaults on web. The Mac app uses the same bindings, and customized bindings sync with your account. Press ⌘/ to see the full list, search it, and choose Customise to rebind one.

General

Create

Chats

Tasks

Your browser may keep ⌘W, ⌘,, or ⌘. for itself. If a shortcut never reaches Rivets, rebind it.

Sending messages

Under Settings › General › Send with, choose whether Return sends a message and Shift-Return starts a new line, or Return starts a new line and only ⌘ Return sends. ⌘ Return sends in both modes.