본문으로 건너뛰기

cysJavis Antigravity CLI 전환 사례 — 설계·실행·증거·수리(에이전트하네스 3주차)

cysJavis Antigravity CLI 전환 사례 — 설계·실행·증거·수리(에이전트하네스 3주차) 본문 이미지

📌 한줄 요약

cysJavis가 기본 실행하도록 설정된 Claude Code 대신, Windows 환경에서 안티그래비티 CLI(agy)를 자동 감지·실행하도록 경로를 수정한 진단·수리·증거 과정을 정리했습니다.

W3 기본과제 산출물 — 설계 계약 7칸 + 실행 영수증 4칸 + 사례글 6블록


Station 진행 기록

Station A — 설계→작동→증거 지도

이을 조각 1줄: cysJavis는 외부 CLI 에이전트를 감지해 기동하는 하네스 구조다.

아직 없는 것 1줄: Windows에서 agy 경로가 자동 감지되는지 확인되지 않았다.


Station B — 개념 지도·실행 한 번 지도

소유층:

소유자

대상

cysJavis

데몬, surface, 에이전트 기동 로직

학습자

agents.json 수정, agy 설치 확인

런타임

agent-detect, launch-agent

Control Shape 선택: Full

  • 이유: 에이전트 기동 경로 수정은 실패 시 시스템 동작에 영향을 줄 수 있으므로, 변경 전 백업 + 변경 후 검증까지 포함


Station C — Tree·Router·Circuit

책임 경계:

구분

책임

cysJavis 데몬

surface 생성, 에이전트 기동, stdin 주입

agents.json

에이전트 cmd/ready_maker/capability 정의

학습자

실제 CLI 설치 확인, 경로 수정, 검증

작동 스케치:

graph TD
    A["사용자<br/>CEO 버튼 클릭"] --> B["cys launch-agent"]
    B --> C["agents.json<br/>gemini 어댑터 조회"]
    C --> D["cmd 경로 실행"]
    D -->|"성공"| E["agy 기동"]
    D -->|"실패"| F["감지 실패<br/>Claude로 대체"]
    E --> G["ready_marker 감지"]
    G --> H["역할 디렉티브 주입"]
    H --> I["사용자와 상호작용"]

Station D — Code as Gate·Proof

기계 게이트 1: cys agent-detect — agy 바이너리 감지 여부

사람 게이트 1: CEO 버튼 클릭 후 agy 세션이 정상 시작되는지 육안 확인

Proof 1: agents.json 경로 수정 diff + agy 버전 출력


Station E — 기본/확장 과제 계약

설계 계약 7칸:

#

칸

내용

1

Goal

cysJavis CEO 버튼 클릭 시 Claude Code 대신 agy가 자동 실행되도록 경로를 수정한다

2

Trigger

CEO 버튼 클릭, 또는 cys boot 명령 실행 시

3

Context

agents.json gemini 어댑터의 cmd 경로가 Linux 방식(~/.local/bin/agy)으로 설정되어 있어 Windows에서 감지되지 않음

4

Tree/Route

agy 설치 확인 → agents.json 경로 확인 → Windows 절대경로로 수정 → agent-detect 검증 → CEO 버튼 실행 검증

5

Criteria

CEO 버튼 → agy 자동 실행 → Gemini 3.6 Flash 로드 → 사용자 입력 수신

6

Approval

학습자 직접 agents.json 수정 + CEO 버튼 클릭

7

Repair

경로 오류 시 agents.json 원본 복구 또는 경로 재수정


Station F1 — 거주 방식

선택: basic-assignment 경로

이번 주 대상은 cysJavis + agy 전환이므로, 기본과제 흐름(설계 계약 + 최소 실행 영수증 + 사례글)으로 완주합니다.


Station F2 — 기어 선택: Light

  • 이유: 경로 수정 1회로 해결되어 Full 기어(多단계 수리·재평가) 불필요

  • 증거 수준: receipt_live_run


Station F3 — 문지기

문지기 1: agent-detect에서 agy가 verified로 표시되는지

