Observal CLI命令速查表15个高频命令掌握Agent安装、扫描与故障诊断【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/ObservalObserval是一个自托管的AI 编程助手扩展注册表内置Insight 洞察引擎。你可以通过observalCLI 将团队的Skills、MCP 服务器和 Agents集中管理、共享并一键安装到 Cursor、Kiro、Claude Code 等编程助手中。本文是一份Observal CLI 命令速查表精选15 个高频命令覆盖Agent 安装、组件扫描、故障诊断三大场景新手照着敲就能上手 一、15 个高频命令速查总表#命令用途场景1observal auth login登录 / 注册服务器首次使用2observal auth whoami查看当前登录用户身份确认3observal config set修改本地 CLI 配置配置管理4observal discover search按任务搜索可用组件发现资源5observal agent pull一键安装已发布的 AgentAgent 安装6observal registry mcp list列出 MCP 组件浏览注册表7observal registry mcp install将 MCP 安装到编程助手组件安装8observal registry skill submit提交并发布 Skill发布组件9observal scan只读扫描本地已装组件状态盘点10observal outdated检查组件是否有新版本版本检查11observal doctor一键诊断本地环境故障诊断12observal ops traces查看会话追踪数据可观测性13observal reconcile补传遗漏的遥测数据数据恢复14observal inbox查看消息与事件通知团队协作15observal self status查看 CLI 版本与更新自身维护所有命令都支持--help查看帮助并可通过--output json输出机器可读的 JSON 结果方便接入脚本与 CI。完整的命令索引可参考 docs/cli/README.md。二、首次上手三步完成登录与配置 第 1 步登录。输入服务器地址默认http://localhost选择邮箱登录observal auth login第 2 步确认身份。随时验证当前登录状态observal auth whoami第 3 步调整配置。例如切换服务器地址或关闭更新检查observal config set server_url https://observal.example.com 小贴士登录成功时CLI 会自动同步内置 Skills、创建初始快照并运行一次doctor体检无需额外操作。详见 docs/cli/auth.md。三、发现与安装让 Agent 一键就位 按任务搜索现成组件不确定团队里有没有现成资源用discover按自然语言任务直接搜索它会一次性检索Agent、MCP、Skill、Hook、Prompt、Sandbox全部类型并标注每项是否已批准、是否适配你的编程助手observal discover search review a pull request for authentication bugs一键安装完整 Agentagent pull是安装的核心命令它会解析 Agent 版本、向服务器请求适配目标编程助手的原生配置、安全合并生成文件、安装捆绑的 Skills 与 Hooks并记录精确的安装状态observal agent pull alice/reviewer --harness kiro --no-prompt支持--dry-run预览将写入的文件而不实际修改磁盘--version可锁定特定版本。命令参考见 docs/cli/pull.md。单独安装 MCP / 发布 SkillMCP 组件支持标准的「列出 → 安装」流程observal registry mcp list observal registry mcp install编写好的 Skill 则可通过submit发布到注册表供团队复用。发布与管理细节见 docs/cli/registry.md 和 docs/cli/skill.md。四、扫描与版本检查摸清本地状态 只读扫描所有编程助手scan会自动检测你机器上安装的每一个编程助手盘点其 MCP 配置与会话遥测 Hook 状态纯只读——不写文件、不联网、不注册observal scan用--harness可限定单一编程助手例如observal scan --harness cursor。更多说明见 docs/cli/scan.md。一键检查过期组件outdated对比锁文件~/.observal/lockfile.json中记录的安装版本与注册表最新版本覆盖已拉取的 Agent 及单独安装的 MCP、Skill、Hook但绝不自动安装更新observal outdated检查结果默认会写入你的 Inbox也可用--no-report静默检查。参见 docs/cli/outdated.md。五、故障诊断三板斧doctor 系列 一键体检doctor会检查本地认证与服务器连通性、注册表锁文件元数据、各编程助手的遥测 Hook 以及内置 Skill 完整性并输出问题清单observal doctor --output json加--yes可自动修复可修复项。完整说明见 docs/cli/doctor.md。生成脱敏诊断包需要向维护者报告问题时用doctor support bundle生成已自动脱敏的诊断归档含最近 2 小时日志observal doctor support bundle --logs-since 2h补传遗漏的遥测如果遥测安装前已有会话、或机器曾离线导致数据未送达用reconcile回填最近 7 天默认的本地会话observal reconcile建议先用--dry-run预览。详见 docs/cli/reconcile.md。六、可观测性查看追踪与洞察 ops是统一的可观测入口常用子命令包括observal ops traces # 查看当前会话的追踪列表 observal ops top --type mcp # 注册表下载量排行 observal ops insights list # 查看 Agent 洞察报告配合 Web 端你可以直观看到每一次工具调用的时间线与思考过程并用 Insight 引擎生成团队级的 Agent 使用洞察报告七、团队协作与自身维护 收件箱observal inbox查看审核请求、团队邀请等事件通知支持按状态与类型过滤。参考 docs/cli/inbox.mdCLI 维护observal self status查看当前版本与可用更新observal self upgrade升级 CLI内嵌服务器observal server start / stop / status管理本地嵌入式服务的生命周期。参考 docs/cli/server.md八、上手建议与学习路径 ✅每天observal scanobserval outdated保持本地组件新鲜排障时先observal doctor --output json再按需reconcile或生成支持包找资源优先observal discover search找不到再用agent pull或单独安装 MCP全命令参考每个子命令都有独立文档页总索引见 docs/cli/README.md从零到第一条追踪的完整流程见 docs/getting-started/quickstart.md掌握以上15 个高频命令你就能覆盖Observal CLI日常使用 90% 的场景从 Agent 安装、组件扫描到故障诊断一套命令行全部搞定 【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/Observal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考