settings.json

All of your Hush settings are one JSON object. The settings pages edit parts of it; settings.json shows all of it, also the settings that no page shows. You can edit it by hand, export it to a file, import a file, or give it to an agent to write.

Open it in Settings → General → Edit settings.json (app.hush-gh.com/settings/json).

How it works

• It has only your changes. A setting that you did not change is not in the file; it uses its default. A new default in Hush then applies to you too.
• Remove a key to go back to its default.
• Save replaces all your settings. A setting that is not in the file goes back to its default. ⌘ S / Ctrl + S saves.
• Hush checks the whole file first. If one value is wrong, it shows the error, such as Rule 2: "then" needs category, push, or triage., and saves nothing. Unknown keys are errors too.
• dash and menus are groups. Write only the keys that you change: { "dash": { "staleDays": 5 } } keeps the default sections. A list, such as dash.pr or rules, is always replaced as a whole.
• Changes apply at once, on every device. A change to rules, botsAreFyi, teamReviewsAreAction, or reviewResolution sorts your stored threads again.

A complete example:

{
	"pushFyi": false,
	"quietHours": { "from": 1320, "to": 420, "weekends": true, "timeZone": "America/New_York" },
	"reviewResolution": "any_review",
	"teamReviewsAreAction": true,
	"rules": [
		{ "name": "Website is FYI", "when": { "repo": "acme/website" }, "then": { "category": "fyi" } },
		{ "name": "Mute renovate", "when": { "author": "renovate*" }, "then": { "category": "muted" } },
		{ "name": "Always push Alice", "when": { "by": "alice" }, "then": { "push": true } }
	],
	"views": [{ "id": "web", "name": "Web", "base": "inbox", "when": { "repo": "acme/web-*" } }],
	"dash": {
		"scope": "org:acme archived:false",
		"excludedTeams": ["acme/everyone"],
		"staleDays": 5
	},
	"keys": { "inbox.done": ["d"] }
}

What is not in settings.json

These are not settings of your account, so they are not in the file:

• This browser only: the mode and theme, the start page, the tab title and icon counts, and notes that you chose “Don't show again” for.
• Your data: push devices, feeds, and what you did to threads and items (Done, Snooze, Mute, hidden and moved items).
• Your GitHub access: the custom token, if any.

Settings file

Settings → General → Settings file exports your settings to a file, and imports a file. Use it to keep a copy, to move to another account, or to share your rules.

The file is your settings.json in a small wrapper:

{
	"hush": 1,
	"exportedAt": "2026-09-28T09:00:00.000Z",
	"settings": { "rules": [{ "when": { "repo": "acme/website" }, "then": { "category": "fyi" } }] }
}

• hush is the file format version: 1.
• settings has only the changes, the same as settings.json.
• Import replaces all your settings, like Save in settings.json. Hush asks first, and says how many rules and views the file has. Settings that Hush no longer has are left out.

All settings

Every setting

pushAction

Type: boolean · Default: true · In the app: Settings → Notifications

Push “Needs you” threads: review requests, failed CI on your PRs, replies.

When a thread arrives in Needs you, Hush sends a push to every device that has push on. A rule with "push": false stops the push for the threads it matches; with "push": true it sends one even when this is off.

pushFyi

Type: boolean · Default: false · In the app: Settings → Notifications

Push FYI threads too. Usually noisy; a rule with "push" is often better.

Also push FYI threads. Most people leave this off and write a rule with "push": true for the few repositories or people they care about.

pushTurnChanges

Type: boolean · Default: true · In the app: none (settings.json only)

Push when a thread becomes your turn with no new notification from GitHub, for example new commits after your review.

GitHub sends no notification for some changes that make a thread your turn: new commits after your review, CI that fails later, a snooze that ends. The inbox watcher looks at open threads every 15 minutes. When one of them becomes your turn, Hush moves it to Needs you and, with this on, pushes it.

pushResolved

Type: boolean · Default: true · In the app: none (settings.json only)

Change an alert from the last day to a quiet “✓ You approved” (or “Done”, “CI passes now”…) when it is resolved, then close it.

When an alert from the last day is resolved (you approved, CI passes now, you marked it Done on another device), Hush replaces it with a quiet alert such as “✓ You approved”, which then closes itself. Off: the old alert stays until you close it.

quietHours

Type: object or null · Default: null · In the app: Settings → Notifications

No pushes at these times: { "from": minutes after midnight, "to": minutes, "weekends": true or false, "timeZone": "Europe/London" }, or null for off.

