Codex CLI 백그라운드 작업 확인: /ps로 실행 중 터미널을 처음 보는 법
TL;DR
Codex CLI의 백그라운드 터미널을 확인하려면 운영체제 셸이 아니라 TUI 입력창에서
/ps
를 선택합니다. 목록이 있으면 각 터미널의 명령, 상태, 최근 비어 있지 않은 출력 최대 3줄을 읽습니다.
unified_exec
가 사용되지 않는 상태라면 목록이 비어 있을 수 있습니다. 빈 결과만으로 설치 오류나 작업 실패를 단정하지 않습니다.
핵심 3줄 요약
핵심 1
/ps
는 현재 Codex 세션의 background terminal 현황을 읽는 slash command입니다.
핵심 2
command와 status, 최근 비어 있지 않은 출력 최대 3줄을 확인합니다.
핵심 3
빈 목록도 정상일 수 있으며 첫 확인에서는 작업을 중지하거나 재실행하지 않습니다.
이 글에서 다룰 내용
-
/ps를 입력할 정확한 위치와 Enter 전 completion 확인 - 목록에서 명령·상태·최근 출력만 읽는 순서
- 빈 목록을 실패로 오해하지 않는 기준
-
/stop·/statusline과 구분해야 할 이유
Codex `/ps`는 무엇인가
/ps
는 현재 Codex 세션의 background terminal 목록과 상태를 확인하는 명령입니다. 공식 문서는 각 항목의 command와 최근 비어 있지 않은 출력 최대 3줄을 함께 보여 준다고 설명합니다.
background terminal은
unified_exec
가 사용 중일 때 나타납니다. 그렇지 않으면 목록이 비어 있을 수 있습니다. 빈 목록은
/ps
가 실행되지 않았다는 뜻이 아니라 현재 표시할 항목이 없다는 뜻일 수 있습니다.
현재 공식 페이지는 이 절차의 운영체제, 터미널, 플랜, 지역, 언어, 최소 버전 조건을 따로 적지 않습니다. 따라서 현재 Codex 입력창에서
/ps
설명이 실제로 보이는지 먼저 확인해야 합니다.
언제 쓰면 좋은가
현재 세션에 background terminal이 남아 있는지, 어떤 명령이 어느 상태인지 빠르게 확인할 때 맞습니다. 작업이 진행 중이라는 말만 듣기보다
/ps
에 표시된 명령과 최근 출력을 직접 읽으면 다음 판단에 필요한 근거를 얻을 수 있습니다.
다만
/ps
는 완료 검증기가 아닙니다. 최근 출력 세 줄은 전체 로그가 아니며, 목록에 항목이 있다는 사실도 테스트 통과나 빌드 성공을 보증하지 않습니다. 이 글의 첫 완료 지점은 현황을 읽어 내부 검토 메모로 남기는 데까지입니다.
`/ps`로 처음 확인하는 5단계
1. 비민감한 현재 세션에서 입력창을 찾습니다
프로젝트 파일이나 고객 데이터를 새로 열 필요는 없습니다. Codex 대화형 TUI가 입력을 받을 수 있는 상태인지 먼저 봅니다. 운영체제 셸의
ps
명령과 Codex의
/ps
를 섞지 마세요.
이번 검증은 비민감 빈 폴더와 격리된
CODEX_HOME
에서 진행했습니다. 모델 요청, 프로젝트 파일 생성, 실제 사용자 설정 변경은 없었습니다.
2. `/ps`를 입력하고 completion을 확인합니다
Codex 입력창에
/ps
를 입력한 뒤 곧바로 Enter를 누르지 않습니다. 현재
codex-cli 0.144.6
에서는 background terminals를 표시한다는 completion 설명이 나타났습니다.
설명이 보이지 않으면 입력을 취소합니다. 인식 여부가 불분명한 slash token을 일반 프롬프트로 제출하지 않습니다. 로컬 관찰 결과를 다른 버전이나 터미널의 보편 조건으로 확대하지도 않습니다.
3. Enter를 한 번 눌러 결과를 엽니다
completion 설명을 확인한 다음 Enter를 한 번 누릅니다. 목록이 있으면 각 항목의 command와 status를 먼저 읽습니다. 이어서 최근 비어 있지 않은 출력이 표시되는지 확인합니다.
공식 문서가 밝힌 범위는 최근 출력 최대 3줄입니다. 화면에 없는 전체 로그, 종료 코드, 산출물 상태를 추정해서 메우지 않습니다.
4. 목록이 비어 있으면 정상 경계를 확인합니다
공식 문서는
unified_exec
가 사용 중이 아니면 background terminal 목록이 비어 있을 수 있다고 설명합니다. 이번 격리 시험에서도 명시적인 빈 결과가 나타났고 모델 turn은 시작되지 않았습니다.
따라서 빈 목록만 보고 기능 미지원, 설치 오류, 작업 실패로 기록하지 않습니다. 현재 세션에서 표시할 background terminal이 없다는 범위까지만 적습니다.
5. 읽기 전용 메모에서 첫 확인을 끝냅니다
목록이 있으면 command, status, 최근 출력 최대 3줄을 한 항목씩 기록합니다. 목록이 없으면 빈 결과와 확인 시점을 적습니다. 보이지 않은 정보는
확인 필요
로 남깁니다.
첫 확인에서는
/stop
, 재실행, 설정 변경, 외부 공유를 하지 않습니다. 어떤 조치를 취할지는 사람이 원래 작업 목적과 전체 로그를 검토한 뒤 별도로 승인합니다.
결과 정리용 복사 프롬프트
아래 프롬프트는
/ps
자리에 입력하는 명령이 아닙니다.
/ps
에서 읽은 비민감 정보만 내부 검토 메모로 정리할 때 선택적으로 사용합니다.
목표: 현재 Codex 세션의
/ps
결과를 읽기 전용 작업 현황 메모로 정리합니다.
허용 입력:
/ps
에 실제로 보인 한 항목의 command, status, 최근 비어 있지 않은 출력 최대 3줄만 사용합니다.
제외 입력: 비밀값, 고객명, 실명, 이메일, 계정 식별자, 전체 내부 경로,
/ps
에 보이지 않은 로그, 다른 세션 정보는 사용하지 않습니다.
출력 형식: 1) command · 2) status · 3) 최근 출력에서 확인된 신호 · 4) 확인 필요 항목 · 5) 승인 전 금지 조치
완료 기준: 모든 문장을 허용 입력의 어느 줄과 대조할 수 있어야 합니다. 보이지 않은 정보는 확인 필요로 남깁니다.
추정 금지: 테스트 통과, 빌드 성공, 종료 코드, 산출물 생성, 실패 원인을 화면 근거 없이 만들지 않습니다.
승인 지점: 사람이 전체 로그와 작업 목적을 검토하기 전에는 중지, 재실행, 설정 변경, 결과 공유를 제안으로만 남깁니다.
실전 인사이트
/ps
에서 먼저 볼 것은 command와 status입니다. 최근 출력은 그 상태를 해석할 짧은 단서로만 사용합니다. 최대 3줄이라는 범위를 넘겨 전체 경과를 안다고 가정하지 마세요.
같은 원칙은 빈 결과에도 적용됩니다.
unified_exec
가 사용되지 않는 상태에서는 목록이 비어 있을 수 있습니다. 결과가 없다는 사실과 기능이 고장 났다는 판단을 분리해야 불필요한 재실행을 줄일 수 있습니다.
`/stop`·`/statusline`과 구분하기
/ps
는 background terminal 현황을 읽습니다.
/stop
은 현재 세션의 background terminal을 중지하는 별도 명령입니다. 확인과 중지는 같은 작업이 아닙니다. 첫 점검에서
/stop
까지 이어서 실행하지 않습니다.
/statusline
은 TUI footer에 표시할 항목을 고르고 설정에 저장합니다.
/ps
는 picker나 설정 저장 없이 현재 목록을 한 번 읽습니다. 최근 post_id 4807은
/statusline
설정 흐름이며 이번 글의 첫 행동과 기대 답이 다릅니다.
주의할 점
-
/ps는 Codex TUI 입력창에서 선택하며 운영체제 셸의ps와 다릅니다. - Enter 전 completion 설명이 없으면 실행하지 않습니다.
- 목록이 비어도
unified_exec가 사용되지 않은 정상 상태일 수 있습니다. - 최근 출력은 최대 3줄이므로 전체 로그나 최종 결과로 해석하지 않습니다.
- 명령과 출력에 비밀값이나 내부 정보가 보이면 외부 도구나 공개 채널에 복사하지 않습니다.
-
/stop, 재실행, 설정 변경은 현황 확인과 분리해 사람이 승인합니다.
자주 묻는 질문
/ps를 일반 터미널 셸에서 실행해도 되나요?
아닙니다. 이 글의
/ps
는 Codex 대화형 TUI 안의 slash command입니다. 입력창에서 completion 설명을 확인한 뒤 Enter를 한 번 누르세요.
목록이 비어 있으면 /ps가 고장 난 건가요?
그렇게 단정할 수 없습니다. 공식 문서는
unified_exec
가 사용 중이 아니면 목록이 비어 있을 수 있다고 설명합니다. 현재 표시할 항목이 없다는 범위로 기록하세요.
목록에서는 무엇까지 확인할 수 있나요?
공식 문서 기준으로 각 background terminal의 command와 status, 최근 비어 있지 않은 출력 최대 3줄을 확인할 수 있습니다. 전체 로그나 최종 성공 여부는 별도로 검토해야 합니다.
확인한 작업을 바로 중지해도 되나요?
아닙니다.
/stop
은 중지 기능이고
/ps
는 현황 확인 기능입니다. 원래 작업 목적과 전체 로그를 사람이 검토한 뒤 중지 여부를 별도로 승인하세요.
출처
OpenAI Codex Developer Commands 공식 문서 —
/ps
의 진입점, command·status·최근 출력 최대 3줄,
unified_exec
미사용 시 빈 목록 가능성을 확인했습니다.
마무리
Codex의 background terminal 첫 확인은
/ps
completion 확인 → Enter 한 번 → command·status·최근 출력 읽기 → 빈 결과 경계 확인 → 읽기 전용 메모로 끝납니다. 목록을 진행 상황의 단서로 사용하되 전체 로그와 성공 여부까지 추정하지 마세요.