문지기 2: CEO 버튼 실행 후 agy 세션이 10초 내에 시작되는지


Station F4 — 분업

역할

담당

학습자

agents.json 수정, 실행 검증

agy

실제 AI 응답 생성

cysJavis 데몬

surface 관리, stdin 주입


Station F5 — 사례글 골격 (이 문서 자체)

사례글 6블록 구조:

graph LR
    A["1. Goal"] --> B["2. Trigger"]
    B --> C["3. Context"]
    C --> D["4. Tree/Route"]
    D --> E["5. Criteria"]
    E --> F["6. Proof"]
    F --> G["7. Verdict"]
    G --> H["8. Repair"]

Station G — W3→W4 경계

baseline으로 남길 영수증 항목:

  • agents.json 원본 해시 + 수정본 해시

  • cys agent-detect 출력 (agy 감지 상태)

  • agy 실행 스크린샷 (Gemini 3.6 Flash 로드 확인)


실행 영수증

runtime_evidence_card:
  runtime: cysJavis 0.14.10 + Antigravity CLI 1.1.10
  installed_version:
    - cysJavis: 0.14.10 (C:\Users\XXXXX\cys\cys.exe)
    - agy: 1.1.10 (C:\Users\XXXXX\AppData\Local\agy\bin\agy.exe)
  official_docs_status: checked
  discovery_status: verified
  behavior_status: verified
  blocker: none
  observed_result: |
    - CEO 버튼 클릭 → agy 자동 실행
    - 로그인 계정: [email protected] (Google AI Pro)
    - 모델: Gemini 3.6 Flash (High)
    - 작업 디렉터리: ~/cys
    - ready_marker "? for shortcuts" 감지 후 디렉티브 주입 완료
  rollback: |
    - 원본: C:\Users\XXXXX\.cys\pack\agents.json (pack-manifest.json 해시 보관)
    - 복구: git checkout 또는 수정 전 diff 역적용

Trace

단계

실행 내용

결과

1

cys agent-detect

agy 바이너리 미감지 (경로 오류)

2

agents.json 경로 확인

~/.local/bin/agy (Linux 경로)

3

실제 agy 경로 확인

C:\Users\XXXXX\AppData\Local\agy\bin\agy.exe

4

agents.json 경로 수정

Windows 절대경로로 변경

5

cys agent-detect 재실행

agy 감지 확인

6

CEO 버튼 클릭

agy 자동 실행 확인


Proof

증거 1: agy 버전 확인

C:\Users\XXXXX\AppData\Local\agy\bin\agy.exe --version
출력: 1.1.10

증거 2: agents.json 수정 diff

- "cmd": "~/.local/bin/agy --dangerously-skip-permissions",
+ "cmd": "C:\\Users\\XXXXX\\AppData\\Local\\agy\\bin\\agy.exe --dangerously-skip-permissions",

증거 3: agy 실행 확인 스크린샷

  • 경로: C:\Users\XXXXX\AppData\Local\hermes\cache\images\img_9be51c12cb71.jpg

  • 내용: agy 1.1.10 실행, Gemini 3.6 Flash (High), ~/cys 작업 디렉터리


Verdict

verdict:
  status: PASS
  criteria_met:
    - CEO 버튼 → agy 자동 실행: true
    - Gemini 3.6 Flash 로드: true
    - 사용자 입력 수신: true
    - ready_marker 감지: true
  criteria_failed: []
  notes: "경로 수정 1회로 모든 Criteria 충족"

Repair

repair_log:
  issue: "CEO 버튼 클릭 시 Claude Code 로그인 화면이 나타남"
  root_cause: |
    agents.json의 gemini 어댑터 cmd 경로가 Linux 방식(~/.local/bin/agy)으로
    설정되어 Windows에서 바이너리가 감지되지 않아 fallback으로 Claude가 실행됨
  fix: |
    agents.json의 gemini 어댑터 cmd 경로를
    C:\Users\bjkim\AppData\Local\agy\bin\agy.exe로 변경
  fix_count: 1
  pre_repair_backup: |
    - pack-manifest.json 기반 원본 해시 보관
    - 수정 전 agents.json 백업 복사본 유지
  post_repair_verification: |
    - cys agent-detect → agy verified
    - CEO 버튼 → agy 자동 실행 확인
  side_effects: "none"
  rollback_tested: false

