Skip to content

Repository files navigation

Slip

A local capture inbox. Select text anywhere, press Shift Shift, and it becomes a markdown file in ~/Documents/Slip. Hold Option to speak a note, or double-tap it to latch. ⌘⇧ ⌘⇧ opens a draw overlay.

No account, no sync, no telemetry. Agents read the folder.

Install

Download the latest macOS archive from Releases. Open the .dmg or unzip the .zip, then drag Slip into Applications.

The build is unsigned. Right-click Slip and choose Open the first time.

Grant Accessibility the first time you capture, and Microphone the first time you speak a slip. Closing the window hides it. The menu-bar item keeps capturing.

Capture

Defaults, remappable in Settings:

  • ⇧ ⇧ — the current selection, including images in it, or a screenshot on the clipboard
  • hold — speak a note; ⌥ ⌥ latches the recorder
  • ⌘⇧ ⌘⇧ — draw on a transparent overlay

Drop images onto a slip. Merge selected slips from the command palette.

CLI

The CLI lives inside the app. There is no separate binary or npm package. The app does not need to be running.

/Applications/Slip.app/Contents/Helpers/slip list
/Applications/Slip.app/Contents/Helpers/slip add "a note"

Optional PATH shim (still the app binary):

ln -sf /Applications/Slip.app/Contents/Helpers/slip /usr/local/bin/slip

--vault <dir> or SLIP_VAULT overrides the folder. Otherwise the CLI uses the vault path from Slip settings.

See SKILL.md for the full command list.

Vault

~/Documents/Slip/

  • YYYY-MM-DD-<id>.md — one slip. Never renamed or moved.
  • INDEX.md — generated
  • SKILL.md — how agents should use the vault
  • attachments/<id>/ — images, drawings, and voice notes

Develop

bun install
bun run dev

Grant Accessibility to Electron while developing.

Release

bun run release:mac

Writes dist/Slip-<version>.dmg and dist/Slip-<version>-arm64-mac.zip. Both contain Slip.app with the CLI at Contents/Helpers/slip. bun run package:mac writes the unpacked app only, at dist/mac-arm64/Slip.app.

About

A local capture inbox. Select text, press a chord, and it becomes a markdown file.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages