Kiwi Code DocsInstallation
How to install Kiwi Code on your machine.
Installation
Requirements
- Python: 3.11, 3.12, or 3.13
- OS: Linux, macOS, Windows
- Git: Required for worktree mode (
kiwi -w)
Install
Choose the method that works best for your setup.
pip install kiwi-aipipx installs Kiwi Code in an isolated environment and makes kiwi and kiwicli available globally.
pipx install kiwi-aiuv pip install kiwi-aiUpgrade
pip install --upgrade kiwi-aipipx upgrade kiwi-aiuv pip install --upgrade kiwi-aiVerify Installation
kiwi --version
# kiwi 0.0.445
kiwicli --version
# kiwicli 0.0.445
kiwi-runtime --help
# usage: kiwi-runtime connect [-h] --server SERVER ...Configuration Files
Kiwi Code stores its data under ~/.kiwi/:
| File | Purpose |
|---|---|
~/.kiwi/tokens.json | Authentication tokens (permissions: 0600) |
~/.kiwi/settings.json | UI settings (theme, etc.) |
~/.kiwi/kiwi_tui.log | Application logs (rotated at 10MB, kept 7 days) |
~/.kiwi/runtimes/ | Runtime process state |
~/.kiwi/runs/ | Checkpoint/rewind data |
Environment Variables
| Variable | Purpose |
|---|---|
KIWI_HOME_DIR | Override the ~/.kiwi directory location |
KIWI_DISABLE_REEXEC | Disable process re-execution on startup |
Uninstall
# pip
pip uninstall kiwi-ai
# pipx
pipx uninstall kiwi-ai
# Clean up data
rm -rf ~/.kiwi