CLI 명령어

• agy 는 현재 폴더에서 TUI 세션을 여는 명령이다
• 셸에서 치는 서브커맨드와 세션 안 슬래시 커맨드를 구분해서 외운다
• 릴리스가 잦아서 최종 목록은 세션에서 ? 로 확인한다

PATH 부터

agy 가 안 잡히면 PATH 부터 본다. 내 로컬에서 처음 정리할 때는 1.1.10 이었는데, 거의 이틀에 한 번씩 릴리스가 나오는 도구라 2026년 10월에는 벌써 1.3.1 이다. agy update 로 올리면 된다.

export PATH="$HOME/.local/bin:$PATH"
# 또는
source ~/.zshrc

agy --version

시작과 실행

그냥 agy 를 치면 현재 폴더에서 세션이 열린다. 프롬프트를 같이 주면 첫 지시까지 넣고 시작하고, -p 를 붙이면 한 번 실행하고 출력만 남긴 채 끝난다. CI 나 스크립트에서는 -p 를 쓴다.

셸에서 치는 서브커맨드

세션을 열지 않고 셸에서 바로 치는 명령들이다. 모델 목록, 플러그인 관리, 업데이트가 여기 있다. Gemini CLI 에서 쓰던 확장은 plugin import gemini 로 가져올 수 있다.

세션 안 슬래시 커맨드

세션 안에서는 / 를 치면 메뉴가 뜨고, 프롬프트가 비어 있을 때 ? 를 치면 도움말이 나온다. 자주 쓰는 건 모델 변경, 플랜 모드, 권한, 대화 되돌리기 정도다. /btw 는 본 대화를 끊지 않고 옆에서 하나 물어볼 때 쓴다.

환경에 따라 메뉴에 /goal(끝까지 자율 실행), /grill-me(먼저 질문하고 시작), /browser(브라우저 사용), /schedule(예약, 주기 실행) 같은 실행 계열도 보인다.

단축키는 두 개만 기억한다. Shift+Tab 은 default, accept-edits, plan 순으로 모드를 돌리고, ! 뒤에 명령을 치면 셸 명령을 바로 실행한다.

처음 쓸 때 순서

나는 회사 모노레포 루트에서 agy 를 열고, ? 로 명령 목록을 보고, /permissions 로 권한을 확인한 다음 레포 설명부터 시켜 본다.

cd ~/develop/<monorepo>
agy
# 안에서
?                 # 명령 목록
/permissions      # 권한 확인
/model            # 모델
이 레포 홈 성능 관련 최근 변경 설명해줘

비대화형은 이런 식으로 쓴다.

agy -p "apps/<앱> 홈 배너 queryKey 에 bnType 이 있는지 찾아줘"

명령이 자주 바뀌는 도구라, 설치된 버전에 맞는 최종 목록은 세션에서 ? 를 쳐서 확인하는 게 제일 정확하다.