# Hush

> Hush sorts GitHub notifications into what needs you and what is only FYI, follows whose turn it is on every pull request and issue that involves you, and pushes only what waits on you. The app is at https://app.hush-gh.com. Every setting is one JSON object (settings.json); the settings page documents all of it.

All pages in one file: https://hush-gh.com/llms-full.txt

## Start

- [Overview](https://hush-gh.com/docs/index.md): How Hush sorts your GitHub notifications, and how to make it work your way.
- [Getting started](https://hush-gh.com/docs/getting-started.md): Sign in, learn the three tabs, turn on push, and triage your first threads.
- [GitHub access](https://hush-gh.com/docs/github-access.md): What Hush can read and do on GitHub, why an org can be missing, and when to use a custom token.

## Use Hush

- [Inbox](https://hush-gh.com/docs/inbox.md): How Hush sorts notifications, what each tab and row shows, and how Done, Snooze, Mute, and Read work.
- [Pull requests and issues](https://hush-gh.com/docs/pull-requests-and-issues.md): The dashboards of open work that involves you, grouped by whose turn it is.
- [Peek and GitHub actions](https://hush-gh.com/docs/peek.md): Read a pull request or issue without leaving Hush, and approve, comment, merge, or close it from there.
- [Notifications](https://hush-gh.com/docs/notifications.md): Push alerts on your devices, what gets pushed, quiet hours, the alert history, and counts on the tab.
- [Feeds](https://hush-gh.com/docs/feeds.md): Read an inbox tab in any feed reader, with a private Atom feed.

## Make it yours

- [Rules](https://hush-gh.com/docs/rules.md): Send threads to Needs you, FYI, or Muted, turn pushes on or off, and move threads to Done or Snoozed by themselves.
- [Saved views](https://hush-gh.com/docs/views.md): Extra inbox tabs that show only the threads you choose.
- [Query language](https://hush-gh.com/docs/query-language.md): The one-line syntax of the filter box, saved views, and rules, with every word and value.
- [Keybinds](https://hush-gh.com/docs/keybinds.md): Every keyboard shortcut, the command palette, and how to change any key.
- [Appearance and menus](https://hush-gh.com/docs/appearance-and-menus.md): Themes, light and dark mode, the start page, and the items of the right-click menus.

## Reference

- [settings.json](https://hush-gh.com/docs/settings.md): Every Hush setting in one JSON file, what each one controls, its type and default, and how the file is checked and saved.
- [Limits, timing, and data](https://hush-gh.com/docs/limits.md): How often Hush checks GitHub, what it stores, how long it keeps it, and the limits on views, sections, and devices.
- [For agents](https://hush-gh.com/docs/agents.md): How an AI agent or a script can read these docs, write a user's settings.json, and check it before the user saves it.
- [Troubleshooting](https://hush-gh.com/docs/troubleshooting.md): What to do when notifications are missing, pushes do not arrive, or Hush shows an error.

## About Hush

- [Pricing](https://hush-gh.com/pricing.md): What Hush costs, and what the money pays for.
- [Privacy](https://hush-gh.com/privacy.md): What Hush stores about you, where it keeps it, who else sees it, and how to delete all of it.
- [Security](https://hush-gh.com/security.md): For you and your org's owners, what Hush can do with GitHub access, how it keeps your token safe, and how to report a problem.