Getting started

Overview

What Hive Desktop is, and the shortest path from a fresh install to a working feed.

Hive Desktop pulls the work you care about — pull requests, issues, review requests, notifications, firing alerts, and anything that can POST a webhook — into one local queue, then runs flows that filter it, hand an item to a coding agent, or fire a command. Instead of refreshing a dozen tabs, you triage a single set of feeds.

The mental model

A workspace is a flow: sources on one side, a feed on the other, and optional filters, actions, and notifications in between.

• Sources watch something and emit observations — a GitHub search query or notification inbox, a Grafana alert rule or PromQL expression, or a local webhook endpoint your own scripts post to.
• Feeds are the lists in the sidebar where matching items land.
• Actions are commands you run on an item (review a PR, open it in your editor, launch an agent session).
• Notifications raise a system banner when something needs you.

You don’t have to build any of this by hand — connecting an account seeds a working set of feeds. How Hive works covers the full model once you’re ready.

Start here

Install it with the one-liner on the install page. Once the app is open, these three pages take you from first launch to a live feed:

1. Sign in to GitHub — the first-run device flow.
2. Turn on notifications — required for banners on macOS.
3. See your first items — the starter feeds and the core loop.

Hit a snag? Report a problem shows you how to send a diagnostic bundle or grab the log by hand.