터미널 기록

cdg cap은 명령의 출력을 실시간으로 보여 주면서, 명령줄, 섞인 stdout과 stderr, 종료 코드, 작업 폴더를 기록합니다. cdg term은 그 기록을 꺼내 주고, cdg pack은 마지막으로 실패한 기록을 씁니다.

기록은 모든 프로젝트가 컴퓨터 한 곳에 모이므로, cap과 term은 저장소가 있든 없든 어느 폴더에서나 쓸 수 있습니다.

명령 하나 기록하기: cap

cdg cap -- pytest -q                # -- 뒤의 플래그는 실행할 명령의 몫
cdg cap "npm run build | tail -20"  # 파이프가 있으면 따옴표로 감싸기

출력은 cap 없이 실행할 때와 똑같이 보입니다. 종료 코드도 그대로 전달됩니다. 파이프라인이 어떻게 실행되는지는 cdg cap을 참고하세요.

기록 꺼내 보기: term

cdg term              # 마지막 명령과 출력
cdg term -n 3         # 최근 3개
cdg term -f           # 마지막으로 실패한 명령
cdg term --here -n 3  # 이 프로젝트에서 실행한 최근 3개
cdg term -i 2         # 두 번 전에 실행한 명령 하나만
cdg term --context    # 복사 내용에 실행 PC 이름과 셸 정보 추가 (선택)
cdg term path         # 기록 파일 위치 (CODIGEST_HOME으로 바꿀 수 있음)
cdg term clear        # 기록 모두 지우기

cap 없이 실행한 명령은 셸의 히스토리(PowerShell, bash, zsh, fish)에서 읽어 오며, 이때는 출력이 없습니다. --history-only를 붙이면 이 히스토리만 읽습니다.

PC 이름은 민감할 수 있어서 기본으로는 넣지 않습니다. --context를 붙이면 복사 내용에 hostname과 shell 속성이 붙습니다. 호스트 이름은 명령을 기록하는 시점에 저장하므로, 오래된 기록에는 없을 수 있고 그래도 cdg term은 문제없이 동작합니다.

모든 명령 기록하기: install

cdg term install은 설치되어 있는 셸에 맞춰 PowerShell 프로필, ~/.bashrc, ~/.zshrc에 훅을 추가합니다. --shell powershell|bash|zsh|all로 고를 수 있고, Windows의 Git Bash는 bash로 칩니다. cdg term uninstall로 훅을 제거합니다.

명령은 원래 세션에서 그대로 실행되므로 cd, 변수, 함수가 모두 평소처럼 동작하고, 히스토리에도 입력한 그대로 남습니다. 실제 터미널이 필요한 프로그램은 기록하지 않습니다. 기록하지 않는 것을 참고하세요.

cdg term install                 # 찾은 셸 전부
cdg term install --shell bash    # 셸 하나만
cdg term uninstall

바뀌는 것은 각 시작 파일에 들어가는 표시된 블록 하나이며, # >>> codigest terminal capture >>>와 # <<< codigest terminal capture <<< 사이에 있습니다. 새로 연 셸 창부터 적용됩니다. 지금 창에서 켜는 줄은 설치할 때 출력해 줍니다.

이 블록은 설치된 패키지 안의 파일이 아니라, install이 데이터 폴더의 shell/ 폴더에 둔 훅 사본을 불러옵니다. codigest를 업데이트한 뒤에는 cdg term install을 다시 실행해 사본을 갱신하세요.

기록하지 않는 것

줄이 아래 중 하나로 시작하면 기록 없이 입력한 그대로 실행합니다.

• 편집기, 페이저, 터미널: vim, nvim, nano, emacs, less, more, man, ssh, htop, btop, top, fzf, lazygit, tmux, screen, claude, codex, wsl, exit. bash와 zsh에서는 exec, fg, bg도 해당합니다.
• 전체 화면 도구: herdr, zellij, k9s, lazydocker, gitui, tig, yazi, ranger, nnn, mc, vifm, broot, hx, helix, micro, ncdu, btm, glances, nvtop. 기록용 파이프를 거치면 터미널이 없어서 멈춰 버립니다.
• 입력을 기다리는 프롬프트:
  • docker, podman, kubectl의 run, exec, attach, start에 -i, -t, --interactive, --tty 플래그가 붙은 경우
  • npm, pnpm, yarn, bun의 init, create와 npx create-...
  • pip uninstall (PowerShell에서는 -y나 --yes를 주면 기록합니다)
  • gh auth login, az login, gcloud auth login, gcloud init, aws configure, ssh-keygen, ssh-copy-id
  • sudo, 그리고 PowerShell의 runas, bash와 zsh의 su, doas
  • 데이터베이스 셸과 REPL: mysql, psql, sqlite3, redis-cli, mongosh, duckdb, julia, irb, ghci, ollama run
• 인자 없는 인터프리터와 셸(python, node, bash, pwsh 등), cdg term, cdg mcp, 그리고 메시지 없는 git commit, git rebase -i, git add -p, git mergetool.

