Skip to content

Install

One-liner

Terminal window
curl -fsSL https://raw.githubusercontent.com/wehnnit/DeltaCode/main/install.sh | bash

What the installer does:

  1. Checks for Bun and installs it if it’s missing.
  2. Clones the latest DeltaCode source from GitHub.
  3. Builds the deltacode binary with Bun.
  4. Installs it to ~/.delta/bin and adds that folder to your PATH.

Re-run the same command after a release to update.

From a clone

Terminal window
git clone https://github.com/wehnnit/DeltaCode
cd DeltaCode
bash install.sh

From source

Terminal window
git clone https://github.com/wehnnit/DeltaCode
cd DeltaCode
bun install
bun run dev # run the TUI directly
bun run build # compile a standalone binary

Where things live

DeltaCode keeps its runtime data in ~/.delta/:

PathPurpose
~/.delta/bin/deltacodeThe binary
~/.delta/config.jsonProvider, model, timeouts, permissions
~/.delta/sessions/Per-project conversation history
~/.delta/device-idRandom id used for the free-model fair-use pool
~/.delta/usage.jsonLocal copy of today’s free-model usage

Delete ~/.delta to remove everything (config, sessions, and the binary).

Uninstall

Terminal window
rm -rf ~/.delta

Then remove the # deltacode PATH line from your shell rc file if you want a completely clean removal.

Troubleshooting

zsh: killed right after install — macOS sometimes rejects a freshly built binary’s ad-hoc code signature. Re-sign and reinstall:

Terminal window
codesign --force --sign - ~/.delta/bin/deltacode

command not found: bun — the installer handles this, but if you installed Bun yourself, make sure ~/.bun/bin is on your PATH.

Setup screen doesn’t appear — the app only shows setup on first launch. Run deltacode setup to open it again.