LoopX macOS LaunchAgent配置指南让Dashboard开机自启【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX是面向 Codex、Claude Code 等长时程 Agent 的控制平面control plane其Dashboard可以实时查看全局任务状态与 Agent 会话。这篇指南将手把手教你在macOS 上配置 LaunchAgent实现LoopX Dashboard 开机自启——重启电脑后无需手动敲命令状态页与 Chat 服务会自动拉起适合需要 7×24 无人值守运行的 Agent 工作流。为什么要配置 macOS 开机自启 默认情况下LoopX 的服务要靠命令行手动启动loopx dashboard启动个人工作区Personal Workspaceloopx serve-status提供独立的全局状态源status feed。关闭窗口或重启电脑后服务就停了。而 macOS 的LaunchAgent机制可以在你登录后自动加载并维持守护进程。LoopX 官方脚本 scripts/macos-dashboard-launchagent.sh 已经封装好全部细节一条命令即可完成LoopX Dashboard 自启动配置。配置前准备检查环境开始之前确认以下前置条件条件说明已安装 macOS脚本仅在 Darwin 系统下工作已安装 LoopX先运行 scripts/install-local.sh 完成本地安装python3在 PATH 中用于状态服务与校验curl可用用于服务健康检查如果还没有 LoopX先克隆仓库并安装git clone https://gitcode.com/GitHub_Trending/lo/loopx.git cd loopx ./scripts/install-local.sh一键安装最快速的 LaunchAgent 配置方法进入仓库目录执行安装命令~/loopx/scripts/macos-dashboard-launchagent.sh install脚本会自动完成四件事生成两个用户级 plist 文件写入~/Library/LaunchAgents/com.loopx.status.plist→ 全局状态源地址http://127.0.0.1:8766/status.jsoncom.loopx.chat.plist→ LoopX Chat 与 Lark 会话面板地址http://127.0.0.1:8767/设置自启动属性RunAtLoad登录即加载KeepAlive进程异常退出后自动拉起并配置 10 秒节流避免崩溃死循环注册并立即启动两个 LaunchAgentlaunchctl bootstrapkickstart验证运行时身份确认 Chat 服务是以当前安装的 LoopX 版本启动防止旧版本进程残留。日志统一输出到~/Library/Logs/loopx/status.out.log、chat.err.log等排查问题时直接翻看即可。 默认模式下控制平面设置是只读的。如果需要 Dashboard 写入注册表等配置可在安装时显式追加--enable-control-plane-write-api参数完成 opt-in。验证开机自启是否生效安装完成后用status子命令检查状态~/loopx/scripts/macos-dashboard-launchagent.sh status正常输出包含三部分LaunchAgentscom.loopx.status: loaded与com.loopx.chat: loaded均为 loaded 即表示已加载URLsChat 与 status 两个访问地址可在浏览器中直接打开确认页面响应Logs四个日志文件的完整路径。如果输出中出现warning: status feed is using an old contract说明状态源还在跑旧契约执行一次restart即可。相关契约细节可参考 docs/status-data-contract.md。日常运维六个常用子命令 ️LaunchAgent 配置完成后日常管理只需要记住这几个命令命令作用install生成 plist 并启动首次配置restart重新生成 plist 并重启服务升级 LoopX 后推荐执行start加载已安装的 LaunchAgentstop停止服务保留 plist下次仍可startuninstall停止服务并删除 plist彻底取消自启动status查看加载状态、URL、日志路径与契约健康度示例~/loopx/scripts/macos-dashboard-launchagent.sh restart ~/loopx/scripts/macos-dashboard-launchagent.sh stop进阶自定义端口与访问地址脚本支持通过环境变量覆盖默认值修改后执行restart生效LOOPX_STATUS_PORT/LOOPX_CHAT_PORT默认 8766 / 8767LOOPX_DASHBOARD_HOST默认127.0.0.1仅本机回环安全默认值LOOPX_STATUS_LIMIT状态源返回的项目数量上限默认 80LOOPX_BIN_DIRLoopX 可执行文件所在目录默认~/.local/bin。例如把状态源改到 9000 端口LOOPX_STATUS_PORT9000 ~/loopx/scripts/macos-dashboard-launchagent.sh restart故障排查清单 现象排查方向status显示not loaded先执行install确认 plist 存在于~/Library/LaunchAgents/提示loopx is not installed重新运行 scripts/install-local.sh页面打不开查看~/Library/Logs/loopx/下的.err.log通常是端口被占用用环境变量换端口升级后行为异常执行restart重写 plist 并重启脚本会自动校验运行时版本身份项目的 examples/macos-dashboard-launchagent-status-smoke.py 是一段完整的冒烟测试脚本演示了如何在假环境下验证 status 输出与 plist 生成逻辑可以作为理解整个配置流程的参考。小结通过本文的LoopX LaunchAgent 配置步骤你只需要一条install命令就能让LoopX Dashboard 开机自启并在后台常驻运行状态源提供全局任务视角Chat 服务承载 Agent 会话配合KeepAlive自动恢复能力长时程 Agent 工作流从此告别重启即断线。更多入门细节可参阅官方指南 docs/guides/getting-started.md。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考