ethos-router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 베오르 주식회사 (Veor Inc.)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# 에토스 라우터 명령줄 도구
+
+키를 손으로 옮기지 않고 붙이는 길입니다. 한 번 로그인하면 코딩 도구가
+에토스 라우터를 보게 됩니다.
+
+```bash
+npm i -g ethos-router
+
+ethos login     # 브라우저에서 승인하면 키가 저장됩니다
+ethos claude    # Claude Code 를 에토스 라우터로 실행
+ethos codex     # Codex 를 에토스 라우터로 실행
+```
+
+## 명령
+
+| 명령 | 하는 일 |
+|---|---|
+| `ethos login` | 브라우저에서 승인하고 키를 받습니다 |
+| `ethos logout` | 키를 정지하고 설정을 지웁니다 |
+| `ethos whoami` | 어느 워크스페이스로 붙어 있는지 봅니다 |
+| `ethos claude [인자…]` | Claude Code 를 에토스 라우터로 실행합니다 |
+| `ethos codex [인자…]` | Codex 를 에토스 라우터로 실행합니다 |
+| `ethos env` | 다른 도구에 넣을 환경변수를 찍습니다 |
+| `ethos models [검색어]` | 쓸 수 있는 모델과 단가를 봅니다 |
+| `ethos chat "질문"` | 한 번 물어보고 답과 든 비용을 받습니다 |
+| `ethos balance` | 남은 크레딧을 봅니다 |
+| `ethos usage` | 기간별 사용 내역을 봅니다 |
+| `ethos doctor` | 어디가 막혔는지 점검합니다 |
+
+## 키
+
+`ethos login` 은 키를 **두 개** 받아 `~/.ethos/config.json` 에 0600 으로
+저장합니다. 모델을 부르는 키와 사용 내역을 읽는 키가 따로입니다. 범위가
+갈려 있어서, 하나가 새더라도 그 키로는 절반만 할 수 있습니다.
+
+두 키는 콘솔의 API 키 목록에 `CLI` 로 뜹니다. 거기서 정지할 수 있고,
+`ethos logout` 도 설정만 지우는 게 아니라 그 두 키를 정지시킵니다.
+
+## 환경변수
+
+| 이름 | 쓰임 |
+|---|---|
+| `ETHOS_BASE_URL` | 창구 주소. 시험 서버를 보실 때 바꿉니다 |
+| `ETHOS_API_KEY` | 모델 호출 키. 설정 파일보다 우선합니다 |
+| `ETHOS_USAGE_KEY` | 사용 조회 키. 설정 파일보다 우선합니다 |
+
+브라우저가 없는 곳(CI)에서는 `ethos login --with-key <키>` 를 쓰거나
+`ETHOS_API_KEY` 를 넣으세요.
+
+## 사용 내역을 파일로
+
+```bash
+ethos usage --from 2026-09-01 --to 2026-09-30 --group 부서 --csv 사용내역서.csv
+```
+
+엑셀이 바로 여는 파일로 저장됩니다. 금액은 공급가액(부가세 별도)입니다.
+
+---
+
+문의 [router@ethos.ai.kr](mailto:router@ethos.ai.kr) · 문서
+<https://router.ethos.ai.kr/docs#cli>

package/index.js

