MINARA
参考CLI 参考

子命令

所有在 REPL 前运行的 `minara <subcommand>` 调用。

REPL 前子命令由 apps/agent/src/gateway/cli.ts 分发,每个子命令会委托给 apps/agent/src/gateway/*-cli.ts 下的专用模块。每次调用运行一次、输出结果并退出。

minara / minara chat

启动交互式 REPL。裸 minaraminara chat 是等价入口。首次运行向导(如需要)完成、已配置的 MCP 服务器连接、速查表打印后,进程进入 readline。

minara
minara chat

每次 REPL 运行都有各自持久化的聊天会话,按轮记录到 SQLite 存储。可在 REPL 中用 /resume 恢复过去的 CLI 会话。REPL 内可用功能请参阅斜杠命令

minara setup / minara init

运行交互式首次使用向导。它配置 LLM 提供商;Minara 网关为默认值(无需第三方密钥),Anthropic、OpenAI、OpenRouter、Kimi 和 xAI 是自带密钥选项。随后登录 Minara、探测 ~/.minara/ 中可导入的状态、搭建工作区、运行 doctor 并打印速查表。

minara setup
minara init       # alias

实现位于 apps/agent/src/gateway/setup-wizard.ts

minara auth <action>

统一凭据入口:LLM 提供商登录/退出/状态、出站消息提供商凭据和数据源 API 密钥。

minara auth                        # status (default)
minara auth status
minara auth login <provider>       # sign in / save an LLM provider credential
minara auth logout <provider>      # clear an LLM provider profile
minara auth messaging              # configure outbound messaging providers
minara auth key list               # data-source API keys (masked)
minara auth key set <ENV_VAR> <value>
minara auth key remove <ENV_VAR>
  • status:输出所有已配置认证资料和已设置的 *_API_KEY 环境变量摘要。
  • login <provider>:认证 LLM 提供商;与顶级别名 minara login 使用相同解析。
  • logout <provider>:清除已保存的 LLM 提供商资料;与 minara logout 相同。
  • messaging [list|add|test|remove] [id]:配置出站消息提供商。
  • key list:显示数据源 API 密钥的掩码值和来源,原始密钥保留在磁盘上。
  • key set <ENV_VAR> <value>:保存数据源 API 密钥覆盖项;该值是操作者主机上的位置 CLI 参数,绝不会传给 LLM。
  • key remove <ENV_VAR>:清除数据源 API 密钥覆盖项。

实现位于 apps/agent/src/gateway/auth-command.ts。完整的命令、标志、示例及返回码以 CLI --help 和当前实现为准。

常用操作组

CLI 还提供用于账户、资料、偏好、市场、交易、永续子钱包、自动驾驶、工作流、技能、记忆、文件、迁移、诊断和网关管理的子命令。所有命令名、标志、环境变量和示例值均为稳定的代码标识符,不随界面语言改变。

资金移动、提现、交易执行和任何有风险的操作仍会遵循确认与权限策略。执行前检查 minara <subcommand> --help,并在 REPL 内使用 /help 获取实时命令目录。

minara factors <action>

创建和控制持久化时序因子研究任务,查看候选、审核合格因子,并查询统一指标目录。

minara factors campaign create --spec <json-or-file> [--idempotency-key <key>] [--json]
minara factors campaign list|show <id> [--json]
minara factors campaign pause|resume|cancel <id> [--json]
minara factors campaign extend-budget <id> --extension <json-or-file> [--json]
minara factors campaign fork <id> --input <json-or-file> [--idempotency-key <key>] [--json]
minara factors candidates list --campaign <id> [--status <status>] [--limit <n>] [--cursor <cursor>] [--json]
minara factors candidates show <id> [--json]
minara factors library list [--include-archived] [--limit <n>] [--cursor <cursor>] [--json]
minara factors library show <factor-id> [version] [--json]
minara factors library approve|reject <candidate-id> --input <json-or-file> [--json]
minara factors library archive <factor-id> <version> --reason <text> [--json]
minara factors metrics list|show <metric-id> [--json]
minara factors providers list [--json]
minara factors providers add|test --definition <json-or-file> [--credential <value>] [--json]
minara factors providers inspect --url <openapi-url> [--network-trust public|private_confirmed] [--json]
minara factors providers enable|disable|archive|check <source-id> [--json]

优化目标决定优先搜索什么以及候选如何排序;停止条件决定何时暂停或结束,不改变质量门槛。因子研究独立于 Strategy RL,批准或拒绝始终由用户明确执行。 Provider 支持只读 JSON/CSV 接口和 OpenAPI 3.x 发现;凭据独立保存,--json 永远不会输出明文。

本页目录