Codex,
노치 안으로.

Mac에서 받는 Codex 알림, 승인, 5시간·주간 한도

Gnista는 모든 Codex 세션을 MacBook 노치에 보여 줘요. Codex가 명령을 실행하거나 패치를 적용하려 하면 거기서 허용하거나 거부하고, 턴이 끝나면 거기서 답장하세요. 5시간 한도와 주간 한도는 세션 바로 아래에 있어요.

7일 무료로 써 보기 계정·카드 불필요 · 이후 €19 한 번
01한눈에

Codex 연동, 한눈에.

실행 환경
모든 터미널이나 편집기의 터미널(VS Code 포함)에서 도는 Codex CLI, Codex 앱의 스레드, IntelliJ IDEA 등 JetBrains IDE의 AI 채팅 속 Codex, Xcode의 Codex(방법), 그리고 Linux 서버에서 SSH로 쓰는 Codex CLI.
설정
~/.codex/hooks.json의 훅. 연결할 때 ~/.codex/config.toml에 신뢰한 것으로 기록해서, Codex에서 따로 신뢰할 건 없어요.
응답 대기 중
권한 요청을, 명령이나 패치 전체와 함께. 턴이 끝날 때 Codex가 하는 질문도요.
노치에서 응답
‘허용’, 또는 Codex가 읽을 이유를 적을 수 있는 ‘거부’. Codex가 훅에서 받지 않아서 ‘항상 허용’은 안 돼요. 턴이 끝날 때의 질문에도 답변할 수 있고, 고른 답은 다음 메시지로 들어가요.
노치에서 답장
돼요, Codex 자체의 codex queue를 통해서요. Codex가 쉬고 있으면 바로, 바쁘면 턴이 끝난 뒤예요.
줄에 보이는 것
세션 제목, 입력한 프롬프트, 최근 메시지, 명령이나 패치, 계획 진행 상황(‘3/7 · Writing tests’), 모드, 컨텍스트, 비용.
서브에이전트
보여요. 어느 서브에이전트가 일하는지, 지금 단계, 몇 개가 끝났는지가 줄에 나와요.
비용과 한도
턴마다 해당 모델의 요금으로 계산한 비용, 그리고 5시간 한도와 주간 한도. Codex 자체 세션 기록에서 읽어요.

허용. 거부. 그리고 계속.

노치가 열리고 Codex가 실행하려는 명령이나 패치를 그대로 보여 줘요. 허용하거나, 이유를 적어 거부하세요. Codex가 ‘Denied from Gnista’를 보여 주고 그 응답을 받아 이어 가요.

답장은 세션으로 직행.

Gnista는 Codex 자체의 codex queue를 써서, 노치에서 보낸 답장이 어느 터미널이나 편집기에서든 열려 있는 세션에 직접 쓴 메시지로 나타나요. Codex가 쉬고 있으면 바로, 바쁘면 턴이 끝난 뒤예요. 터미널에서 Codex를 이미 종료했다고요? 답장하면 백그라운드에서 세션이 다시 이어져요. 거기서는 Codex가 아무것도 물어볼 수 없어서, 샌드박스가 허용하는 일만 해요.

진행 상황을 한눈에.

Codex의 계획이 줄에 진행 상황으로, 지금 하는 단계와 함께 보여요. 서브에이전트도요. 모드도 보여요. Plan, Auto, Don’t ask, Bypass.

한도는 묻지 않아도.

Codex는 턴마다 사용량 한도를 기록해요. Gnista가 그걸 읽어서 세션 아래에 5시간 한도와 주간 한도를 보여 주고, 턴마다 해당 모델의 요금으로 비용을 계산해요. Gnista가 모르는 모델이면 모델 파일에 적어 주세요.

Codex에서 안 되는 것, 그리고 그 이유.

  • Codex는 훅에서 ‘항상 허용’을 받지 못해서, 노치에는 ‘허용’과 ‘거부’만 있어요. 계속 허용하려면 Codex에서 하세요.
  • Codex는 세션이 시작될 때 훅을 읽어서, Gnista를 연결하기 전에 시작한 세션은 새 세션을 시작할 때까지 훅을 건너뛰어요.
  • 응답하지 않으면 Codex가 직접 확인을 요청해요. 세션의 탭에 있으면 바로, 노치가 닫혀 있으면 10초 뒤, 노치를 보고 있으면 길어야 45초 뒤예요.
  • /new나 /resume 뒤에는, 이전 세션의 줄이 Codex가 그 세션을 놓아주는 1분쯤 뒤에 사라져요.
