Goblin

One workspace for Git branches and worktrees.

• Bun
• Node.js 24.15+ (LTS) or 26+

• Headless terminals. Server-backed.
• Compact on small screens.
• Local and SSH repos.
• Built for branch flow.

./install.ts                # mac / linux
bun install.ts              # windows
bun run install:app         # any platform

Installs a host-architecture .app to ~/Applications (mac) or %LOCALAPPDATA%\Programs\Goblin[-arm64] (win). See -h for flags.

Install dependencies first, then start server mode:

bun install # first run only
./serve.sh

Builds the web UI, then starts server mode. Default: http://127.0.0.1:32100.

Use --host or --port to override the listen address:

./serve.sh --host 127.0.0.1 --port 32100

On first start the server writes a 25-char token to <dataDir>/server-token and prints it. Paste it once at the browser login gate.

To rotate a generated token, stop the server, reset it, then restart:

bun run reset-token
bun run reset-token -- --data-dir /path/to/data # custom data dir

Tokens supplied with --token are not file-backed and are unaffected.

bun install
bun run dev