# Hush docs

> How Hush sorts your GitHub notifications, and how to make it work your way.

Source: https://hush-gh.com/docs

Hush reads your GitHub notifications and sorts them into what **needs you** and what is only **FYI**. It follows whose turn it is on every pull request and issue that involves you, sends a push only when something waits on you, and lets you act on GitHub (approve, comment, merge, mark Done) without leaving your inbox.

## The idea in one minute

- **Needs you** is short on purpose. A thread is there only when you are the next person who must act: your review is requested, CI fails on your PR, someone replied to you, your approved PR is ready to merge. See [what needs you](https://hush-gh.com/docs/inbox#what-needs-you).
- **FYI** is everything else: team mentions, watched repositories, bots, merged and closed work.
- **Whose turn** is one set of rules for the inbox and the [Pull requests and Issues tabs](https://hush-gh.com/docs/pull-requests-and-issues). An item is in Needs you exactly when it is “Your turn”.
- **Hush follows up by itself.** When you approve, push a fix, or reply, the thread leaves Needs you with a note such as “✓ You approved”. When it needs you again, it comes back.
- **Everything is a setting.** Rules, views, sections, menus, and keys are in one [settings.json](https://hush-gh.com/docs/settings) that you can edit, export, and share.

## Where to start

- New to Hush: [Getting started](https://hush-gh.com/docs/getting-started).
- An org's repositories are missing: [GitHub access](https://hush-gh.com/docs/github-access).
- Too much noise, or not enough: [Rules](https://hush-gh.com/docs/rules) and [Notifications](https://hush-gh.com/docs/notifications).
- You like the keyboard: [Keybinds](https://hush-gh.com/docs/keybinds).
- You want every option: [settings.json](https://hush-gh.com/docs/settings).

## For agents

Every page is also plain Markdown: add `.md` to its address (for example [/docs/settings.md](https://hush-gh.com/docs/settings.md)). [/llms.txt](https://hush-gh.com/llms.txt) lists the pages, and [/llms-full.txt](https://hush-gh.com/llms-full.txt) has all of them in one file. To change a user's setup, read [For agents](https://hush-gh.com/docs/agents) first.