02설정

연결은 1분이면 끝.

  1. Gnista를 열고 Codex에 체크하세요. Gnista가 ~/.codex/hooks.json과 ~/.codex/config.toml을 ~/Library/Application Support/Gnista/Backups/에 백업한 뒤, 기존 훅 옆에 자기 훅을 추가하고, 직접 신뢰했을 때 Codex가 하듯 신뢰한 것으로 기록해요.
  2. 새 Codex 세션을 시작하세요. 묻지 않고 Gnista의 훅을 실행해요.
  3. 노치에서 요청에 응답하려면 설정 ▸ 일반 ▸ Gnista에서 권한 요청에 응답을 켜세요.
03FAQ

Codex, 묻고 답하기.

노치에서 Codex 요청에 응답할 수 있나요?

네. 설정 ▸ 일반 ▸ Gnista에서 권한 요청에 응답을 켜면 ‘허용’, 또는 이유를 적을 수 있는 ‘거부’. ‘항상 허용’은 없어요. Codex가 훅에서 받지 않거든요. 응답하지 않으면 Codex가 직접 확인을 요청해요.

Codex가 왜 Gnista에 안 보이나요?

Codex는 세션이 시작될 때 훅을 읽어서, Gnista를 연결하기 전에 시작한 세션은 훅을 건너뛰어요. 새 세션을 시작하세요. Codex에서 따로 신뢰할 건 없어요. 연결하면 ~/.codex/config.toml에 Gnista의 훅이 신뢰한 것으로 기록돼요.

Codex 앱에서도 되나요?

네. 앱도 같은 훅으로 Codex를 돌려서, 스레드마다 여느 세션처럼 줄이 생기고 앱은 Codex로 표시돼요. 클릭하면 그 스레드가 열려요.

노치에서 Codex에 답장할 수 있나요?

네, 어느 터미널이나 편집기에서든요. Gnista가 답장을 codex queue에 넘겨서, 세션에 직접 쓴 메시지로 나타나요.

Gnista가 Codex 사용량 한도를 보여 주나요?

네. 5시간 한도와 주간 한도, 무료 플랜이라면 한도 하나를 Codex 자체 세션 기록에서 읽어요. 따로 켤 것도, 로그인할 것도 없어요.

Codex 설정을 바꾸나요? 어떻게 제거하나요?

~/Library/Application Support/Gnista/Backups/에 둘 다 백업한 뒤 ~/.codex/hooks.json에 훅을 추가하고 ~/.codex/config.toml에 신뢰한 것으로 기록해요. 기존 훅은 건드리지 않아요. 설정 ▸ 에이전트 ▸ Codex ▸ 연결 해제를 누르면 Gnista의 훅과 그 신뢰 기록만 정확히 사라져요.

서버에서 SSH로 쓰는 Codex도 되나요?

네, Linux 서버라면요. 설정 ▸ 원격에서 ssh 설정에 있는 호스트로 서버를 연결하세요. Gnista가 그곳에 헬퍼를 두고, 서버에 있는 Codex의 hooks.json에 훅을 추가하고, Mac에서처럼 그곳에서도 신뢰한 것으로 기록해요. 세션은 머신 이름과 함께 제목, 최근 메시지, 비용까지 보여요. 노치에서 한 응답은 그곳의 Codex에 닿고, 클릭하면 ssh로 접속했던 터미널 탭(tmux 페인 포함)이나 편집기의 Remote-SSH 윈도우로 이동해요. 단계별 안내: SSH로 쓰는 에이전트.

Gnista가 함께 지켜보는 에이전트

에이전트를 직접 만들었나요? JSON 한 줄이면 Gnista에 상태를 알릴 수 있어요. 자세한 건 커스텀 에이전트에서.