The app
Don’t want to type commands? Don’t.
hush uiA local app in your browser that covers every project hush knows on this machine, not just the folder you started it in.
- The left sidebar holds Home, Global keys and your projects. Group projects into folders (“Clients”, “omoto”): drag one onto a group, or use Put in a group… in its ⋯ menu. Groups fold shut. Drop a global key, set or key group on a project group and every project in it gets it. An orange dot marks a project whose code reads a key it does not get.
- Home lists your projects. hush remembers a project whenever it runs in
one, and looks through the folders you choose (your usual code folders
until you do) for every codebase, set up for hush or not. Each one shows its
stack (Next.js, Python, Go, …), its branch and when it was last worked on,
how many keys it gets, how many its code reads but lacks, and a warning when a
plaintext
.envsits in it. That is a names-only scan: no value, and nothing from a.env, is read. One line says where hush looks, with Look again and Change folders…, where Choose a folder… opens your system’s folder picker (Finder’s on a Mac, Explorer’s on Windows, zenity’s or kdialog’s on Linux) or takes a pasted path. Add a folder takes a single codebase the same way. - Views on Home: cards or a list; grouped by project group, by folder, or not at all; sorted by recent work, name or what needs you; and All, Needs you, Using hush or Not set up, with a filter by name, folder, stack or group. The app remembers your choice in this browser. Codebases that are not set up wait folded at the bottom.
- Suggested, on Home, on each project and on Global keys: what to do next,
each with the one click that does it, and an × to stop suggesting it.
- A project’s code reads a key that one of your global sets has: give it.
- The same key and value is kept as several projects’ own: keep one global copy instead. Values are compared on your machine; only the key’s name reaches the page.
- A plaintext
.envsits in a project: import it as its own keys, after a review, then delete the file. - Only one project uses a global set: keep it for that project.
- A global key could still be used by someone you removed, or is past its rotation age: replace it.
- Projects share a parent folder or a GitHub owner: group them.
- While you drag a global key, set or group, the projects whose code reads something in it, and lacks it, light up.
- Every project has a ⋯ menu, on Home and in the sidebar: Open, Show in Finder (Explorer on Windows, the file manager on Linux), Copy path, Rescan, Hide and Remove from list…. Hidden projects wait under Hidden on Home, where Show brings one back; a removed one is forgotten, and looking through your folders won’t add it back — adding the folder again does. Neither touches the project’s files, and using hush in a project never undoes either.
- Global keys are yours, kept once, never in a repository, and part of any project you give them to. They sit in the right sidebar by group, then set, then key, with a search when there are more than a few. Drag a key, a set or a whole group onto a project (in the left sidebar, on Home, or anywhere on an open project’s page) and the project gets it whenever it runs. Nothing goes into the project’s repository, and rotating a key is one edit that every project picks up. A group gives a project every set in it, including sets you add to it later. Without a mouse, each ⋯ menu has Use in a project…. Close the sidebar with its ×; the Keys tab on the right edge opens it again (on a narrow window it opens over the page).
- Groups are folders for your global sets, such as “AI stack”: New group in the sidebar or on Global keys, or Put in a group… on a set. A group can be renamed or ungrouped from its ⋯ menu, and a project that used it keeps each set either way.
- A project’s page has a header (its folder, branch, how many keys it
gets, how many are missing, setup progress and its protection level) and four
tabs: Keys, Team, Agent and Activity. Add covers a key,
a
.envor a new set. On Keys, what its code reads but does not get comes first, each with a fix; what it does get folds away. Setup’s remaining steps fold into one line. Then its keys, in two parts: Onlyis its own (kept for it alone, refused anywhere else, never in its repository), plus any sets in its repository’s vault. From your global keys lists the groups, sets and single keys it uses, each with Stop using here or Remove. When two of them give the same key, a note says which one wins and lets the other win instead. Only variables that look like credentials ( …_KEY,…_TOKEN,DATABASE_URL, …) or that you already keep count, soNODE_ENVandPORTare never “missing”. Agent shows the protection level in full, with the next step up. - Moving between the two: a project’s own set or key has Make global.
It joins your global keys (a single key goes into a global set you pick) and
the project keeps getting it. A global set or key has Keep for
only . If other projects use it, the app names them and asks before taking it from them. A set in the repository’s vault can be made global too; if teammates read that vault, the app asks first, since they stop getting the key from the repository. - Sending a key to a host: a key’s ⋯ menu has Send to a host… — Cloudflare, Vercel, Fly, GitHub and the rest in Sending keys to your hosts. hush runs that host’s CLI on your machine with the value on its standard input. Each key shows where it was sent; one that changed since says so, and a click sends the new value.
- Global keys suggests what to tidy: sets only one project uses (with Keep all for their projects when there are several), keys several projects keep the same copy of, and keys to replace.
- Team is who can decrypt. Agent shows what your coding agent is connected to and what it must ask you first. Activity is the audit log in plain sentences.
It binds to 127.0.0.1 only, needs a one-time token that travels in the link’s
#fragment (so it never reaches a server log, and the page wipes it from the
address bar and history), refuses non-loopback Host headers, cannot be framed
by another page, and sends the browser masked previews, never the real
values. The exception is when you click Reveal, which asks for the
same approval as hush get, shows the value for fifteen seconds and writes the
reveal to the audit log.
Dropping in a .env. Drag files anywhere onto the page, or use Import
.env. Nothing is saved until you review it. The common case is one click:
name it (a project’s own .env is named after the project), and it becomes a
set that this project uses straight away. On a project it is Only