pleumrouter

PleumRouter 공식 터미널 CLI. 쓰던 코딩 에이전트를 한 줄로 PleumRouter에 붙여 실행한다.

설치

Node.js 18 이상 필요(순수 Node CLI라 별도 바이너리 없음).

curl -fsSL https://router.pleum.ai/install | sh   # 원라이너(npm 전역 설치를 감쌈)
npm install -g pleumrouter                          # npm
bun install -g pleumrouter                          # bun

설치 없이 npx pleumrouter <명령> 으로 바로 실행할 수도 있다.

빠른 시작

npx pleumrouter login                          # 브라우저 로그인 + 키 자동 저장
npx pleumrouter launch claude --model claude-sonnet-5
npx pleumrouter launch codex  --model gpt-5.3-codex
npx pleumrouter run gpt-5.4-mini                     # 터미널 채팅
npx pleumrouter run gpt-5.4-mini "한 줄 요약: ..."   # 1회 실행(스크립트용)
cat error.log | npx pleumrouter run gpt-5.4-mini "원인은?"   # 파이프

명령

| 명령 | 설명 | |------|------| | pleum | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 키보드 전용. ↑/↓ 이동 · enter 실행 · → 모델 설정 · esc 종료(서브메뉴에선 뒤로) · ctrl+c 즉시 종료. "에이전트 실행" 진입 시 Claude Code·Codex·opencode·omp·Hermes Agent·Qwen Code·GitHub Copilot CLI 등 지원 에이전트 전체를 설치 여부와 함께 볼 수 있고, 미설치는 확인 후 자동 설치(또는 설정 파일 안내). "설정" 진입 시 언어·에이전트별 기본 모델·계정(로그인/로그아웃)·CLI 업데이트·셸 자동완성을 한곳에서 관리. 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 | | pleum login [--device] | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(~/.pleum/config.json). --device는 SSH·CI | | pleum logout | 저장된 API 키만 삭제(언어·기본 모델 등 나머지 설정은 유지) | | pleum launch [tool] [--model id] [-- args] | 에이전트 실행. -- 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 | | pleum run [model] ["프롬프트"] | 채팅 — 대화형 REPL, 1회 실행, stdin 파이프. 모델 생략 시 화살표로 선택 | | pleum models [query] [--json] | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, --json은 스크립트용 | | pleum models <id> --info | 모델 상세 — 가격·컨텍스트·provider별 지연/처리량/업타임·주간 사용량·형제 모델 | | pleum top [--period daily\|weekly\|monthly] | 라우터 전체 모델 리더보드 + 제공자 점유율(공개 통계) | | pleum balance | 크레딧 잔액 조회 | | pleum usage [--by model\|provider\|api_key\|day] [--days N] | 내 지출 리포트(막대 차트) — 최신 로그인 키 필요(usage:read) | | pleum health | 게이트웨이 연결·DB·Redis·환율·로그인 상태 점검(셀프호스트 진단용) | | pleum lang [code] | 표시 언어 조회/변경 — en(기본)·ko·ja·zh·es. 인자 없이 TTY면 화살표로 선택, PLEUM_LANG 환경변수로도 덮어쓰기 가능 | | pleum completion <zsh\|bash> | 셸 자동완성 스크립트 출력 | | pleum upgrade | 최신 버전으로 재설치 | | pleum version | 버전 출력 |

채팅 REPL 명령

pleum run 안에서:

| 명령 | 설명 | |------|------| | /help, /? | 명령 도움말 | | /model [id] | 세션 유지한 채 모델 전환(인자 없으면 화살표 셀렉터) | | /system [텍스트] | 시스템 프롬프트 설정/확인 | | /clear | 대화 컨텍스트 초기화 | | /models [검색어] | 모델 목록 보기 | | /save [이름], /load [이름] | 세션 저장·복원(~/.pleum/sessions/) | | /verbose | 토큰·속도 통계 토글 | | /exit, /quit | 종료 |

• 응답은 마크다운 스트리밍 렌더(굵게·코드블록 하이라이트·리스트) — 파이프로 빼면 자동으로 원문 그대로
• 응답 후 비용이 현지 통화(한국 ₩)로 표시(스트리밍 마지막 청크 기준)
• Ctrl+C: 생성 중엔 1회로 중단(대화 유지), 대기 중엔 2초 내 2회로 종료
• 여러 줄 입력: """ 한 줄 → 본문 → """ 한 줄
• 이미지: 메시지에 이미지 파일 경로를 그대로 포함 (예: 이 그림 설명해줘 ./shot.png)
• ↑ 로 지난 입력 재호출(히스토리는 ~/.pleum/history에 영속)
• 색상 끄기: NO_COLOR=1 (비TTY·파이프에선 자동 무색)

자동 실행 지원 도구

claude · aider · codex · goose · openhands · opencode · omp · hermes · qwen · copilot — env(또는 격리된 CODEX_HOME/임시 설정 문자열)만 세팅하고 바로 실행한다. 사용자의 기존 설정 파일은 건드리지 않는다.

crush 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.

환경변수

• PLEUM_BASE_URL — 게이트웨이 루트 덮어쓰기(기본 https://router.pleum.ai). 셀프호스트/스테이징용.

개발

npm test          # node --test (의존성 0)
npm link          # 로컬에서 pleum 명령 노출