Uninstall
Remove koshi and every file it wrote — config, themes, logs, update state, cache, crash reports, and runtime files — on Linux, macOS, or Windows.
End every koshi session before removing files. Detaching is not enough: a detached session is still running.
koshi list-sessions
koshi kill-session <NAME_OR_ID>The commands below delete your koshi configuration, saved profiles, and custom themes. Copy anything you want to keep out of the config directory first.
Linux
Remove a script-installed binary:
sudo rm -f /usr/local/bin/koshiRemove config, logs, crash reports, update state, cached data, and runtime files:
rm -rf "${XDG_CONFIG_HOME:-$HOME/.config}/koshi"
rm -rf "${XDG_DATA_HOME:-$HOME/.local/share}/koshi"
rm -rf "${XDG_STATE_HOME:-$HOME/.local/state}/koshi"
rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}/koshi"
if [ -n "${XDG_RUNTIME_DIR:-}" ]; then
rm -rf "$XDG_RUNTIME_DIR/koshi"
fimacOS
For a script install:
sudo rm -f /usr/local/bin/koshiFor a Homebrew install:
brew uninstall --force koshi
brew untap gohyuhan/koshiThen remove config, logs, crash reports, update state, cache, and runtime files:
rm -rf "$HOME/Library/Application Support/koshi"
rm -rf "$HOME/Library/Caches/koshi"Windows
For a Scoop install:
scoop uninstall koshi
scoop bucket rm koshi
scoop cache rm "koshi*"For a PowerShell-script install, drop the PATH entry and the install directory:
$InstallDir = Join-Path $env:LOCALAPPDATA "koshi"
$UserPath = [Environment]::GetEnvironmentVariable(
"Path",
[EnvironmentVariableTarget]::User
)
$CleanPath = (($UserPath -split ";") | Where-Object {
$_ -and $_ -ne $InstallDir
}) -join ";"
[Environment]::SetEnvironmentVariable(
"Path",
$CleanPath,
[EnvironmentVariableTarget]::User
)
Remove-Item $InstallDir -Recurse -Force -ErrorAction SilentlyContinueThen remove what is left:
Remove-Item (Join-Path $env:APPDATA "koshi") `
-Recurse -Force -ErrorAction SilentlyContinue
Remove-Item (Join-Path $env:LOCALAPPDATA "koshi") `
-Recurse -Force -ErrorAction SilentlyContinue