Get started with Locus: build, install and launch

Get started

One command to build, install and launch

Locus is a Go and Wails application. The installer builds it, installs to %LOCALAPPDATA%\locus\, registers auto-start on login and launches it, all per-user with no administrator rights.

Prerequisites

Go 1.21+, Node.js 20+ and Windows 10 or 11. WebView2 ships with Windows 11; on Windows 10 install it from Microsoft. The Wails CLI is installed for you if missing.

Install

Run .\install.ps1 from the project root. It builds the single locus.exe, installs it, sets up Claude Code hooks and the skill, then launches.

Restart Claude CLI

Restart Claude Code so the hooks take effect. Then run /go locus at the start of a session to load the skill context.

Uninstall any time

.\uninstall.ps1 stops the app, removes the startup key and deletes the install directory. Your board data is kept. Add -PurgeData to remove it too.

# One-shot install: build, install, auto-start, launch
git clone https://github.com/oernster/locus
cd locus
.\install.ps1

# Or a development build with hot reload
go install github.com/wailsapp/wails/v2/cmd/wails@latest
cd frontend && npm install && cd ..
wails dev

# Production build (outputs build\bin\locus.exe)
wails build