MINARA하위 명령
REPL 전에 실행하는 모든 `minara <subcommand>` 호출입니다.
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 및 현재 구현을 기준으로 합니다.
주요 작업 그룹
CLI는 계정, 프로필, 기본 설정, 시장, 거래, 무기한 선물 하위 지갑, 자동 운용, 워크플로, 스킬, 메모리, 파일, 마이그레이션, 진단, 게이트웨이 관리용 하위 명령도 제공합니다. 모든 명령 이름, 플래그, 환경 변수, 예시 값은 안정적인 코드 식별자이며 UI 언어에 따라 달라지지 않습니다.
자금 이동, 출금, 거래 실행 등 위험 작업은 계속 확인 및 권한 정책을 따릅니다. 실행 전에 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과 독립적이며 승인과 거절은 항상 사용자가 명시적으로 수행합니다.