Mars Agent CLI

用手机远程接管你电脑上的 Claude Code。

快速开始

在你的项目目录里运行:

npx @aubea/mars

终端打印一个二维码后,Mars 转入后台运行(关掉终端也继续)。打开 Mars App(登录后)→ 设置 → 配对的电脑 → 扫码,即可在手机上:

• 发消息、看流式回复与工具卡
• 审批高风险操作(可 Face ID 二次确认)
• 审查 diff、提交、切分支、多 Agent 分派与合并评审
• 看成本 / 今日本周 / Agent 赛马

前提

• 电脑已安装并登录 Claude Code(Mars 负责远程接管,不替代它)
• Node.js ≥ 18

常用参数

npx @aubea/mars --repo /path/to/project   # 指定项目目录(默认当前目录)
npx @aubea/mars --model opus              # 指定模型
npx @aubea/mars --open                    # 启动即打开一个会话(电脑端发起、手机接管)
npx @aubea/mars --foreground              # 前台运行(调试用,不进后台)

后台运行控制

mars 默认后台启动:打印二维码后转后台,关闭终端也继续。日志 ~/.mars/daemon.log,PID ~/.mars/daemon.pid。

npx @aubea/mars --status                 # 查看是否在跑 / 重看二维码
npx @aubea/mars --stop                   # 停止后台 daemon

已配对过的电脑重连免扫码。撤销配对:删除 ~/.mars/devices.json。