shipwithjev

Catalog / Tools & apps

0600GitHub

bonk: a fox guards your Mac's keyboard

Keeps your desktop visible and your Mac awake while a tiny fox blocks keyboard, mouse and trackpad input. Jev drives the character's reactions.

Captain-Sangam/bonkREADME ↗
Bonk</h1>

<p align="center"><strong>A playful macOS input guard with an on-device fox personality.</strong></p>

Keep your desktop visible and your Mac awake while a tiny fox blocks unwanted keyboard, mouse, and trackpad input. Reactions run locally; Jev adds optional creative direction. Pick a bonk mode — classic fox, a powered-off-looking black screen, or an away-screen that lists the agents still running — and optionally photograph anyone who fails to unlock.

> [!IMPORTANT]
> Bonk is not a replacement for the macOS Lock Screen. Anything already visible remains visible.





## Build and install

Requires macOS 13+ and Swift 5.10+. The standalone Command Line Tools support building and packaging; full Xcode 15.4+ is needed for the XCTest suite.

```sh
git clone https://github.com/Captain-Sangam/bonk.git
cd bonk
make export
```

Launch **Bonk** from Spotlight or Applications and grant Accessibility permission in **System Settings → Privacy & Security → Accessibility**. Activate it from the menu-bar paw or your shortcut (default `⇧⌘B`), changeable in **Settings**; press `Esc` twice to start macOS owner authentication and unlock. Choose the bonk mode and turn on the optional intrusion camera in **Settings**; the camera asks for its own permission the first time you enable it.

`make export` validates, packages, and installs the app into `/Applications` or `~/Applications`. Use `make run` to build and launch from `dist/`, or `make app` to package only. See [Getting started](docs/getting-started.md) for permissions, unlock timing, and optional Jev setup.

## Documentation and contributions

- [Documentation index](docs/README.md)
- [Features and character behavior](docs/features.md)
- [Architecture](docs/architecture.md)
- [Packaging and installation](docs/packaging.md)

Also filed under Tools & apps

  1. 0616

    Jevstiller: distill Jev calls into a local model

    A self-hosted proxy that trains a local model on Jev's answers. It served 72% of Banking77 locally at 15 ms, with a 2% audit and a bound on disagreement.

    tomerglick57 · Tools & apps · 15 ms local

  2. 0611

    Scruple: code checks for what linters miss

    Semantic-aware linting with System One models: rules you can state in a sentence, checked against your code by Jev.

    @nalexpeae · Tools & apps

  3. 0606

    Algolia-style Postgres search with a Jev reranker

    Typo tolerance, typeahead, barcodes and facet counts in plain Postgres SQL, plus an optional Jev step that asks one question per top-10 result.

    @alex_forman1 · Tools & apps

  4. 0604

    Virtual Closet: outfits from closet videos

    built a virtual closet & outfit generator from raw closet videos. classification + semantic search thanks to jev 🥰. clueless closet dreams finally coming to life

    @maitreemervana · Tools & apps