CLI & Slash Commands

2-프로세스 아키텍처

User
  │
  ▼
geode CLI  (thin client, ~57 modules)
  │
  │  IPC (unix socket / stdio)
  ▼
geode serve  (daemon, hosts AgenticLoop + state)
  │
  ▼
LLM provider

Thin CLI는 시작 지연을 낮게 유지해 일회성 명령이 즉각적으로 느껴지게 합니다. 데몬은 장기 상태 (AgenticLoop 컨텍스트, MCP 서버 프로세스, 스케줄러)를 보유하므로 /resume이나 멀티턴 흐름이 매번 부트스트랩을 다시 할 필요가 없습니다.

자동 기동

첫 geode 호출 시 데몬이 실행되어 있지 않으면 CLI가 데몬을 spawn하고 프록시 역할을 합니다. geode serve가 명시적 기동이고, /stop이 깨끗하게 종료합니다.

최상위 명령

geode                                      # interactive REPL
geode "summarize the latest AI research"   # NL one-shot
geode serve                                # start daemon
geode version                              # version
geode skill list / skill view / skill manage

슬래시 명령 (REPL)

명령	효과
`/login`	인증 대시보드. Plans, Profiles, Routing. 서브커맨드: `oauth <provider>`, `set-key <plan-id> <key>`, `use <plan-id>`, `route`, `quota`. LLM 에이전트 대응: `manage_login` 도구.
`/model <name>`	활성 모델 전환. `MODEL_SWITCHED` 훅 발화 + 시스템 프롬프트 재빌드.
`/skip`	현재 대기 중인 도구 호출 스킵 (HITL 승인 중 사용).
`/resume`	마지막 세션의 메시지 이력과 상태 복원.
`/clear`	인프로세스 컨텍스트 리셋. 영속 저장 없음.
`/stop`	데몬 정지. 설정 시 세션 저장.
`/clean`	임시 산출물 제거 (캐시, IPC 소켓).
`/uninstall`	GEODE 상태 디렉터리 제거 (확인 후).
`/status`	데몬, 모델, MCP 서버, 훅 상태 표시.
`/help`	인라인 도움말.

`manage_login` 에이전틱 도구

/login의 에이전틱 대응물입니다. 서브커맨드는 슬래시 명령과 거울처럼 대응하고, 반환값은 구조화된 스냅샷 (plans, profiles, routing)입니다. 에이전트가 인증 상태를 스스로 진단하고 사용자에게 왕복하지 않은 채 교정 단계를 제시할 수 있게 합니다.

파일

core/cli/commands.py:41. ModelProfile과 슬래시 명령 디스패치.
core/cli/agentic_loop.py. REPL 부트스트랩과 AgenticLoop 배선.
core/cli/result_cache.py. 콘텐츠 해시 기반 24시간 TTL 캐시.
core/cli/effort_picker.py. 대화형 effort 선택기.

Bash 통합

geode-exec는 현재 셸에서 일회성 에이전트 명령을 실행하며, 출력은 일반 Unix 도구처럼 캡처됩니다. cron이나 스크립팅에 유용합니다.

CLI와 슬래시 명령