명령 레퍼런스

/prism:setup

API 키를 구성하고 텔레메트리를 활성화합니다.

/prism:setup prism_YOUR_API_KEY

인자는 키 하나뿐입니다. 스코프 플래그는 없으며, 플러그인이 설치된 스코프를 감지해 그 스코프의 설정 파일에만 씁니다.

새 키는 prism_로 시작합니다(키는 자동으로 발급되며, 대시보드 헤더의 Connect 패널이 키가 담긴 셋업 명령을 그대로 보여 줍니다). 레거시 gck_ 접두사도 여전히 허용됩니다.

하는 일:

키를 ~/.prism/config.json(소유자 전용)에 저장하고, 그 키가 속한 Prism을 확인합니다.
키를 그 Prism에 묶어 둡니다. 이후 apiKey나 ingest_url만 따로 수정하면 감지되어, 데이터가 엉뚱한 곳으로 조용히 전송되지 않습니다.
플러그인이 설치된 스코프를 감지해, OTEL env 변수(prism_*가 담긴 OTEL_EXPORTER_OTLP_HEADERS 포함)를 그 스코프의 설정 파일에 기록합니다:
- user → ~/.claude/settings.json
- project → $CLAUDE_PROJECT_DIR/.claude/settings.json (git에 커밋됨)
- local → $CLAUDE_PROJECT_DIR/.claude/settings.local.json (gitignore됨)

전체 스코프 규칙은 설치 스코프를 참고하세요.

그다음 Claude Code를 재시작하세요. OTEL env 변수는 프로세스 시작 시 읽히므로 실행 중인 세션은 이를 반영하지 못합니다.

/prism:status

연결 상태, 스코프, 토글을 표시합니다.

/prism:status

표시 항목:

API key 접두사(예: prism_abc12…) 또는 없을 경우 셋업 안내.
Config scope — user, project, both, 또는 none. 공유 .claude/settings.json에 OTEL 변수가 나타나면 경고하며, 이는 prism_* 키가 커밋되었을 수 있음을 뜻합니다.
Endpoints — 실제로 적용 중인 ingest URL과 OTEL 로그·메트릭 엔드포인트.
Settings — 각 값의 현재 설정과 그 값이 어느 파일에서 왔는지.
Key binding — 키가 발급받은 Prism과 여전히 일치하는지.

설정을 바꾸려면 /prism:config를 사용하세요.

/prism:config

Prism 런타임 구성을 표시하거나 업데이트합니다.

/prism:config

/prism:config                                   # 현재 값 보기
/prism:config help                              # 모든 필드와 기본값, 설정 방법
/prism:config set show_realtime_summary true
/prism:config unset ingest_url

바꿀 수 있는 필드는 show_realtime_summary와 ingest_url 두 개입니다. 바꿀 수 있는 필드만 나열하며, 각각의 현재 값·기본값·허용 값·재시작 필요 여부를 함께 보여 줍니다. apiKey는 /prism:setup이 관리하고 dashboard_url은 서버가 알려 주므로 여기에는 나오지 않습니다.

각 필드가 제어하는 내용은 구성을 참고하세요.

/prism:doctor

Prism 플러그인 구성 및 연결 문제를 진단합니다.

/prism:doctor

네 가지 검사를 수행하고 요약 표를 출력합니다:

#	검사	확인하는 내용
1	API Key	`~/.prism/config.json`에 `prism_*` 키가 있고, 발급받은 Prism에 여전히 묶여 있는지
2	OTEL Settings	OTEL env 변수가 올바른 스코프의 `.claude/settings.json`에 기록되고 디스크 값과 일치하는지
3	Ingest Health Endpoint	ingest 엔드포인트가 health 프로브에 응답하는지
4	OTEL Headers Helper	디스크의 헤더 헬퍼 설정과 파일이 안전한 상태인지

각 검사는 PASS, WARN, FAIL 중 하나를 반환하며, 통과하지 못한 항목에는 해결 방법이 함께 나옵니다. 디버그 로깅이 켜져 있는지와 로그가 기록되는 파일도 알려 줍니다.

모두 통과하면 다음이 보입니다: All checks passed. Your Prism configuration is healthy.

/prism:realtime

현재 세션의 실시간 Prism 점수 요약을 표시합니다.

/prism:realtime

현재 세션의 지금 이 순간 스냅샷(등급, 누적 비용, 턴 수)을 표시하여, 터미널을 떠나거나 대시보드를 열지 않고도 세션이 어떻게 진행되는지 가늠할 수 있게 합니다.

여러 세션을 주간 단위로 모으는 /prism:report와 달리, 이 명령은 지금 진행 중인 세션만 다룹니다.

/prism:report

주간 리뷰 — 이번 주 대 지난주, 문자 등급이 있는 프롬프트 점수, 습관, 최악의 프롬프트.

/prism:report

해당 기간의 리포트가 아직 없으면 이 명령이 생성을 제안합니다. 생성에는 최대 2분 정도 걸리며, 완료되면 바로 보여 줍니다.

표시 내용:

비교 — 이번 주 대 지난주: 문자 등급이 붙은 프롬프트 점수, 세션 수, 비용, 토큰, 그리고 리포트에 있을 경우 역량·속도·효율. 각 항목은 전주 대비 증감을 함께 보여 줍니다.
토큰 사용 — 이번 기간에 토큰이 어디에 쓰였는지.
습관 — 세션당 평균 턴, 응답 시간 중앙값, 멀티클로딩 이벤트.
최악의 프롬프트 — 가장 낮은 등급의 프롬프트들로, 각각 세션·턴 인덱스·미리보기가 붙습니다.
코칭 — 가장 약한 습관과 연결된 짧은 코칭 메모.
비용 최적화 — 총비용, 낭비된 비용과 그 비율, 잠재 절감액, 그리고 상위 rightsizing 또는 낭비 개선 액션.

가장 크게 달라진 지표를 짚는 한 줄, 단일 집중 영역 추천, 그리고 전체 대시보드 리포트로의 링크로 끝맺습니다.

/prism:help

모든 /prism:* 명령을 카테고리별로 묶어 나열합니다.

/prism:help

출력은 Setup & Config, Configurable fields, Review, Automatic(hooks — no command needed)으로 묶이며, 짧은 시작 가이드 블록과 대시보드 셋업 페이지 및 문서로의 링크가 뒤따릅니다.

/prism:uninstall

플러그인, 구성, 텔레메트리 설정을 제거합니다.

/prism:uninstall

미리보기와 실제 제거, 두 단계로 진행됩니다.

미리보기. 현재 설치 상태를 읽어 무엇을 지울지 정확히 보여 줍니다: 설치된 스코프, 수정할 설정 파일, Prism이 소유한 OTEL 값입니다. 이 단계에서는 아무것도 바뀌지 않습니다.
적용. 확인하면 각 대상을 건드리기 직전에 다시 검사합니다. 미리보기 이후 무엇이든 달라졌다면 단 한 곳도 수정하지 않고 중단합니다.

제거 대상은 지금 제거하는 스코프에서 Prism이 소유한 것뿐입니다. 다른 Prism 설치(다른 프로젝트, 고정해 둔 이전 버전)는 등록·설정·데이터·캐시가 그대로 남습니다. Prism이 기록한 값에서 벗어난 항목은 덮어쓰지 않고 보존합니다.

이후 Claude Code를 재시작하세요. 텔레메트리가 멈추고 훅이 비활성화되며, 대시보드 데이터는 영향을 받지 않습니다.