Install
One-liner
curl -fsSL https://raw.githubusercontent.com/wehnnit/DeltaCode/main/install.sh | bashWhat the installer does:
- Checks for Bun and installs it if it’s missing.
- Clones the latest DeltaCode source from GitHub.
- Builds the
deltacodebinary with Bun. - Installs it to
~/.delta/binand adds that folder to your PATH.
Re-run the same command after a release to update.
From a clone
git clone https://github.com/wehnnit/DeltaCodecd DeltaCodebash install.shFrom source
git clone https://github.com/wehnnit/DeltaCodecd DeltaCodebun installbun run dev # run the TUI directlybun run build # compile a standalone binaryWhere things live
DeltaCode keeps its runtime data in ~/.delta/:
| Path | Purpose |
|---|---|
~/.delta/bin/deltacode | The binary |
~/.delta/config.json | Provider, model, timeouts, permissions |
~/.delta/sessions/ | Per-project conversation history |
~/.delta/device-id | Random id used for the free-model fair-use pool |
~/.delta/usage.json | Local copy of today’s free-model usage |
Delete ~/.delta to remove everything (config, sessions, and the binary).
Uninstall
rm -rf ~/.deltaThen 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:
codesign --force --sign - ~/.delta/bin/deltacodecommand 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.