No pushes at these times. The alerts still go in the alert history (the bell). When quiet hours end, one push lists what waited.

• from and to: minutes after midnight, 0 to 1439. from later than to crosses midnight (22:00 to 07:00 is 1320 to 420). They must differ.
• weekends: true also makes all of Saturday and Sunday quiet.
• timeZone: an IANA time zone name, such as "Europe/London" or "America/New_York".

{ "quietHours": { "from": 1320, "to": 420, "weekends": true, "timeZone": "Europe/London" } }

peekMarksRead

Type: boolean · Default: true · In the app: none (settings.json only)

A thread open in the peek for a moment is marked as read (also on GitHub).

A PR or issue that stays open in the peek for 1.5 seconds is marked as read, in Hush and on GitHub. Off: only Read (or opening it on GitHub) marks it.

reviewResolution

Type: "strict" or "any_review" · Default: "strict" · In the app: none (settings.json only)

When a review request stops being your turn. "strict": when GitHub no longer asks you. "any_review": also when someone else approves or asks for changes.

When a review request stops being your turn.

• "strict": when GitHub no longer asks you: you reviewed, or the request was removed.
• "any_review": also when someone other than you and the author approves or requests changes after the newest push. Useful on teams where one review is enough.

This also applies to team review requests.

botsAreFyi

Type: boolean · Default: true · In the app: Settings → Inbox

Activity by bots (dependabot, renovate, codecov…) is FYI.

PRs that bots open (dependabot, renovate…) are never your turn: they are FYI, and they show in Other on the Pull requests tab. Comments and mentions by bots do not count as replies. A bot is a login that ends in [bot], or starts with dependabot, renovate, github-actions, or codecov.

teamReviewsAreAction

Type: boolean · Default: false · In the app: Settings → Inbox

A review request to one of your teams is “Needs you”, not FYI.

A review request to a team you are in goes to Needs you (and is pushed). Off, it is FYI in the inbox, and it shows under “Your team's turn” on the Pull requests tab.

rules

Type: array of rules · Default: [] · In the app: Settings → Inbox

Inbox rules, top to bottom; the first match wins. Each is { "name", "enabled", "when": conditions, "then": { "category", "push", "triage", "snoozeHours" } }.

Your inbox rules. Hush checks them from top to bottom, after its own defaults. The first enabled rule that matches a thread wins. A change to the rules sorts your stored threads again. See Rules for the editor, and the query language for the conditions.

A rule:

• name (text, optional): shown on the thread as “rule: …”.
• enabled (boolean, optional): false turns the rule off. Missing means on.
• when (object): the conditions. All must match. {} matches every thread.
• then (object): what to do. It needs at least one of category, push, or triage.
  • category: "action" (Needs you), "fyi", or "muted".
  • push: true or false, in place of the push settings.
  • triage: "done" moves the thread to Done, "snooze" snoozes it for snoozeHours (a whole number from 1 to 720). Hush moves a thread only when it has new activity or when the rule starts to match, so a thread that you move back stays where you put it.

{
  "rules": [
    { "name": "Docs repo is FYI", "when": { "repo": "acme/website" }, "then": { "category": "fyi" } },
    { "name": "Mute dependabot", "when": { "author": "dependabot*" }, "then": { "category": "muted" } },
    {
      "name": "Nightly CI can wait",
      "when": { "type": ["CheckSuite"], "repo": "acme/nightly" },
      "then": { "triage": "snooze", "snoozeHours": 12, "push": false }
    }
  ]
}

views

Type: array of views · Default: [] · In the app: Settings → Inbox

Saved views: extra inbox tabs. Each is { "id", "name", "base", "when": conditions }.

Saved views: extra tabs after the built-in inbox tabs, in this order. Up to 12.

• id: 1 to 16 lower-case letters or digits. Unique. Feeds and links use it.
• name: up to 40 characters. The tab label.
• base: the list the view starts from: "inbox" (Needs you + FYI), "action" (Needs you), "fyi" (FYI), "snoozed" (Snoozed), "done" (Done).
• when: the same conditions as rules. category here is the thread's list now, after your rules.

{
  "views": [
    { "id": "web", "name": "Web team", "base": "inbox", "when": { "repo": "acme/web-*" } },
    { "id": "ci", "name": "Broken CI", "base": "action", "when": { "kind": ["fix_ci"] } }
  ]
}

dash.pr

Type: array of sections · Default: below · In the app: Settings → PRs & issues

Pull request sections: saved GitHub searches { "id", "name", "query", "enabled" }. @me is you; @team runs once per tracked team.

