Repository navigation
Releases
Knock 0.2.1
Install: brew tap idestis/tap && brew trust idestis/tap once, then brew install --cask idestis/tap/knock for the app, brew install idestis/tap/knock for the CLI, or download the DMG or a knock_*.tar.gz below. Already have the app? It updates itself.
Fixed
- Stop the app crashing after Google or GitHub sign-in
- Say "Sign in required" instead of "Offline"
Requires macOS 26 or later for the app. The CLI runs on macOS and Linux (arm64 and amd64). Verify downloads against checksums.txt. Full changelog
Knock 0.2.0
Install: brew tap idestis/tap && brew trust idestis/tap once, then brew install --cask idestis/tap/knock for the app, brew install idestis/tap/knock for the CLI, or download the DMG or a knock_*.tar.gz below. Already have the app? It updates itself.
New
- Add door claims and code_stale with the relay's version
Fixed
- Relay hardened against code guessing and lockouts; door ownership survives restarts with Valkey and signed claims. Behind an HTTP proxy, set KNOCK_TRUSTED_PROXIES.
- The CLI keeps sign-in and door per relay, rotates codes weekly, and shows the guest's keys to the host.
- Knock.app only opens your shell for the knock you let in, keeps state per relay, and rotates codes weekly.
- Door claims expire after 90 days without opening the door.
- Delete leftover legacy state instead of letting it move later
Requires macOS 26 or later for the app. The CLI runs on macOS and Linux (arm64 and amd64). Verify downloads against checksums.txt. Full changelog
Knock 0.1.0
Install: brew tap idestis/tap && brew trust idestis/tap once, then brew install --cask idestis/tap/knock for the app, brew install idestis/tap/knock for the CLI, or download the DMG or a knock_*.tar.gz below. Already have the app? It updates itself.
New
- Add wire types and PBKDF2 code hashing
- Add knockd relay with knocks, sessions and optional sign-in
- Add knock CLI built with Charm
- Add Knock.app
- Add close, copy, config set and update
- Branded help screen with the K mark
- Relays with Google or GitHub sign-in now require it by default. Set KNOCK_ALLOW_ANONYMOUS=true to keep anonymous knocks.
- Show GitHub logins and the relay's sign-in requirement
- Refresh once when the relay refuses a token, prompt when sign-in is required
- Add guest.verified_only to turn away unsigned knocks
- Full Disk Access step in onboarding and a Security settings tab
- Add the Knock website for GitHub Pages
- The relay ships as a Helm chart: helm install knock-relay oci://ghcr.io/idestis/charts/knock-relay
Fixed
- Tidy Account settings and About panel
- Keep guest notices on a status line
- Tray states, window focus and key strip
- Keep colours in styled output and halve the help mark
- Show the edited name in the sidebar and send it to the relay
- Tell both sides why a session ended
- Mirror the host's rows on the guest screen
- Point Homebrew installs to brew upgrade instead of self-updating
Requires macOS 26 or later for the app. The CLI runs on macOS and Linux (arm64 and amd64). Verify downloads against checksums.txt. Full changelog