19. CLI 速查表

一份扁平的参考,按用途分组。任何子命令都可以用 hermit <command> --help 看完整选项。

19.1 基本

hermit setup                        # 首次向导
hermit chat                         # 与默认智能体交互式 REPL
hermit chat --agent <id>            # 指定智能体
hermit chat --agent <id> --resume   # 恢复最近一次 CLI 会话

19.2 智能体

hermit agents list
hermit agents create <id> --name "<name>" --workspace-dir <path>
hermit agents enable  <id>
hermit agents disable <id>
hermit agents restart <id>
hermit agents delete  <id>

# 配置是独立的命令树(没有 `hermit agents update`):
hermit config --agent <id> show
hermit config --agent <id> get <key>
hermit config --agent <id> set <key> <value>

# 常用 key:
#   model.provider           anthropic | openai | openrouter | …
#   model.model              <provider 特定的模型 id>
#   model.max_tokens         <int>
hermit config --agent <id> security set access public|protected|private

19.3 用户(成员)

当前 CLI 没有 hermit users 命令。通过 Web 管理界面的 Users 面板、/api/agents/<id>/members API,或 owner-only 的智能体工具(user_list、user_role_set、user_identity_link、user_identity_unlink、user_merge)管理成员。

19.4 指令

hermit instructions list   [--agent <id>|--all]
hermit instructions get    <key> --agent <id>
hermit instructions set    <key> "<text>"      [--agent <id>|--all]
hermit instructions set    <key> --file <path> [--agent <id>|--all]
hermit instructions append <key> "<text>"      [--agent <id>|--all]
hermit instructions remove <key>               [--agent <id>|--all]

19.5 技能

hermit skills list
hermit skills assignments
hermit skills scan
hermit skills register <name> --path <dir>
hermit skills enable  <name> [--agent <id>|--all]
hermit skills disable <name> [--agent <id>|--all]
hermit skills delete  <name>

19.6 MCP 服务

hermit mcp list
hermit mcp assignments
hermit mcp enable  <name> [--agent <id>|--all]
hermit mcp disable <name> [--agent <id>|--all]

19.7 通道

当前 CLI 没有 hermit channels 命令。在 Manage → Channels 或通过 /api/agents/<id>/channels API 配置通道。

19.8 定时任务

hermit schedules create --type cron --cron "<expr>" --prompt "<text>" --agent <id>
hermit schedules create --type once --run-at "<iso>" --prompt "<text>" --agent <id>
hermit schedules list   --agent <id>
hermit schedules pause  <id> --agent <id>
hermit schedules resume <id> --agent <id>
hermit schedules delete <id> --agent <id>
hermit schedules runs   <id> --agent <id>

19.9 密钥

hermit config --agent <id> secrets list
hermit config --agent <id> secrets set    <KEY> <value> [--pass-through|--no-pass-through]
hermit config --agent <id> secrets remove <KEY>

19.10 策略

hermit config --agent <id> policy list
hermit config --agent <id> policy set <resource-key> '<grants-json>' --effect allow|deny|require_approval
hermit config --agent <id> policy delete <resource-key> [--effect allow|deny|require_approval]
hermit config --agent <id> approvals list [--status pending|approved|rejected|expired]
hermit config --agent <id> approvals review <request-id> approved|rejected

19.11 帮助与诊断

hermit --help
hermit <command> --help
hermit doctor                     # 连接 + 认证健康检查
hermit --version

19.12 --all vs --agent

绝大多数写命令二选一:

  • --agent <id> —— 作用于一个智能体。
  • --all —— 作用于本实例的每个智能体。

读命令(list、get)通常需要 --agent 限定;省略时可能落到已配置的默认智能体。

19.13 指引