입력을 기다리는 프롬프트를 기록하지 않는 이유는, 줄바꿈으로 끝나지 않는 질문은 기록용 파이프 안에서 다음 줄바꿈이 올 때까지 화면에 나타나지 않아 명령이 멈춘 것처럼 보이기 때문입니다.

긴 출력과 종료 상태

• 긴 출력. PowerShell 훅은 명령 출력의 앞 2,000줄과 뒤 2,000줄만 보관하고, 버린 줄 수를 표시해 둡니다. bash와 zsh에서는 기록 파일이 4 MB보다 크면 앞과 뒤에서 1 MB씩 읽습니다. 어느 쪽이든 저장소는 그다음 최대 64 KB만 남깁니다. 그래서 몇 시간 켜 둔 서버가 메모리를 채우지 않습니다.
• 종료 상태. PowerShell에서는 네이티브 명령이 실행되었으면 그 종료 코드를 씁니다. 그렇지 않으면 오류가 화면에 나왔거나 종료를 일으키는 오류가 발생했을 때 실패로 칩니다. -ErrorAction으로 감춘 오류는 실패가 아닙니다.
• PowerShell 훅이 물러나는 곳. 원격 세션, 중첩 프롬프트, 디버거에서는 줄을 감싸지 않습니다. 그곳의 줄은 다른 runspace에 보내는 것이거나 c, s, v 같은 디버거 명령이기 때문입니다.

조절하기

• 명령 하나만 기록하지 않으려면 맨 앞에 공백을 넣습니다.
• 기록하지 않을 프로그램을 더 지정하려면: PowerShell에서는 $env:CODIGEST_CAP_SKIP = '^\s*(myrepl|mytui)\b', bash/zsh에서는 export CODIGEST_CAP_SKIP='^(myrepl|mytui)( |$)'(확장 정규식).
• 지금 세션에서만 끄려면: PowerShell에서는 $env:CODIGEST_NOCAP = 1, bash/zsh에서는 export CODIGEST_NOCAP=1.
• 훅을 없애려면: cdg term uninstall.

현재 셸에서 훅이 켜져 있지 않으면 cdg term이 알려 주고, 그 창에서 켜는 방법도 보여 줍니다.

훅이 동작하는 방식

PowerShell. 훅이 PSConsoleHostReadLine을 대신합니다. PSReadLine이 내가 입력한 줄을 돌려준 뒤, 훅은 그 줄을 호출한 쪽의 스코프에서 실행하며 출력을 복제하는 형태로 감싸서 엔진에 넘깁니다. 화면과 히스토리에는 입력한 그대로 남습니다.

bash와 zsh. Enter를 누르면 줄을 기록해 둡니다. 명령이 실행되기 직전에 셸의 stdout과 stderr를 tee를 거쳐 비공개 임시 파일로 보내고, 다음 프롬프트 전에 원래대로 돌려놓습니다.

두 경우 모두 완성된 기록은 백그라운드 프로세스에서 cdg term ingest로 넘어가며, 비밀정보 가리기는 디스크에 쓰기 전에 거기서 이루어집니다. ingest가 실패하면 기록 옆의 ingest-errors.log에 남습니다.

알아 둘 점

• 기록되는 프로그램은 터미널이 아니라 파이프로 출력하게 되므로, 색이나 진행 막대가 사라지는 프로그램이 있습니다.
• bash(4 이상)와 zsh에서는 여러 줄에 걸친 명령(여러 줄로 입력한 반복문, heredoc), 백그라운드 작업(cmd &), ! 히스토리 확장을 쓴 줄은 기록하지 않고 그냥 실행합니다. bash에서는 서브셸 ( ... )로 시작하는 줄도 마찬가지입니다.
• bash 훅은 DEBUG 트랩을 씁니다. 첫 프롬프트 전에 설정된 트랩(starship, bash-preexec)은 그대로 두지만, 그 뒤에 새로 설정한 DEBUG 트랩은 훅을 덮어씁니다.

저장되는 내용

기록 하나에는 명령, 출력, 종료 코드, 작업 폴더, 셸, 호스트 이름, 시작 시각, 걸린 시간이 들어 있습니다.

• 정리. 색 코드는 지우고, 진행 막대처럼 같은 줄을 덮어쓰는 출력(캐리지 리턴)은 마지막 상태만 남깁니다. 그래서 pytest나 pip을 한 번 실행해도 수 MB의 화면 갱신이 쌓이지 않습니다.
• 가리기. 토큰과 password=... 형태의 값은 기록하기 전에 가립니다. 인증 정보를 출력하는 명령은 출력을 아예 저장하지 않습니다. 보안을 참고하세요.
• 상한. 한 줄에 하나씩 JSON으로 적는 파일 하나에 최근 명령 200개를 보관합니다. 출력은 명령 하나당 64 KB까지 저장하고, 넘치면 앞 32 KB와 뒤 32 KB만 남기고 가운데에 표시를 넣습니다. 이런 기록에는 블록에 truncated="true"가 붙습니다.
• 위치. cdg term path로 파일을 확인할 수 있습니다. macOS와 Linux에서는 본인만 읽을 수 있게 저장합니다. CODIGEST_HOME으로 옮길 수 있습니다. 구조를 참고하세요.