하위 명령

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는 계정, 프로필, 기본 설정, 시장, 거래, 무기한 선물 하위 지갑, 자동 운용, 워크플로, 스킬, 메모리, 파일, 마이그레이션, 진단, 게이트웨이 관리용 하위 명령도 제공합니다. 모든 명령 이름, 플래그, 환경 변수, 예시 값은 안정적인 코드 식별자이며 UI 언어에 따라 달라지지 않습니다.

자금 이동, 출금, 거래 실행 등 위험 작업은 계속 확인 및 권한 정책을 따릅니다. 실행 전에 minara <subcommand> --help를 확인하고 REPL 안에서는 /help로 실시간 카탈로그를 여세요.

`minara research <topic>`

메인 에이전트 루프에서 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과 독립적이며 승인과 거절은 항상 사용자가 명시적으로 수행합니다.

`minara config <action>`

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

목차