Luwu 陆吾

luwu 命令

命令 作用
luwu 你的电脑和终端的控制台。首次运行时会登录并设置这台电脑。
luwu login / logout 在这台电脑上登录或退出登录。 luwu login --browser 在 app.luwu.dev 上批准这台电脑即可登录(Luwu Bar 就用这种方式)。
luwu up / down 启动或停止让这台电脑可被访问的后台服务。
luwu status 显示你的账号、这台电脑和服务的状态。
luwu ls [--json] 列出你的电脑、上面的 tmux 会话和智能体状态,例如“claude · needs you”。
luwu attach [computer] [session[:window]] 打开另一台电脑上的终端。按 Ctrl-] 退出。
luwu fs ls|get|put|find|mkdir|mv|rm 操作你电脑上的文件。
luwu share <computer> <session>[:<window>] 把一个窗口分享给朋友。另有 luwu share ls、luwu share end <id>。
luwu join <code|link> 加入别人分享给你的窗口。
luwu agent [--on <电脑>] ls|new|watch 智能体模式:在一台电脑上启动 Claude 并跟进,批准它的每一步。
luwu hooks [install|uninstall] 为 Claude Code 和 Codex 设置智能体通知。
luwu update [--check] [--auto on|off] 安装最新版本。--on <电脑> 可以更新你的另一台电脑。
luwu token [ls|new 名称|revoke ID] 给脚本和 CI 用的访问令牌。设置好 LUWU_TOKEN 后,luwu notify --title "构建通过" [--body …] [--url https://…] 可以在任何地方给你的手机发通知,不需要配对电脑。
luwu shell-integration [install|uninstall] 让 Luwu 知道每条命令和它的输出在哪里(zsh、bash、fish;只在 tmux 里生效)。这样 App 能把上一条命令的输出原样存到笔记,并标出上一条命令失败的窗口。
luwu unpair 将这台电脑从你的账号中移除。
luwu version 显示已安装的版本。

Luwu Bar(macOS)

这台 Mac 上 Luwu 服务的菜单栏应用:显示这台 Mac 能否从你的设备访问(经过哪些中继)、哪些智能体在等你,还可以暂停、恢复和更新 Luwu。下载 Luwu Bar(macOS 13 或更新版本),解压后移到“应用程序”。它使用你已经安装的 luwu,不会取代它。

文件存放位置

Luwu 保存的所有内容都在 ~/.luwu 中(设置 LUWU_HOME 可以改到别处):包括这台电脑的密钥、服务的状态和日志(~/.luwu/logs/luwud.log)、上传收件箱以及 files.json。

服务在 macOS 上以 launchd agent(dev.luwu.luwud)运行,在 Linux 上以 systemd 用户服务运行。luwu up 负责安装它,luwu down 负责停止它。

更新

从 Luwu 0.2.3 起,运行 luwu update 即可。它会下载最新版本、校验 checksum,然后让服务换用新版本重新启动。tmux 会话会继续运行,手机几秒后会重新连接。如果新版本没能正常启动,会自动退回原来的版本。

有新版本时,服务也会在没有人使用终端的时候自动更新。要关闭自动更新:luwu update --auto off。在 App 里,运行旧版本的电脑会显示更新按钮。

更早的版本:重新运行安装脚本(curl -fsSL https://luwu.dev/install.sh | sh),然后执行 luwu down && luwu up。