Repository navigation
Ghosty is the public product from Shannon Labs. The
ghosty
command, npm package, and release-asset names remain lowercase technical
identifiers. The legacy npm packagedeepseek-tuiis deprecated and
receives no further releases. Users coming from v0.8.x legacydeepseek/
deepseek-tuinames should migrate withdocs/REBRAND.md.
Install
Recommended — npm (one command, both entrypoints)
npm install -g ghostyThe wrapper downloads the matched ghosty and ghosty-tui command assets
from this Release. Both contain the same compiled runtime.
Docker / GHCR
docker run --rm -it \
-e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
-v ghosty-home:/home/ghosty/.ghosty \
ghcr.io/blissito/ghostycode:v0.0.23The image exposes the same runtime as both ghosty and ghosty-tui. The
latest tag is also updated on release.
Cargo (Linux / macOS)
cargo install ghosty-cli --lockedThe Cargo package installs ghosty. Cargo cannot create a second command
alias from one binary target; users who want the shorter spelling can add a
ghosty-tui symlink to that installed executable. The npm, Homebrew, archive,
shell-installer, and container channels install both command names directly.
Manual download — platform archives (recommended)
Each archive below contains the same runtime under the ghosty and
ghosty-tui command names, plus an install script:
| Platform | Archive | Install script |
|---|---|---|
| Linux x64 | ghosty-linux-x64.tar.gz |
install.sh |
| Linux ARM64 | ghosty-linux-arm64.tar.gz |
install.sh |
| Android ARM64 (Termux) | ghosty-android-arm64.tar.gz |
install.sh |
| macOS x64 | ghosty-macos-x64.tar.gz |
install.sh |
| macOS ARM | ghosty-macos-arm64.tar.gz |
install.sh |
| Windows x64 (installer) | GhostyCodeSetup.exe |
NSIS setup |
| Windows x64 | ghosty-windows-x64.zip |
install.bat |
| Windows x64 (portable) | ghosty-windows-x64-portable.zip |
— |
| Windows ARM64 | ghosty-windows-arm64.zip |
install.bat |
| Windows ARM64 (portable) | ghosty-windows-arm64-portable.zip |
— |
Unix (Linux / macOS):
tar xzf ghosty-<platform>.tar.gz
cd ghosty-<platform>
./install.shWindows:
- For the installer path, run
GhostyCodeSetup.exe; it installs
ghosty.exe,ghosty-tui.exe, andghosty.batunder
%LOCALAPPDATA%\Programs\GhostyCode\bin, adds that directory to the
current-user PATH, and creates a Start Menu shortcut that prefers
Windows Terminal (wt.exe) when it is installed. - Extract the archive for your machine:
ghosty-windows-x64.zipor
ghosty-windows-arm64.zip - Double-click
ghosty.bat(not the raw.exe) to launch - Run
install.batto copy the binaries and launcher to%USERPROFILE%\bin - Add
%USERPROFILE%\binto your PATH
The portable Windows archive skips the install script — extract and run ghosty.bat from any directory. The NSIS installer is currently unsigned and may trigger Windows SmartScreen until a signing certificate is wired into the release pipeline.
Each platform also has bare, unarchived ghosty-<platform> and
ghosty-tui-<platform> assets. The seven ghosty-tui-<platform> filenames
attached to v0.9.5 are byte-identical compatibility copies used only to let
already-installed v0.9.4 clients discover and cross this single-binary
transition; current installers do not expose a third runtime. The legacy npm
package deepseek-tui is deprecated and is not republished. For migration
from v0.8.x legacy binary names, see docs/REBRAND.md.
Verify (recommended)
Download the checksum manifests from this Release and verify:
# Linux — archive bundles
sha256sum -c ghosty-bundles-sha256.txt --ignore-missing
# Linux — individual binaries
sha256sum -c ghosty-artifacts-sha256.txt --ignore-missing
# macOS
shasum -a 256 -c ghosty-bundles-sha256.txt --ignore-missing
shasum -a 256 -c ghosty-artifacts-sha256.txt --ignore-missingWhat's in v0.0.23
Added
- Modo de aprobación en ACP.
session/newdevuelvemodes(ask,auto,
yolo) y la opciónmode;session/set_modeoset_config_optionlo cambian y
ghosty avisa concurrent_mode_update.yolodeja pasar sin preguntar lo que
askpediría; los bloqueos duros (piso del shell, auto-review, repo law) siguen
en todos los modos. Antes el adaptador ACP estaba clavado en "preguntar". - Nombre legible del modelo. Las opciones de modelo traen
DeepSeek V4 Flash
como nombre y el id como valor; el catálogo no lo tiene, se sintetiza. - Slash commands en ACP.
available_commands_updateya trae/help,/model,
/provider,/effort,/mode,/usagey/clear; el agente los contesta sin
ir al proveedor. Como Goose, pero con lo que ghosty puede hacer sin la TUI.
Contributors
Thank you to everyone whose reports, PRs, reviews, and reproductions shaped this release.
See CHANGELOG.md for full notes and docs/CHANGELOG_ARCHIVE.md for older releases.