The sections of the Pull requests tab. Each is a saved GitHub search. Up to 20.

• id: 1 to 40 lower-case letters, digits, or dashes. Unique.
• name: up to 60 characters.
• query: a GitHub search, 1 to 256 characters. @me is you. @team runs the search once for each team you track.
• enabled: false hides the section and skips its search.

A change to dash.pr replaces the whole list. To add a section, write the defaults below and your new one.

The defaults:

dash.issue

Type: array of sections · Default: below · In the app: Settings → PRs & issues

Issue sections, the same as dash.pr.

The sections of the Issues tab, the same as dash.pr. The defaults:

dash.scope

Type: string · Default: "archived:false" · In the app: Settings → PRs & issues

Added to every search, for example "org:acme archived:false".

Added to the end of every section's search, up to 200 characters. Use it to keep the tabs to your work: "org:acme archived:false", or "-repo:acme/website".

dash.excludedTeams

Type: array of strings · Default: [] · In the app: Settings → PRs & issues

"org/team" slugs that @team skips.

Teams that @team sections skip, as "org/team" slugs. Hush finds your teams on GitHub (again every 6 hours); turn off big ones, such as “everyone”, to cut noise. A section searches the first 15 teams at most, and one tab runs up to 40 searches.

{ "dash": { "excludedTeams": ["acme/everyone", "acme/contractors"] } }

dash.staleDays

Type: whole number, 1 to 60 · Default: 3 · In the app: none (settings.json only)

An item whose turn is older than this many days is marked stale (1 to 60).

An item whose turn started more than this many days ago is stale: it shows how long it waited (“waiting 5d”) in amber. Items in the Other group are never stale.

dash.hideOthersDrafts

Type: boolean · Default: true · In the app: none (settings.json only)

Hide draft PRs that you did not open.

Leave out draft PRs that someone else opened. Your own drafts always show (in Other).

dash.hideBots

Type: boolean · Default: true · In the app: none (settings.json only)

Hide PRs and issues that bots opened, unless your review is requested.

Leave out PRs and issues that bots opened, unless your review is requested from you by name.

menus.inbox

Type: array of menu item ids · Default: below · In the app: Settings → General

The right-click and “⋯” menu of inbox threads: item ids in order; "sep" is a line.

The items of the right-click menu (and the “⋯” menu on phones) of inbox threads, in order. "sep" is a separator line. Items that you leave out are hidden. Items that do not apply to a thread, such as Done in the Done tab, are left out when the menu opens. See the item ids in Menus.

{ "menus": { "inbox": ["peek", "main", "sep", "done", "snooze:tomorrow", "until:ci_pass", "mute", "sep", "copy"] } }

Hush adds "v" (the menu version) next to your menus. Leave it: it tells Hush which new items you have already seen.

The default:

[
  "peek",
  "main",
  "github",
  "sep",
  "done",
  "snooze",
  "mute",
  "restore",
  "read",
  "copy",
  "rule",
  "sep",
  "select",
  "selectAll"
]

menus.dash

Type: array of menu item ids · Default: below · In the app: Settings → General

The menu of PRs and issues, the same way.

The menu of pull requests and issues on the dashboards, the same way as menus.inbox.

The default:

[
  "peek",
  "main",
  "github",
  "sep",
  "move",
  "undoMove",
  "hide",
  "copy",
  "sep",
  "select",
  "selectAll"
]

keys

Type: object: command id → array of keys · Default: {} · In the app: Settings → Keybinds

Keyboard shortcuts you changed: { "command id": ["key", …] }, for example { "inbox.done": ["d"] }. [] turns a shortcut off. Keys: "j", "Shift+j", "Mod+k" (⌘ or Ctrl), "Enter", "Space", "?".

The keyboard shortcuts that you changed. For each command id, the keys that replace its default keys, up to 4. [] turns the shortcut off. Commands that you do not list keep their defaults.

How to write a key:

• Letters are lower case. Shift is a modifier: "Shift+j", not "J".
• Modifiers come first, in the order Mod, Alt, Shift. Mod is ⌘ on a Mac and Ctrl on other computers.
• Named keys: Enter, Escape, Space, Tab, Backspace, Delete, the arrows (ArrowUp…), Home, End, PageUp, PageDown, F1 to F12.
• Other characters are themselves, with no Shift: "?", "/", "1".

{ "keys": { "inbox.done": ["d", "e"], "inbox.mute": [], "palette": ["Mod+k", "Mod+p"] } }