CLI 레퍼런스
⛔ 이 문서는 «생성물»이다.
bun scripts/gen-docs-cli-reference.ts가 실물--help에서 만든다. 손으로 고치지 마라 — 다음 생성에서 지워진다.🚨 ⛔ 「생성물」이라는 말이 「늘 최신」을 뜻하지 «않는다». 📏 2026-09-22 실측: 이 파일이 두 군데 늙어 있었다 — 같은 창이
provider:set도움말과wf노드 목록을 고쳐 놓고 재생성을 안 했다. ⇒ 재생성 방아쇠가 «없다». ✅ 그러니--help문면을 바꾼 PR 은 이 파일을 같이 낸다. 📏 늙었는지 재는 법:bun scripts/gen-docs-cli-reference.ts | diff - docs/site/cli-reference.md
📏 최상위 69 · 하위 507 ⇒ 잎 명령 약 576
하니스 — 골을 쏘고 런을 몬다
이 저장소의 척추다.
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous harness | 18 | dev-harness worktree 수명 — 워크트리 생성(worktree add)·조회(worktrees)·정리(clean)·프로세스 관찰(processes) |
elanous dev (drive) | — | ⛔ drive 별칭으로 부르면 옵션은 여덟뿐 (--goal · --attach · --max-steps · --poll-ms · --model · --cwd · --worktree · --json) — --attach <ref> 는 이미 있는 PTY 를 몬다(생략하면 셸 명령을 새로 띄운다). 나머지는 전부 dev 전용이고 drive 에서는 거부된다. dev 와 drive 는 |
elanous self | 92 | Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상 |
elanous pr | 3 | PR landing commands |
elanous repo | 12 | 명시적 로컬 저장소 GitHub 비공개 발행 |
PTY 컨트롤 — 남의 화면을 밖에서 읽고 쓴다
elanous 고유 축.
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous pty | 31 | PTY control — is an id, nickname, or unique prefix (see 'pty list') |
elanous agent-mission (codex) | 22 | Agent-mission CLI — 외부 에이전트 backend(codex[디폴트]·claude·gemini·grok·aside) 미션·리뷰 워치·셋업. codex 는 deprecated alias(하위호환). |
elanous acp | 7 | Agent Client Protocol — spawn ACP agents (claude-code, codex, gemini) |
elanous attach | — | ACP client for the running elanous daemon. Three modes: handshake-only (default), one-shot (--message), interactive REPL (--interactive). Local (unix socket) or remote (--host / --url) over Tailscale. |
elanous browser | 4 | 🎨 봇이 모는 브라우저 페이지 «안»에 그린다 — 도형 · 캔들 차트 · 지우기 |
관측 — 관측 · 자기인지 · 셀프힐링
제1원칙이 사는 자리.
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous logs | 8 | 전 서피스 로그 조회/실시간 tail (adb logcat 동형) — level/surface/category/grep 필터 |
elanous ops | 11 | 운영 관측(READ-ONLY) — 미션·태스크·계약 루프·오케스트레이터 현재 상태·이상·전이. --json 프로그래매틱. |
elanous signals | — | 신호 파이프라인 퍼널(READ-ONLY) — 유입→분류→critical→2차→확정→집행 각 단계 수·통과율·갭. 게이트 튜닝 판단 근거. |
elanous loops | — | 루프 에이전트 자산 원장(READ-ONLY) — 목표까지 반복하는 실행 주체(계약/자율/코디네이터)를 미션연관·독립·라이프사이클별로. 좀비(TTL 초과) 감지. |
elanous fleet | 4 | 멀티 elanous 인스턴스 통합 뷰(READ-ONLY 연합) — 등록 인스턴스·보유 스토어 매트릭스. logs instances 일반화(kubectl get nodes 등가). 연합 조회는 session list --all-instances 등. |
elanous where | — | 지금 이 프로세스가 어느 인스턴스(prod/test)에 속하는지 와 그 이유를 보여준다 (READ-ONLY) |
elanous status | — | Show current sync status and detect changes since last sync |
elanous history | — | Show sync history |
elanous inspect | — | Inspect remote targets without syncing |
대화 · 세션
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous chat | — | Send one message in the active session (or a new one) and print the reply |
elanous ask | — | Alias for elanous chat --new: send one query and print the reply |
elanous agent | 1 | Single-turn agent — same as chat but with the tool loop on by default (Read/Grep/Glob/ListDir/Edit/Write + Bash). Use this when the LLM needs to inspect files / run commands / debug itself. |
elanous repl | — | Sticky multi-turn REPL — same session across turns, no per-turn process boot. Drives chat / agent / scenario from one shell. Uses --new for a fresh session, --session |
elanous session | 45 | Manage conversation sessions |
elanous memory | 20 | Persistent memories injected into every chat turn (user / feedback / project / reference) |
elanous docs | 5 | 문서 지식 검색/관리 — knowledge.db 벡터+BM25 하이브리드 (DocOps) |
프로바이더 · 모델
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous provider (providers) | 1 | Show the currently active LLM provider + model + auth status |
elanous provider:set | — | Swap active LLM provider in config.json (auto-backs-up the previous config to its .bak sibling — ⛔ the path is the ACTIVE config, not a fixed one: run elanous where to see it). Useful for A/B testing model behaviour — |
elanous provider:use | — | Jump to a specific rotation entry by label / provider name / model substring. Auto-backs-up config.json before the switch (restore with elanous provider:restore). Example: elanous provider:use opus, `elanous provider:use g |
elanous provider:rotate | — | Cycle through the rotation list. With no argument: advance one step. Sub-commands: list (print list), reset (jump to first entry), add <provider> [-m model] [-l label] (append), remove <label>, clear (wipe rota |
elanous provider:restore | — | Restore config.json from the automatic backup written by elanous provider:set. |
elanous tier | 6 | LLM tier→모델 SSOT 조회 — provider별 budget/balanced/better/best/loaded 사다리(llm-tier-map). "grok low" 같은 별칭 흡수. |
elanous registry | 3 | 모델 카탈로그(catalog/=SSoT) 관측 — 라우팅 맵 drift 감사 |
elanous local | 23 | Local OpenAI-compatible LLM — ping, list, test, setup |
elanous model-watch | 1 | 제공자 문서에서 카탈로그 변경 제안을 만든다; 자동 적용하지 않는다 |
elanous usage | — | 계정마다 행으로 「지금 쓸 수 있는 것이 얼마나 남았나」를 본다 (크레딧 축 ≠ 구독 축) |
elanous login | 4 | Authenticate to an LLM provider via OAuth |
elanous token | 2 | Manage the ACP admin token |
자동화 — 워크플로 · 스케줄 · 오토파일럿
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous wf (workflows) | 15 | Run YAML DAG workflows (workflow-runtime · prompt|bash|skill|cft|approval|if|switch|iteration|classify|extract|set|filter|template|http|showroom|scheduleTrigger|webhookTrigger|discordTrigger|telegramTri |
elanous schedule | 16 | 스케줄/크론 CRUD (registry·crontab·기억 정합). --json 으로 프로그래매틱 소비. |
elanous autopilot | 50 | Mission-driven autopilot — runs an ACP agent against a single mission with safety + budget guards |
elanous scheduler (sched) | — | Retired — scheduling is now a workflow-runtime Schedule Trigger node (elanous wf) |
elanous task (tasks) | — | Retired — use elanous wf (workflow-runtime DAG · supersedes scheduler v2) |
설치 · 진단 · 설정
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous setup | — | Check OpenAI Codex setup and guide each missing credential step |
elanous doctor | — | Reports whether credentials resolve and where each resolution comes from |
elanous onboarding | — | Run the first-run wizard. Pass a step name (llm|skills|obsidian|telegram|discord|voice-ai) to run only that step. |
elanous config | 14 | Inspect and edit ~/.config/elanous/config.json |
elanous keys | — | Print all keybindings + slash commands. Optional context filter. |
elanous leader | 5 | 운영 리더(머신 전역 prod 지정) 조회·승격 — 동일 레포 다중 체크아웃에서 "어디가 운영인가"의 단일 권위 |
elanous sync | — | Sync skills to local or remote machines |
elanous theme | 5 | Inspect and configure dashboard themes |
elanous status-bar | — | Print the status pills (working dir + git + model) — pipe into shell prompt or preview |
표면 — NEXUS · MCP · 채널
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous nexus | 40 | NEXUS — unified TUI shell + supervisor + meta-api (Phase N-1, opt-in) |
elanous mcp | 18 | MCP (Model Context Protocol) server / client integration |
elanous telegram-test | — | Standalone TEST telegram bot (separate token) — full Q&A/HITL/delegate path with ISOLATED state, WITHOUT touching the production daemon. Restart THIS process to test code changes; the live daemon stays up. |
elanous discord-test | — | Standalone TEST discord session (SAME app/token, scoped to discord.testChannel.channelId) with ISOLATED state, WITHOUT touching the production daemon. Restart THIS process to test code changes; the live daemon stays up. |
elanous voice | 8 | Voice tier + identity helpers (STT slider · TTS voice id · cost preview) |
elanous publish | 7 | external-markdown 게시 라이프사이클 — 만료 게시물 GC(S3 콜드 백업·삭제 아님) |
판정 · 도메인
이 회사 전용에 가깝다 — 공개 배포에서 갈릴 축.
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous decide | — | Jev(System One)에게 «확률이 붙은» 판정 하나를 묻는다 — 기본 예/아니오. 📚 docs/manual/MANUAL-typesafe-jev-system-one-2026-09-20.md |
elanous decide-recipe | — | 이름 붙은 레시피로 판정한다. 질문은 recipes/ |
elanous ax-screen | — | 업무 목록을 Jev 로 스크리닝해 자동화 후보 순위를 낸다. 📚 docs/manual/MANUAL-ax-task-screening-2026-09-20.md |
elanous finance | 3 | Native finance/investment logic (SSOT) — skill thin-client 진입점 |
elanous ad | — | 판매 URL, 텍스트 브리프 또는 실사 이미지로 광고 제작 파이프라인을 시작 |
elanous buzz | — | 커뮤니티 버즈 온디맨드 브리핑 — 수집분 조회 + stale(밤/주말)이면 실시간 그랩 폴백. 매매 아님(정성 신호). |
elanous factcheck | — | 팩트체크 — 내부(발송 리포트/대화) 먼저 검색 → 없으면 외부(X/레딧/웹) 에스컬레이션 |
elanous measure-fabric-arc-ab | — | Fabric 분해 아크의 축소/전체 그라운딩 A/B를 관측하고 표와 JSON 결과를 낸다 |
게이트웨이를 통과하는 git · gh
락 재시도와 파이프 가시 종료코드를 붙인다.
| 명령 | 하위 | 무엇을 하나 |
|---|---|---|
elanous git | — | Run git through the git-fs gateway and append a pipe-visible exit status |
elanous gh | — | Run gh with retry-safe reads and append a pipe-visible outcome |
아직 절에 못 넣은 것
⚠️ 이 목록이 비지 않으면
SECTIONS가 실물보다 낡은 것이다 — 절을 늘려라.
elanous questions— AskUserQuestion 대기를 조회하고 파일 답을 기록한다