CASS 세션 로그 검색
과거 에이전트 세션 로그를 `cass` CLI로 안전하고 근거 있게 검색해 이전 프롬프트·결정·실패를 찾아주는 스킬.
유틸리티고급★ 435⑂ 40AI 점수 8/10마지막 업데이트: 2026. 9. 12.
무엇을 해주나
- 과거 AI 에이전트 대화 로그(세션 파일)를
cassCLI로 검색해 출처 경로 + 줄 번호가 붙은 인용 근거를 돌려줍니다. - 검색 → 발췌(pack) → 원문 확인(view/expand) → 관련 세션 탐색(context)으로 이어지는 정해진 워크플로를 따릅니다.
- 인덱스 상태를
정상 / 오래됨(stale) / 없음으로 구분해, "오래됨"을 "고장"으로 오인하고 불필요한 전체 재색인을 돌리는 낭비를 막습니다. - 결과 해석 규칙까지 정의합니다: 0건은 "세상에 없음"이 아니라 "이 조건에서 없음", 반복된 프롬프트는 성공의 증거가 아님, 실패 사례가 성공 사례보다 정보량이 크다는 원칙 등.
- 맨
cass실행(블로킹 TUI),--limit 0,cass export | head같은 실제로 사고를 내는 안티패턴 목록을 제공합니다.
이런 분께 추천
- Claude Code 등 에이전트 하네스를 장기간 사용하며 세션 로그가 쌓인 개발자
- "저번에 뭐라고 물어봤더라", "이 방식 예전에 왜 접었더라"를 자주 되짚는 사람
- 컨텍스트 손실/크래시 후 작업 맥락을 복원해야 하는 사람
- 이미
cass바이너리를 설치했거나 설치할 의향이 있는 CLI 친화 사용자
활용 예시
- 선례 확인: 새 방식을 도입하기 전
cass search "retry backoff" --mode lexical --json --fields minimal --limit 20으로 과거에 같은 시도를 했는지, 특히 "reverted", "didn't work" 같은 실패 흔적을 먼저 찾습니다. - 결정 고고학: "우리가 X를 하지 않기로 한 게 언제였지?"를 검색하고, 히트된 세션을
cass view PATH -n LINE -C 5로 열어 발언 역할과 실제 결론을 확인합니다. - 크래시 복구: 컨텍스트가 날아간 뒤
timeout 15 cass status --json으로 인덱스 상태를 보고, 마지막에 검색하던 키워드로 작업 흐름을 되살립니다.
주의: 이 스킬 자체는 검색 도구가 아니라 "운영 지침"입니다. 실제 검색은 외부
cass바이너리(권장 0.3.6+)와jq가 있어야 동작합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/boshu2/agentops/HEAD/images/gemini/skills/cass/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 boshu2/agentops 의 images/gemini/skills/cass 폴더를 내 ~/.claude/skills/cass/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/boshu2/agentops.git && mkdir -p ~/.claude/skills && cp -r agentops/images/gemini/skills/cass ~/.claude/skills/cass⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 먼저 외부 도구를 준비합니다:
cass바이너리(업스트림 Dicklesworthstone 프로젝트)를 설치하고cass --version으로 확인합니다. JSON 파싱용jq도 설치합니다(macOS:brew install jq, Ubuntu:sudo apt install jq). - 저장소를 내려받습니다:
git clone https://github.com/boshu2/agentops.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r agentops/images/gemini/skills/cass ~/.claude/skills/cass references/와scripts/폴더가 함께 복사됐는지 확인합니다(본문이 이 파일들을 참조합니다).- Claude Code를 재시작한 뒤 "예전 세션에서 X를 검색해줘"처럼 요청하면 스킬이 발동합니다.
- 설치 검증:
~/.claude/skills/cass/scripts/validate.sh를 실행해 cass 설치와 스킬 구조를 점검합니다. - 주의:
cass를 옵션 없이 실행하면 화면을 붙잡는 TUI가 뜹니다. 항상--json을 붙이세요.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0