@@ -0,0 +1,519 @@
+#!/usr/bin/env node
+// ============================================================
+// 에토스 라우터 명령줄 도구.
+//
+// 하는 일은 하나다: **코딩 도구가 에토스 라우터를 보게 만든다.**
+// Claude Code·Codex 같은 도구는 각자 정해진 환경변수로 창구 주소와 키를
+// 읽는다. 그 값을 사람이 매번 export 하게 두면 키가 셸 기록에 남고,
+// 기계마다 다르게 걸려서 "왜 나만 안 되냐"가 된다.
+//
+// 의존성이 없다. 설치가 곧 신뢰 비용이라, 키를 다루는 도구일수록
+// 남의 코드를 끌고 오지 않는다. Node 18 의 fetch 만 쓴다.
+// ============================================================
+
+import { spawn } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir, hostname } from "node:os";
+import { dirname, join } from "node:path";
+
+const VERSION = "0.1.0";
+const DEFAULT_BASE = "https://router.ethos.ai.kr";
+const CONFIG_PATH = join(homedir(), ".ethos", "config.json");
+
+// ── 출력 ──────────────────────────────────────────────────
+// 색은 터미널일 때만. 파이프로 넘기면 제어문자가 파일에 섞인다.
+const tty = process.stdout.isTTY && !process.env.NO_COLOR;
+const c = (n, s) => (tty ? `[${n}m${s}` : String(s));
+const bold = (s) => c(1, s), dim = (s) => c(2, s), green = (s) => c(32, s), red = (s) => c(31, s);
+const out = (s = "") => process.stdout.write(s + "\n");
+const err = (s) => process.stderr.write(s + "\n");
+
+function die(msg, hint) {
+  err(red("✗ ") + msg);
+  if (hint) err(dim("  " + hint));
+  process.exit(1);
+}
+
+// ── 설정 ──────────────────────────────────────────────────
+//
+// 키가 들어 있는 파일이다. 남이 못 읽게 0600 으로 쓴다. 홈 디렉터리가
+// 공유되는 기계(학교·회사 공용 서버)에서 기본 권한이면 옆자리가 읽는다.
+function loadConfig() {
+  try { return JSON.parse(readFileSync(CONFIG_PATH, "utf8")); } catch { return {}; }
+}
+
+function saveConfig(cfg) {
+  mkdirSync(dirname(CONFIG_PATH), { recursive: true, mode: 0o700 });
+  writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2) + "\n", { mode: 0o600 });
+  try { chmodSync(CONFIG_PATH, 0o600); } catch { /* 윈도우는 권한 모델이 다르다 */ }
+}
+
+/**
+ * 창구 주소. 시험 서버나 사내 스테이징을 볼 때 바꾼다.
+ * (라우터 자체는 SaaS 전용이다 — docs/PLAN.md §8. 사내 설치용 스위치가 아니다.)
+ */
+function baseUrl(cfg = loadConfig()) {
+  return (process.env.ETHOS_BASE_URL || cfg.base_url || DEFAULT_BASE).replace(/\/+$/, "");
+}
+
+/**
+ * 키를 꺼낸다. 환경변수가 설정 파일을 이긴다 — CI 에서는 파일을 못 쓰고,
+ * 한 기계에서 계정을 바꿔 가며 돌릴 때도 환경변수가 이기는 쪽이 덜 놀랍다.
+ */
+function apiKey(cfg = loadConfig()) {
+  return process.env.ETHOS_API_KEY || cfg.api_key || "";
+}
+function usageKey(cfg = loadConfig()) {
+  return process.env.ETHOS_USAGE_KEY || cfg.usage_key || "";
+}
+
+function needKey(cfg) {
+  const k = apiKey(cfg);
+  if (!k) die("로그인이 필요합니다.", "ethos login");
+  return k;
+}
+
+// ── 서버 ──────────────────────────────────────────────────
+async function call(path, { method = "GET", body, key, base } = {}) {
+  const url = (base ?? baseUrl()) + path;
+  let res;
+  try {
+    res = await fetch(url, {
+      method,
+      headers: {
+        ...(key ? { Authorization: `Bearer ${key}` } : {}),
+        ...(body ? { "Content-Type": "application/json" } : {}),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+  } catch (e) {
+    // 연결 자체가 안 된 것과 서버가 거절한 것은 고칠 곳이 다르다
+    die(`${url} 에 연결하지 못했습니다.`, e.message);
+  }
+  const text = await res.text();
+  let json = null;
+  try { json = text ? JSON.parse(text) : null; } catch { /* 본문이 JSON 이 아닐 수 있다 */ }
+  if (!res.ok) {
+    const msg = json?.error?.message || text.slice(0, 200) || `HTTP ${res.status}`;
+    const e = new Error(msg);
+    e.status = res.status;
+    throw e;
+  }
+  return { status: res.status, json, text };
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+// ── login ─────────────────────────────────────────────────
+//
+// 브라우저에서 승인하고 터미널이 결과를 받아 간다. 키를 화면에서 복사해
+// 붙여넣게 하지 않는 이유는, 그 순간 키가 셸 기록과 스크롤백에 남기 때문이다.
+async function cmdLogin(args) {
+  const cfg = loadConfig();
+  const base = args.base || baseUrl(cfg);
+
+  // CI 에는 브라우저가 없다. 그때만 키를 직접 받는다.
+  if (args["with-key"]) {
+    cfg.base_url = base;
+    cfg.api_key = args["with-key"];
+    if (args["usage-key"]) cfg.usage_key = args["usage-key"];
+    saveConfig(cfg);
+    out(green("✓ ") + `키를 저장했습니다. ${dim(CONFIG_PATH)}`);
+    return;
+  }
+
+  const label = args.label || hostname();
+  const { json: start } = await call("/cli/v1/device", { method: "POST", body: { label }, base });
+
+  out("");
+  out("  브라우저에서 아래 주소를 열고 승인하세요.");
+  out("  " + bold(start.verification_url));
+  out("");
+  out("  승인 코드  " + bold(start.user_code));
+  out(dim("  화면의 코드가 이 코드와 같은지 꼭 확인하세요."));
+  out("");
+
+  await openBrowser(start.verification_url);
+
+  const deadline = Date.now() + start.expires_in * 1000;
+  process.stdout.write(dim("  승인을 기다리는 중…"));
+  while (Date.now() < deadline) {
+    await sleep(start.interval * 1000);
+    let r;
+    try {
+      r = await call(`/cli/v1/device?device_code=${encodeURIComponent(start.device_code)}`, { base });
+    } catch (e) {
+      out("");
+      die(e.message, "ethos login 을 다시 실행하세요.");
+    }
+    if (r.status === 200 && r.json?.status === "ready") {
+      out("");
+      cfg.base_url = base;
+      cfg.api_key = r.json.api_key;
+      cfg.usage_key = r.json.usage_key;
+      cfg.workspace = r.json.workspace;
+      saveConfig(cfg);
+      out(green("✓ ") + `${r.json.workspace.name} 으로 로그인했습니다.`);
+      out(dim(`  키는 ${CONFIG_PATH} 에 저장됩니다. 콘솔의 API 키 목록에서 언제든 정지할 수 있습니다.`));
+      out("");
+      out("  다음으로");
+      out("    " + bold("ethos claude") + dim("    Claude Code 를 에토스 라우터로 실행"));
+      out("    " + bold("ethos models") + dim("    쓸 수 있는 모델 보기"));
+      return;
+    }
+    process.stdout.write(dim("."));
+  }
+  out("");
+  die("승인 시간이 지났습니다.", "ethos login 을 다시 실행하세요.");
+}
+
+/** 브라우저를 대신 열어 준다. 안 열려도 주소를 이미 찍었으므로 실패해도 그냥 넘어간다 */
+async function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open"
+    : process.platform === "win32" ? "cmd"
+    : "xdg-open";
+  const argv = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+  try {
+    const p = spawn(cmd, argv, { stdio: "ignore", detached: true });
+    p.on("error", () => {});
+    p.unref();
+  } catch { /* 브라우저가 없는 서버일 수 있다 */ }
+}
+
+// ── logout ────────────────────────────────────────────────
+//
+// 설정 파일만 지우면 키는 서버에서 살아 있다. 노트북을 잃어버렸을 때
+// 실제로 접근이 끊겨야 하므로, 두 키를 각각 스스로 정지시킨다.
+async function cmdLogout() {
+  const cfg = loadConfig();
+  const base = baseUrl(cfg);
+  let revoked = 0, failed = 0;
+  for (const k of [cfg.api_key, cfg.usage_key].filter(Boolean)) {
+    try { await call("/cli/v1/logout", { method: "POST", key: k, base }); revoked++; }
+    catch { failed++; }
+  }
+  try { rmSync(CONFIG_PATH); } catch { /* 없으면 그만 */ }
+
+  if (revoked) out(green("✓ ") + `키 ${revoked}개를 정지하고 설정을 지웠습니다.`);
+  else out(green("✓ ") + "설정을 지웠습니다.");
+  // 못 지운 키를 조용히 넘기면 살아 있는 키가 어딘가에 남는다
+  if (failed) {
+    err(dim(`  키 ${failed}개는 정지하지 못했습니다. 콘솔의 API 키 목록에서 직접 정지하세요.`));
+  }
+}
+
+// ── 도구 실행 ──────────────────────────────────────────────
+//
+// 도구마다 읽는 환경변수가 다르다. 그 대응표가 여기 한 곳에 있다 —
+// 문서와 코드에 나눠 적으면 도구가 변수 이름을 바꾼 날 한쪽만 고쳐진다.
+const TOOLS = {
+  claude: {
+    bin: "claude",
+    install: "npm i -g @anthropic-ai/claude-code",
+    // 앤트로픽 형식 창구. 도구가 뒤에 /v1/messages 를 붙인다.
+    env: (key, base) => ({
+      ANTHROPIC_BASE_URL: `${base}/claude`,
+      ANTHROPIC_AUTH_TOKEN: key,
+      ANTHROPIC_API_KEY: key,
+    }),
+  },
+  codex: {
+    bin: "codex",
+    install: "npm i -g @openai/codex",
+    env: (key, base) => ({
+      OPENAI_BASE_URL: `${base}/v1`,
+      OPENAI_API_KEY: key,
+    }),
+  },
+};
+
+function toolEnv(name, key, base) {
+  return TOOLS[name].env(key, base);
+}
+
+async function cmdRunTool(name, rest) {
+  const cfg = loadConfig();
+  const key = needKey(cfg);
+  const t = TOOLS[name];
+  const env = { ...process.env, ...toolEnv(name, key, baseUrl(cfg)) };
+
+  const child = spawn(t.bin, rest, { stdio: "inherit", env });
+  child.on("error", (e) => {
+    if (e.code === "ENOENT") {
+      die(`${t.bin} 이 설치돼 있지 않습니다.`, `${t.install} 로 설치한 뒤 다시 실행하세요.`);
+    }
+    die(e.message);
+  });
+  child.on("exit", (code, signal) => {
+    // 신호로 죽은 것을 0 으로 보고하면 스크립트가 성공으로 읽는다
+    process.exit(signal ? 1 : (code ?? 0));
+  });
+}
+
+// ── env ───────────────────────────────────────────────────
+//
+// 우리가 모르는 도구를 쓰는 사람에게 필요한 것. 무엇을 넣는지 그대로
+// 보여 주므로, 붙는지 안 붙는지를 우리에게 묻지 않고 스스로 확인할 수 있다.
+function cmdEnv(args) {
+  const cfg = loadConfig();
+  const key = needKey(cfg);
+  const base = baseUrl(cfg);
+  const vars = { ...toolEnv("claude", key, base), ...toolEnv("codex", key, base) };
+  const shell = args.shell || (process.env.SHELL?.includes("fish") ? "fish" : "posix");
+  for (const [k, v] of Object.entries(vars)) {
+    out(shell === "fish" ? `set -gx ${k} ${v}`
+      : shell === "powershell" ? `$env:${k} = "${v}"`
+      : `export ${k}=${v}`);
+  }
+}
+
+// ── models ────────────────────────────────────────────────
+async function cmdModels(args) {
+  const term = (args._[0] || "").toLowerCase();
+  const { json: d } = await call("/v1/prices");
+  const rows = d.models.filter((m) =>
+    !term || m.id.toLowerCase().includes(term) || (m.name || "").toLowerCase().includes(term));
+  if (!rows.length) return out(dim(term ? `"${term}" 에 맞는 모델이 없습니다.` : "모델이 없습니다."));
+
+  const n = (v, d2 = 0) => v == null ? "" : Number(v).toLocaleString("ko-KR", { maximumFractionDigits: d2 });
+  const w = Math.min(46, Math.max(...rows.map((m) => m.id.length)));
+  out(dim(`  적용 환율 ${n(d.fx.usd_krw, 2)}원 · ${d.fx.date} 기준 · 금액은 공급가액(부가세 별도)`));
+  out("");
+  out(dim(`  ${"모델".padEnd(w)}  ${"입력/1M".padStart(11)}  ${"출력/1M".padStart(11)}`));
+  for (const m of rows) {
+    // 값이 없으면 단위도 붙이지 않는다. "—원" 은 있는 척하는 빈칸이다
+    const i = m.unit === "token" ? m.input_per_1m_krw : m.per_unit_krw;
+    const o = m.unit === "token" ? m.output_per_1m_krw : null;
+    out(`  ${m.id.padEnd(w)}  ${(i == null ? "" : n(i) + "원").padStart(11)}  ${(o == null ? "" : n(o) + "원").padStart(11)}`);
+  }
+  out("");
+  out(dim(`  ${rows.length}개`));
+}
+
+// ── balance ───────────────────────────────────────────────
+async function cmdBalance() {
+  const cfg = loadConfig();
+  const k = usageKey(cfg);
+  if (!k) die("잔액을 읽을 키가 없습니다.", "ethos login 을 다시 실행하세요.");
+  const { json: b } = await call("/usage/v1/billing", { key: k });
+  const n = (v) => Number(v ?? 0).toLocaleString("ko-KR", { maximumFractionDigits: 0 });
+  out("");
+  out(`  잔액  ${bold(n(b.credit?.balanceKrw ?? b.balanceKrw) + "원")}  ${dim("공급가액 기준")}`);
+  if (b.month) out(`  이번 달 사용  ${n(b.month.costKrw)}원`);
+  out("");
+}
+
+// ── usage ─────────────────────────────────────────────────
+async function cmdUsage(args) {
+  const cfg = loadConfig();
+  const k = usageKey(cfg);
+  if (!k) die("사용 내역을 읽을 키가 없습니다.", "ethos login 을 다시 실행하세요.");
+
+  const today = new Date().toISOString().slice(0, 10);
+  const from = args.from || today.slice(0, 8) + "01";
+  const to = args.to || today;
+  const group = args.group === "usage_group" || args.group === "부서" ? "usage_group" : "model";
+  const q = `from=${from}&to=${to}&group_by=${group}`;
+
+  // 파일로 받으면 그대로 회계팀에 보낸다. 엑셀이 여는 형식이라 손댈 게 없다.
+  if (args.csv) {
+    const res = await fetch(`${baseUrl(cfg)}/usage/v1/statement?${q}&format=csv`, {
+      headers: { Authorization: `Bearer ${k}` },
+    });
+    if (!res.ok) die(`내려받지 못했습니다 (HTTP ${res.status})`);
+    writeFileSync(args.csv, Buffer.from(await res.arrayBuffer()));
+    out(green("✓ ") + `${args.csv} 로 저장했습니다.`);
+    return;
+  }
+
+  const { json: d } = await call(`/usage/v1/statement?${q}`, { key: k });
+  const n = (v, d2 = 0) => Number(v ?? 0).toLocaleString("ko-KR", { maximumFractionDigits: d2 });
+  if (!d.rows.length) return out(dim(`  ${from} ~ ${to} 사용 내역이 없습니다.`));
+
+  const w = Math.min(46, Math.max(...d.rows.map((r) => r.key.length), 6));
+  out("");
+  out(dim(`  ${d.workspace.name} · ${from} ~ ${to} (KST)`));
+  out("");
+  out(dim(`  ${(group === "model" ? "모델" : "부서·프로젝트").padEnd(w)}  ${"요청".padStart(8)}  ${"금액".padStart(12)}`));
+  for (const r of d.rows) {
+    out(`  ${r.key.padEnd(w)}  ${n(r.requests).padStart(8)}  ${(n(r.cost_krw, 2) + "원").padStart(12)}`);
+  }
+  out(`  ${"합계".padEnd(w)}  ${n(d.total.requests).padStart(8)}  ${bold((n(d.total.cost_krw, 2) + "원").padStart(12))}`);
+  out("");
+  out(dim("  " + d.note));
+}
+
+// ── chat ──────────────────────────────────────────────────
+async function cmdChat(args) {
+  const cfg = loadConfig();
+  const key = needKey(cfg);
+  const prompt = args._.join(" ") || await readStdin();
+  if (!prompt.trim()) die("물어볼 내용이 없습니다.", 'ethos chat "안녕"');
+
+  const model = args.m || args.model || cfg.model || "anthropic/claude-sonnet-5";
+  const { json: r } = await call("/v1/chat/completions", {
+    method: "POST",
+    key,
+    body: { model, messages: [{ role: "user", content: prompt }] },
+  });
+  out(r.choices?.[0]?.message?.content ?? "");
+  // 얼마 썼는지를 그 자리에서 말한다. 나중에 청구서로 처음 아는 것과 다르다.
+  if (r.usage?.cost != null) {
+    err(dim(`  ${model} · ${Number(r.usage.cost).toLocaleString("ko-KR", { maximumFractionDigits: 4 })}원`));
+  }
+}
+
+function readStdin() {
+  if (process.stdin.isTTY) return Promise.resolve("");
+  return new Promise((resolve) => {
+    let buf = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (d) => { buf += d; });
+    process.stdin.on("end", () => resolve(buf));
+  });
+}
+
+// ── doctor ────────────────────────────────────────────────
+//
+// "안 되는데요" 를 받았을 때 물어볼 것을 미리 다 찍어 준다.
+// 어디가 막혔는지 사람이 알아야 우리에게 물을 것도 정확해진다.
+async function cmdDoctor() {
+  const cfg = loadConfig();
+  const base = baseUrl(cfg);
+  const line = (ok, label, detail) =>
+    out(`  ${ok ? green("✓") : red("✗")} ${label}${detail ? dim("  " + detail) : ""}`);
+
+  out("");
+  out(bold("  에토스 라우터 점검"));
+  out("");
+  out(`  창구 주소  ${base}`);
+  out(`  설정 파일  ${existsSync(CONFIG_PATH) ? CONFIG_PATH : dim("없음")}`);
+  out("");
+
+  let ok = true;
+  try {
+    const { json: h } = await call("/health", { base });
+    line(true, "서버 연결", `버전 ${h.version ?? "?"}`);
+  } catch (e) { ok = false; line(false, "서버 연결", e.message); }
+
+  const k = apiKey(cfg);
+  if (!k) { ok = false; line(false, "로그인", "ethos login"); }
+  else {
+    try {
+      await call("/v1/models", { key: k, base });
+      line(true, "모델 호출 키", k.slice(0, 12) + "…");
+    } catch (e) { ok = false; line(false, "모델 호출 키", e.message); }
+  }
+
+  const uk = usageKey(cfg);
+  if (!uk) line(false, "사용 조회 키", "ethos login 을 다시 실행하면 같이 발급됩니다");
+  else {
+    try {
+      await call("/usage/v1/billing", { key: uk, base });
+      line(true, "사용 조회 키", uk.slice(0, 12) + "…");
+    } catch (e) { line(false, "사용 조회 키", e.message); }
+  }
+
+  // 도구가 깔려 있는지는 실행해 봐야 안다. 없다고 고장은 아니므로 안내만 한다.
+  for (const [name, t] of Object.entries(TOOLS)) {
+    const found = await which(t.bin);
+    line(found, `${name} 설치`, found ? "" : t.install);
+  }
+  out("");
+  if (!ok) process.exitCode = 1;
+}
+
+function which(bin) {
+  return new Promise((resolve) => {
+    const p = spawn(process.platform === "win32" ? "where" : "which", [bin], { stdio: "ignore" });
+    p.on("error", () => resolve(false));
+    p.on("exit", (code) => resolve(code === 0));
+  });
+}
+
+// ── whoami ────────────────────────────────────────────────
+function cmdWhoami() {
+  const cfg = loadConfig();
+  if (!apiKey(cfg)) die("로그인이 필요합니다.", "ethos login");
+  out("");
+  out(`  워크스페이스  ${bold(cfg.workspace?.name ?? dim("알 수 없음"))}`);
+  out(`  창구 주소     ${baseUrl(cfg)}`);
+  // 키 전체를 찍지 않는다. 스크린샷과 화면 공유로 새어 나가는 자리다.
+  out(`  키            ${apiKey(cfg).slice(0, 12)}…`);
+  out("");
+}
+
+// ── 도움말 ────────────────────────────────────────────────
+function help() {
+  out(`
+  ${bold("에토스 라우터")} ${dim("v" + VERSION)}
+
+  ${bold("ethos login")}                브라우저에서 승인하고 키를 받습니다
+  ${bold("ethos logout")}               키를 정지하고 설정을 지웁니다
+  ${bold("ethos whoami")}               어느 워크스페이스로 붙어 있는지 봅니다
+
+  ${bold("ethos claude")} ${dim("[인자…]")}      Claude Code 를 에토스 라우터로 실행합니다
+  ${bold("ethos codex")} ${dim("[인자…]")}       Codex 를 에토스 라우터로 실행합니다
+  ${bold("ethos env")}                  다른 도구에 넣을 환경변수를 찍습니다
+                             ${dim("--shell fish|powershell")}
+
+  ${bold("ethos models")} ${dim("[검색어]")}     쓸 수 있는 모델과 단가를 봅니다
+  ${bold("ethos chat")} ${dim('"질문"')}         한 번 물어보고 답을 받습니다 ${dim("-m 모델")}
+  ${bold("ethos balance")}              남은 크레딧을 봅니다
+  ${bold("ethos usage")}                기간별 사용 내역을 봅니다
+                             ${dim("--from 2026-09-01 --to 2026-09-08")}
+                             ${dim("--group 부서   --csv 사용내역서.csv")}
+  ${bold("ethos doctor")}               어디가 막혔는지 점검합니다
+
+  ${dim("시험 서버를 보려면")} ETHOS_BASE_URL ${dim("을 설정하세요.")}
+  ${dim("CI 처럼 브라우저가 없는 곳에서는")} ethos login --with-key <키> ${dim("를 씁니다.")}
+`);
+}
+
+// ── 인자 ──────────────────────────────────────────────────
+//
+// --키 값 과 --키=값 을 둘 다 받는다. 둘 중 하나만 되면 안 되는 쪽을 쓴
+// 사람은 "무시됐다" 는 것도 모른 채 기본값으로 돈다.
+function parse(argv) {
+  const args = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith("--")) { args._.push(a); continue; }
+    const eq = a.indexOf("=");
+    if (eq > 0) { args[a.slice(2, eq)] = a.slice(eq + 1); continue; }
+    const name = a.slice(2);
+    const next = argv[i + 1];
+    if (next && !next.startsWith("--")) { args[name] = next; i++; }
+    else args[name] = true;
+  }
+  return args;
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const cmd = argv[0];
+
+  // 도구에 넘길 인자는 우리가 해석하지 않는다. claude --help 는 claude 의 것이다.
+  if (cmd in TOOLS) return await cmdRunTool(cmd, argv.slice(1));
+
+  const args = parse(argv.slice(1));
+  switch (cmd) {
+    case "login": return await cmdLogin(args);
+    case "logout": return await cmdLogout();
+    case "whoami": return cmdWhoami();
+    case "env": return cmdEnv(args);
+    case "models": return await cmdModels(args);
+    case "chat": return await cmdChat(args);
+    case "balance": return await cmdBalance();
+    case "usage": return await cmdUsage(args);
+    case "doctor": return await cmdDoctor();
+    case "-v": case "--version": case "version": return out(VERSION);
+    case undefined: case "help": case "-h": case "--help": return help();
+    default:
+      err(red("✗ ") + `모르는 명령입니다: ${cmd}`);
+      help();
+      process.exit(1);
+  }
+}
+
+main().catch((e) => die(e.message));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "ethos-router",
+  "version": "0.1.0",
+  "description": "에토스 라우터 명령줄 도구. 한 번 로그인하면 코딩 도구가 에토스 라우터를 보게 됩니다.",
+  "type": "module",
+  "bin": {
+    "ethos": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "license": "MIT",
+  "homepage": "https://router.ethos.ai.kr/docs#cli",
+  "keywords": [
+    "llm",
+    "gateway",
+    "router",
+    "cli",
+    "korea"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spacebar-corp/Ethos-router.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "email": "router@ethos.ai.kr"
+  }
+}