子命令

REPL 前子命令由 apps/agent/src/gateway/cli.ts 分發，每個子命令會委託給 apps/agent/src/gateway/*-cli.ts 下的專用模塊。每次調用運行一次、輸出結果並退出。

`minara` / `minara chat`

啟動交互式 REPL。裸 minara 和 minara 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 和當前實現為準。

`minara plugins [action]`

從執行中的本機 Gateway 讀取統一 Plugin 目錄。此命令為唯讀，顯示的 Skill、MCP、Connector、設定和帳戶狀態與 GET /v1/plugins 一致。

minara plugins                       # list
minara plugins list [--json]
minara plugins show <id> [--json]

list（預設）：列出所有可用 Plugin 及其設定狀態。
show <id>：顯示一個 Plugin 的清單和元件摘要。
--json：不重新格式化，直接傳回 Gateway 回應。

執行前使用 minara serve 啟動本機 Gateway。如果 Gateway 要求 bearer token，請為兩個處理程序設定相同的 GATEWAY_AUTH_TOKEN。

實作位於 apps/agent/src/gateway/plugin-cli.ts。

常用操作組

CLI 還提供用於賬戶、資料、偏好、市場、交易、永續子錢包、自動駕駛、工作流、技能、記憶、文件、遷移、診斷和網關管理的子命令。所有命令名、標誌、環境變量和示例值均為穩定的代碼標識符，不隨界面語言改變。

資金移動、提現、交易執行和任何有風險的操作仍會遵循確認與權限策略。執行前檢查 minara <subcommand> --help，並在 REPL 內使用 /help 獲取實時命令目錄。

`minara research <topic>`

在主 Agent 循環中載入 deep-research skill，按問題複雜度、證據缺口和使用目的調整研究深度，產生報告並返回最終回答。無需選擇檔位。

minara research "BTC ETF flows this quarter"

`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，核准或拒絕一律由使用者明確執行。

讀寫 settings.json 的 safety、financialProfile、preferences 配置區和模型固定項。list 列出目前值，path 顯示檔案路徑，get --explain 顯示偏好來源，model 開啟模型選擇器。preferences.<schemaKey> 經過型別驗證和並行版本檢查；明確執行 config set 即確認關鍵設定修改。網頁設定保留確認對話框，確認後直接儲存至同一個檔案。憑證透過 minara auth 管理。

金額額度使用 preferences.safety.maxTransactionAmount 和 preferences.safety.dailySpendLimit，也可在 Settings > Preferences > Safety 中修改。

minara config list
minara config path
minara config get preferences.agentRuntime.goalMaxTurns --explain
minara config set preferences.agentRuntime.goalMaxTurns 40
minara config set preferences.safety.skipFundConfirm true
minara config model