如何在 Mac 上卸载 Kiro
Kiro 的 CLI 参考文档把 ~/.kiro 写成全局 agent、提示词、技能、steering、设置和会话的存放处,KIRO_HOME 改的就是这个文件夹,这次测试里 Kiro 应用的对话记录也以纯文本文件存在这里。卸载 Kiro 应用不会删它,要不要留着得你单独决定。Kiro 首次启动时还会在 /usr/local/bin 装一个 kiro 命令,并往 ~/.zshrc 和 ~/.bashrc 里各加一行终端集成,这两样都不会随应用一起消失。本文覆盖从 kiro.dev 官网下载的 Mac 版,以及 Homebrew cask kiro。
登出并退出
如果登录过,先在 Kiro 的账户菜单里找找登出选项。这次测试里 Kiro 把登录令牌存在 ~/.aws/sso/cache/kiro-auth-token.json,放在 AWS CLI 自己的配置文件夹里。Kiro 的 CLI 参考文档里另有一条 kiro-cli logout,会清掉认证令牌和会话凭据,保留 agent 配置、已保存的对话、设置和 MCP 服务器配置。两次测试都没有核实 IDE 自己的登出流程。从应用菜单退出 Kiro,再打开「活动监视器」确认没有残留进程。
把 Kiro 移到废纸篓
在 Finder 打开「应用程序」,把 Kiro 移到废纸篓,这两次测试里它都没有加登录项。
核对应用数据
在 Finder 按 Shift + Command + G,逐个输入下面的路径,不存在的直接跳过。
| 位置 | 装的是什么 | 如何处理 |
|---|---|---|
~/Library/Application Support/Kiro |
应用数据(第二次测试 27 MB) | 想留的内容先备份,再删除 |
~/Library/Preferences/dev.kiro.desktop.plist |
应用偏好设置 | 可以删除 |
~/Library/Saved Application State/dev.kiro.desktop.savedState |
保存的窗口状态 | 可以删除 |
~/.kiro |
全局 agent、提示词、技能、steering、设置和会话,和 Kiro CLI 共用,另有应用装的扩展(第二次测试 12 MB) | 还用 Kiro CLI 或打算重装就留着,否则备份后删除 |
~/.kiro-shared |
应用首次启动时建的编辑器共享状态 | 不留 ~/.kiro 的话一起删掉 |
~/.aws/sso/cache/kiro-auth-token.json |
Kiro 的登录令牌 | 只删这一个文件,~/.aws 里其他东西属于 AWS CLI,别动 |
/usr/local/bin/kiro |
kiro 命令,指向应用内部的链接 |
按下文检查后移除 |
~/.zshrc 和 ~/.bashrc 里的一行 |
在 Kiro 自带的终端里加载它的终端集成 | 按下文删掉这一行 |
~/.kiro 的说明来自 Kiro 的文档,令牌文件、~/.kiro-shared 和命令链接是这次测试在磁盘上看到的。
删掉 kiro 命令和那行终端集成
先看看还剩什么:
ls -l /usr/local/bin/kiro
grep -n 'kiro --locate-shell-integration-path' ~/.zshrc ~/.bashrc
ls -l显示/usr/local/bin/kiro指向Kiro.app,而这个应用已经删了,说明链接留了下来,提示「No such file or directory」说明没有要删的。grep会打印每一行 Kiro 加的内容所在的文件名和行号,没有输出说明两个文件里都没有,提示「No such file or directory」说明那个文件本来就不存在。
这个链接归系统所有,删除时要输管理员密码。先用上面的检查确认它指向你删掉的 Kiro,再运行下面这条,只删这一项,不要动 /usr/local/bin 文件夹本身:
sudo rm /usr/local/bin/kiro
终端集成那一行,用文本编辑器打开 ~/.zshrc,比如运行 open -e ~/.zshrc,删掉 grep 报出来的那一行(以 [[ "$TERM_PROGRAM" == "kiro" ]] 开头,和 Kiro 故障排查页面里写的终端集成写法一样),保存,~/.bashrc 也照样处理。这行只在 Kiro 自己的终端里才会执行,留着不影响平常用的终端,只是指向一个已经不在的命令。文件里别的内容一概不动。
用 Homebrew 安装时
kiro 这个 cask 会把 kiro 命令链接到 Homebrew 自己的 bin 文件夹,普通卸载就会删掉这个链接。它的 zap 清单会把 ~/Library/Application Support/com.apple.sharedfilelist 下 Kiro 的最近文稿记录、~/Library/Application Support/Kiro、~/Library/Preferences/dev.kiro.desktop.plist 和 ~/Library/Saved Application State/dev.kiro.desktop.savedState 移到废纸篓,另外对 ~/.kiro 有一步 rmdir,只在这个文件夹为空时才会删掉它。自己运行 brew uninstall --cask --zap kiro 会把那四项都删掉,不看你在 Mole 里勾了什么,~/.kiro 里只要还存着东西就会留下,~/.kiro-shared、令牌文件和那几行终端集成 Homebrew 都不管。想保留 Application Support 文件夹就不加 --zap:
brew uninstall --cask kiro
Mole 卸载 Homebrew 装的 Kiro 时,rmdir 只移除空文件夹,不算删除用户文件。Mole 会先核对整份删除清单,有未勾选、共用或无法核实的项就不带 --zap,已勾选的残留另行清理。想留 ~/Library/Application Support/Kiro 就取消勾选,单独勾上这个文件夹不代表一定会执行 --zap。Homebrew 的 Kiro cask
核对卸载结果
pgrep -il kiro
ls -d /Applications/Kiro.app
ls -d "$HOME/Library/Application Support/Kiro"
ls -d "$HOME/.kiro" "$HOME/.kiro-shared" "$HOME/.aws/sso/cache/kiro-auth-token.json"
pgrep没有输出,说明没有 Kiro 进程在运行,列出进程说明 Kiro 或某个辅助进程还开着,先退出再继续。ls -d /Applications/Kiro.app打印出路径说明应用还在。ls -d "$HOME/Library/Application Support/Kiro"打印出路径说明应用数据留了下来,不勾这一行时就是这个结果。- 最后一条
ls -d会打印~/.kiro、~/.kiro-shared和令牌文件里还在的那几项,想留 agent、提示词和技能时~/.kiro还在是正常结果,提示「No such file or directory」说明那一项已经不在,可能是你自己删的,也可能本来就没有。
Mole 会列出什么
对于从 kiro.dev 官网下载安装的 Kiro:
~/Library/Preferences/dev.kiro.desktop.plist、~/Library/Saved Application State/dev.kiro.desktop.savedState、更新程序缓存、网页存储,以及~/Library/Application Support/Kiro里的 Chromium 缓存和日志,存在时会列出,默认勾选。~/Library/Application Support/Kiro会列出来供你检查,「卸载时一并移除数据和配置」关闭时不预选,开启后符合条件的应用数据可以预选,想留的设置先备份,或者把这个文件夹取消勾选。~/.kiro、~/.kiro-shared和~/.aws/sso/cache/kiro-auth-token.json也属于要检查的数据,开启这个选项后符合条件的行可以预选,Kiro CLI 或重装还要用的数据要取消勾选,~/.aws下只列这一个令牌文件,从不列整个文件夹。/usr/local/bin/kiro不会被删,终端集成那几行也不会被改,按上面的步骤自己处理。
这次检查覆盖了什么
2026 年 9 月 22 日,从 kiro.dev 下载 Kiro 1.1.14,拷进「应用程序」,用一个开发构建的 Mole 退出并移除,同一轮还有另外八款应用。属于 Kiro 的行都勾上了,应用本体(869.4 MB)和 17.5 MB 支持数据进了废纸篓。全程没有登录 Kiro,~/.kiro 里只有测试之前就有的技能文件(2.4 MB),当时不在 Mole 的列表里,原样留着。事后复查还发现测试当天新建的 ~/.kiro-shared。
2026 年 9 月 28 日,从 kiro.dev 下载 Kiro 1.1.70,登录后把 Vibe 和 Spec 两种模式都用了一遍。它首次启动时装上了 /usr/local/bin/kiro,往 ~/.zshrc 和 ~/.bashrc 各加了一行终端集成,把登录令牌写进 ~/.aws/sso/cache,往 ~/.kiro 导入了三个扩展,还建了 ~/.kiro-shared,没有加登录项。Mole 状态页把 Kiro 显示为一行,20 个进程占 1.60 GB。9 月 29 日用一个开发构建的 Mole 退出并移除,同一轮还有别的 AI 应用,所有行都勾上了,应用本体、Library 里的各行和缓存进了废纸篓。~/.kiro、~/.kiro-shared 和令牌文件那一轮没有列出,原样留着,现在这三项都会列出。kiro 链接留了下来,指向已经删掉的应用,终端集成那两行也还在。登出流程、Kiro CLI 和 Homebrew cask 都没有实测。
