Install LongClaw and open your first project
LongClaw is a single Mac app. There is no account to create and nothing to configure before you start — download it, approve it once, and point it at a folder.
Requirements
macOS 13 or later · Apple Silicon (M1 or newer)
There is no Intel or universal binary in this release, and no Windows or Linux build.
Download
Download LongClaw_0.1.0_aarch64.dmg — 5.0 MB. Open it and drag LongClaw into Applications.
To check you got what we published, compare the checksum:
shasum -a 256 ~/Downloads/LongClaw_0.1.0_aarch64.dmg
# a2b8786b53d8b57d44e6bef7f94f4454c49064d8d43584b5b7680ecc1d7800dfThe same build is attached to the v0.1.0 release on GitHub, with the release notes and source.
If you would rather not run a binary someone else built, the repository is the same code — see building from source below.
Opening the app the first time
LongClaw is signed with an Apple Developer ID certificate and notarized by Apple. Expect one dialog, and expect to click through it once.
Anything you download from a browser is quarantined by macOS and earns a confirmation on first launch however good its signature. What notarization changes is which confirmation. You will see:
“LongClaw” is an app downloaded from the internet. Are you sure you want to open it?
As of the date it was notarized, Apple checked it for malicious software and none was detected.
Click Open. That is the whole step — no System Settings, nothing to authenticate, and macOS does not ask again for this copy of the app.
That second sentence is read from a ticket stapled into the app itself, so it appears whether or not you are online. Nothing has to reach Apple for a first launch to work.
If you see something else
Two other messages exist, and neither should appear for this build. Both mean the copy you have is not the one published here.
Download it again from this page rather than working around it, and never strip
the quarantine attribute to get past either one: that turns the check off for
the single app you were least able to vouch for. If you build from source, the
bar is codesign --verify --deep --strict passing.
Point it at a folder
Launch LongClaw and choose any folder — a git repo or an empty directory. It
creates .longclaw/ inside it and writes nowhere else.
your-project/└── .longclaw/ ├── longclaw.yaml project identity, people, labels ├── AGENTS.md the editing contract agents read └── tickets/
Point it at the same folder as your code. The tickets then live beside the work they describe, which is what lets an agent read a ticket and the code it refers to in one place.
The project key — the LC in LC-1 — prefixes every ticket. Pick it when
you create the project; it becomes permanent once the first ticket exists,
because changing it would rename every ticket and every directory.
Building from source
The desktop app lives in apps/desktop and targets Tauri v2 on macOS. You need
Node.js 22 or newer, Rust with Cargo, and the Tauri v2 macOS prerequisites.
git clone https://github.com/sachinjain024/longclaw.git
cd longclaw
npm --prefix apps/desktop ci
npm run build:appLongClaw source is licensed under the Mozilla Public License 2.0.