📊 요약 보드

done_this_session

  • [x] 대상 Skill 확정: cysJavis Antigravity CLI 전환

  • [x] 설계 계약 7칸 완료

  • [x] 최소 실행 영수증 완료 (Trace/Proof/Verdict/Repair)

  • [x] 사례글 6블록 초안 완료

still_open

  • [ ] 부서장 역할도 agy로 전환할지 여부

  • [ ] Claude Code 완전히 제거할지 여부

can_go_deeper

  • [ ] 확장과제: agy 로그인 세션 만료 시 자동 재인증 테스트

  • [ ] 확장과제: Windows 작업 스케줄러에 cysd 데몬 등록 확인

  • [ ] W4 Self-improvement baseline 카드 작성

next_session_entry

부서장 역할의 agy 전환 여부를 결정한 뒤, 해당 역할의 ready_marker를 검증해주세요.


2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.11

CEO 버튼이 Claude Code 로그인 화면으로 빠진 현상을 막연한 실행 실패로 두지 않고 `agy` 탐지 경로로 좁혀간 과정이 명료합니다. `agents.json`에 Linux 형식의 `~/.local/bin/agy`가 들어 있어 Windows에서 바이너리를 찾지 못한다는 원인을 확인하고, Antigravity CLI `1.1.10`의 Windows 절대경로로 고쳤어요. 증상과 원인, 수정 위치가 한 흐름으로 이어집니다.

원문은 `cys agent-detect`의 결과를 Trace에서는 ‘미감지(경로 오류)’와 ‘감지 확인’으로, repair_log와 Station F3 문지기 1에서는 ‘agy verified’로 적었고, 여기에 더해 실행 근거 카드의 `discovery_status`와 `behavior_status`에도 각각 `verified`가 남아 있습니다. 기계 확인과 별도로 CEO 버튼을 눌러 `agy`가 자동 실행되고 Gemini 3.6 Flash가 로드된 뒤 준비 상태와 사용자 입력까지 확인한 덕분에, 경로 문자열만 바뀐 것이 아니라 목표 동작이 돌아왔다는 판정이 됐습니다.

기록에 `rollback_tested: false`를 남긴 점도 정확해요. 백업과 복구 절차가 있다는 사실은 실제로 되돌아갔다가 정상 상태로 복귀했다는 근거와 다릅니다. 원본 설정으로 돌아가 `agy` 미감지와 대체 동작을 확인한 뒤 수정본을 다시 적용해 감지와 CEO 버튼 기동이 돌아오는 한 번의 왕복을 남기면, 문서화된 복구와 실행된 복구가 분리됩니다.

Windows 경로 한 줄을 고친 결과보다 실패한 버튼에서 탐지·기동·준비·입력까지 판정 경로를 복원한 과정이 더 값집니다. 같은 환경 차이를 만난 사람이 어디서 확인을 시작하고 무엇을 보고 끝낼지 따라갈 수 있도록 수리 근거를 남긴 작업입니다.

뽀짝이 프로필 이미지
뽀짝이2026.08.09

Station A~F2 구조로 설계 계약부터 실행 영수증까지 한 흐름으로 정리하신 게 눈에 들어왔어요. "아직 없는 것 1줄"을 명시하고 시작하는 방식이 특히 좋았어요 — 모르는 걸 인정하고 검증 범위를 미리 좁혀두는 거잖아요.

Windows에서 Linux 방식 경로(~/.local/bin/agy)가 그대로 남아 있어 감지가 안 됐다는 진단이 깔끔했어요. agent-detect로 수정 전/후를 기계 게이트로 확인하고, CEO 버튼 클릭으로 사람 게이트까지 두 단계 검증한 점이 설계 계약에서 세운 기준을 실제로 지킨 거라 신뢰가 갔습니다.

꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기