cokacmux

코딩에이전트를 위해 섬세하게 설계된 Multiplexer, cokacmux.

바이브코딩을 통해 우리는 멋진 코드를 얻습니다. 그런데 놓치지 말아야 할 멋진 것이 하나 더 있습니다. 바로 그 코드를 얻기까지 거쳤던 과정, 즉 세션 안에 담긴 대화 내용입니다.

이 대화는 그 코드를 얻기 위해 사용했던 노하우 그 자체이며, 나중에 스킬셋처럼 재활용할 수 있습니다.

cokacmux는 Claude Code, Codex, Pi, OpenCode, GJC 같은 많은 사랑을 받고 있는 코딩 에이전트들이 만들어 내는 여러 세션을 한눈에 관리하고 다시 사용할 수 있는 인터페이스입니다.

코딩에이전트를 위해 섬세하게 설계된 Multiplexer라고 이해하면 쉽습니다. 여러 프로젝트를 동시에 다룰 때도 agent와 terminal을 안전하게 백그라운드에 둔 채 필요한 세션으로 바로 돌아갈 수 있습니다.

cokacmux 자체가 새 AI 요금을 만들지는 않습니다. 다만 세션을 다시 열면, 선택한 코딩 도구는 평소처럼 자기 서비스와 통신할 수 있습니다.

1. 이 앱으로 할 수 있는 일
2. 설치하기
3. 처음 실행하기
4. 기본 사용법
5. 자주 쓰는 키
6. 문제가 생겼을 때
7. 업데이트와 제거
8. 알아둘 점
9. 사용 조건
10. 면책조항

Claude Code, Codex, Pi, OpenCode, GJC의 작업 세션을 한 화면에서 볼 수 있습니다. 최종 코드뿐 아니라 그 코드를 만들던 대화와 작업 폴더까지 같이 남겨 둡니다.

Codex가 작업 과정에서 만든 non-root 세션은 기본 목록에서 따로 숨겨 최상위 작업과 섞이지 않게 합니다. 앱은 실행할 때마다 top-level 범위로 시작하며, u를 누르면 현재 실행에서만 전체 세션을 다시 표시할 수 있습니다. SUB는 spawned subagent, REV는 review, AUX는 compact·memory 등 기타 보조 작업, INT는 Codex 내부 작업을 뜻합니다. 표식 공간이 5칸 이상이면 [SUB]처럼, 3–4칸이면 SUB처럼, 1–2칸이면 S, R, A, I로 줄여 표시합니다.

현재 범위는 일반 검색과 AI 검색에도 적용됩니다. u로 범위를 바꾸면 이전 범위의 검색 결과는 해제됩니다. Codex 저장 형식은 Ultra의 자동 spawn과 명시적인 spawn을 같은 종류로 기록하므로 둘을 더 세분할 수는 없습니다. 판별할 수 없는 세션은 목록에 남으며, 숨긴 세션 데이터는 삭제되거나 변경되지 않습니다.

목록에서 세션을 고르면 오른쪽에서 내용을 읽을 수 있습니다.

Ctrl+F를 누르면 세션을 찾을 수 있습니다.

• 글자로 찾기: 제목, 폴더, 세션 내용에서 찾습니다.
• AI로 찾기: 선택한 코딩 도구에게 관련 세션을 찾아 달라고 합니다.

세션을 고르고 e 또는 Enter를 누르면 그 작업을 다시 열 수 있습니다.

Ctrl+N을 누르면 새 명령창, cokacdir, 새 코딩 도구를 열 수 있습니다.

여러 코딩 도구와 명령창을 동시에 켜 둘 수 있습니다. 목록으로 돌아와도 작업은 꺼지지 않습니다. 필요할 때 원하는 작업을 골라 다시 들어갈 수 있습니다.

그래서 여러 프로젝트를 번갈아 보거나, 한 작업은 실행해 둔 채 다른 작업을 확인하는 식으로 사용할 수 있습니다.

c를 누르면 선택한 세션을 하나 더 만들 수 있습니다. 필요하면 작업 폴더도 함께 복사할 수 있습니다. 원본 맥락은 보존하고 다른 방향의 수정이나 다른 코딩 도구로 실험할 때 씁니다.

Delete 또는 d를 누르면 세션 기록을 지울 수 있습니다. 바로 지우지 않고 먼저 물어봅니다.

배포 정책: 이 프로젝트는 cokacmux/cokacdir 설치 파일에 checksum, 디지털 서명, signed manifest 또는 attestation을 요구하지 않습니다. 또한 GitHub Actions와 .github/workflows를 사용하지 않으며, 검증은 필요할 때 로컬에서 수행합니다. 이는 누락된 작업이 아니라 명시적인 프로젝트 정책입니다. 자세한 내용은 프로젝트 정책을 참고하세요.

명령창에 아래 내용을 붙여 넣고 Enter를 누르세요.

curl -fsSL https://cokacmux.cokac.com/manage.sh | bash

PowerShell에 아래 내용을 붙여 넣고 Enter를 누르세요.

irm https://cokacmux.cokac.com/manage.ps1 | iex

설치가 끝나면 새 명령창을 열어 주세요.

cokacmux --version

버전 번호가 나오면 설치된 것입니다.

아래 명령 중 내가 쓰는 것만 확인하면 됩니다.

claude --version
codex --version
opencode --version
pi --help
gjc --help

이 중 하나라도 잘 실행되면 cokacmux에서 그 도구의 세션을 다시 열 수 있습니다.

명령창에서 실행합니다.

cokacmux

처음 실행하면 cokacmux가 필요한 폴더를 자동으로 만듭니다.

한 번도 쓰지 않은 코딩 도구가 있어도 괜찮습니다. 그 도구의 세션만 비어 있을 뿐입니다.

화면은 크게 두 부분입니다.

목록에는 아래 정보가 보입니다.

처음에는 지우기나 위험한 실행을 하지 말고 화면 이동만 익혀 보세요.

↑ / ↓로 세션을 고릅니다. 선택이 바뀌면 오른쪽 내용도 바뀝니다.

오른쪽 내용을 읽으려면 Tab을 누르세요. 다시 목록으로 돌아가려면 Tab을 한 번 더 누르면 됩니다.

Ctrl+F를 누릅니다.

AI로 찾으려면 먼저 설정 화면에서 사용할 코딩 도구를 골라야 합니다. 설정 화면은 , 키로 엽니다.

세션을 고르고 e 또는 Enter를 누릅니다.

다시 열기 창에서 Normal이라고 보이면 그것을 고르세요. 이것이 보통 실행입니다.

Skip permissions라고 보이는 선택지는 위험한 실행입니다. 코딩 도구가 파일 수정이나 명령 실행 전에 묻는 확인을 줄입니다. 내가 믿는 폴더에서만 쓰세요.

세션을 실행한 뒤 목록으로 돌아오려면 Ctrl+] 또는 Ctrl+[를 누릅니다. 이때 코딩 도구는 꺼지지 않습니다.

Ctrl+N을 누릅니다.

열 수 있는 것은 세 가지입니다.

새 코딩 도구를 열 때는 Claude Code, Codex, OpenCode, Pi, GJC 중 하나를 고릅니다.

Folder 항목에서는 Tab으로 로컬 디렉터리 자동완성을 쓸 수 있습니다. 후보 목록이 열려 있으면 ↑ / ↓로 고르고, Esc는 목록만 먼저 닫습니다.

명령줄에서 바로 background terminal을 만들 수도 있습니다.

cokacmux start web --cwd /path/to/project -- node server.js

-- 뒤에 실제 실행할 명령과 인자를 둡니다. 이렇게 시작한 명령도 실행 중인 agent 목록에 terminal로 나타나며, Ctrl+] 또는 Ctrl+[로 목록에 돌아가 확인할 수 있습니다.

이 기능은 npm run dev, node server.js, cargo watch처럼 계속 켜 두는 명령에 맞습니다. cokacmux start는 명령을 켠 뒤 바로 shell로 돌아오고, 출력 화면은 나중에 cokacmux TUI에서 다시 볼 수 있게 보관합니다.

Windows에서도 같은 방식으로 쓸 수 있습니다.

cokacmux start web --cwd C:\work\app -- npm run dev

npm.cmd처럼 .cmd 파일로 설치된 명령도 PATH와 PATHEXT 규칙에 따라 찾습니다. 프로그램 경로에 공백이 있어도 일반 Windows 명령처럼 처리합니다. PowerShell 문법이 필요한 명령은 powershell.exe -Command "..."로 감싸면 됩니다.

자세한 CLI 사용법과 제한은 docs/CLI.md를 보세요.

코딩 도구를 실행한 뒤 목록으로 돌아와도 그 도구는 계속 살아 있습니다.

여러 작업을 켜 둔 경우에도 목록에서 원하는 작업을 고르면 바로 돌아갈 수 있습니다. 하나를 끄기 전까지는 컴퓨터 안에서 계속 대기합니다.

Ctrl+Shift+K로 모두 끄기 전에는 확인창이 먼저 뜹니다.

세션을 고르고 c를 누릅니다.

폴더까지 복사하면 시간이 걸릴 수 있습니다.

세션을 고르고 t를 누릅니다.

제목만 바뀝니다. 원래 세션 내용은 바뀌지 않습니다.

제목 편집창에서 Ctrl+T를 누르면 AI가 제목 초안을 만들어 줍니다.

세션을 고르고 Delete 또는 d를 누릅니다.

삭제하면 저장된 세션 기록이 실제로 지워집니다. 중요한 세션은 먼저 따로 보관하세요.

아래는 기본 설정 기준의 단축키 전체입니다. 처음에는 세션 목록과 코딩 도구 화면에서 쓰는 키만 익히면 됩니다. 나중에 익숙해지면 선택창, 제목 편집, 설정 화면의 키를 보면 됩니다.

단축키는 ~/.cokacmux/keybinding.json에서 바꿀 수 있습니다. 이 파일을 바꾼 뒤 저장하면 실행 중인 cokacmux가 다시 읽습니다. BackTab은 보통 Shift+Tab입니다.

세션 목록은 cokacmux를 처음 켰을 때 보이는 화면입니다. 왼쪽에는 세션 목록이 있고, 오른쪽에는 선택한 세션의 내용이 보입니다.

오른쪽 미리보기는 선택한 세션 내용을 읽는 곳입니다. Tab으로 오른쪽에 포커스를 보낸 뒤 사용합니다.

코딩 도구 화면은 Claude Code, Codex, OpenCode, Pi, GJC, 일반 명령창, cokacdir가 실제로 떠 있는 화면입니다. 보통 키 입력은 현재 포커스가 있는 창으로 그대로 전달됩니다. 아래 키들은 cokacmux가 먼저 잡아 처리합니다.

cokacdir 화면에서는 Shift가 들어간 일부 키를 cokacmux가 잡지 않고 cokacdir에 넘깁니다. cokacdir 자체 단축키를 방해하지 않기 위해서입니다.

Ctrl+F를 누르면 바로 검색어를 입력하는 것이 아니라, 먼저 글자 검색과 AI 검색 중 하나를 고릅니다.

검색어를 입력하는 동안에는 일반 글자가 검색어로 들어갑니다.

t로 제목 편집창을 열면 대화 내용은 그대로 두고 표시 제목만 바꿉니다.

Ctrl+N을 누르면 새 terminal, cokacdir, 새 coding agent를 만들 수 있습니다.

대화를 e 또는 Enter로 다시 열 때, 도구에 따라 실행 방식을 고르는 창이 뜹니다.

c를 누르면 선택한 대화를 복사합니다. 같은 도구로 복사할 수도 있고, 다른 도구로 이어갈 수도 있습니다.

이 창들은 실수로 중요한 것을 지우거나 만들지 않도록 한 번 더 묻는 창입니다.

Ctrl+Shift+K 또는 Shift+K로 여러 실행 작업을 한꺼번에 끄기 전에 나오는 창입니다.

,를 누르거나 AI 기능을 처음 쓸 때 설정 화면이 열립니다. 여기서는 AI 검색과 AI 제목 생성에 사용할 도구, 실행 파일 경로 같은 값을 고릅니다.

Codex를 실행할 때는 Codex 안의 transcript/pager가 아래 키를 이해하도록 cokacmux가 설정을 보태 줍니다. 이 키들은 Codex 내부 스크롤을 돕기 위한 것입니다. 같은 키를 cokacmux가 먼저 쓰는 상황에서는 cokacmux 동작이 우선할 수 있습니다.

아래를 확인하세요.

1. Claude Code, Codex, OpenCode, Pi, GJC 중 하나를 한 번이라도 사용했는지 확인합니다.
2. 아래 명령을 실행합니다.

cokacmux --check

3. 그래도 안 되면 아래 명령으로 실행한 뒤 나온 기록을 확인합니다.

cokacmux --debug

내가 쓰는 코딩 도구가 설치되어 있고 로그인되어 있는지 확인하세요.

claude --version
codex --version
opencode --version
pi --help
gjc --help

일부 명령창은 특정 키를 앱에 전달하지 않을 수 있습니다. 먼저 Ctrl+]를 써 보세요.

Windows Terminal을 써 보세요. 글꼴은 한글이 잘 보이는 글꼴을 고르면 됩니다.

명령창을 더 넓게 만든 뒤 r을 눌러 새로고침하세요.

설치할 때 쓴 명령을 다시 실행하면 새 버전으로 바뀝니다.

macOS / Linux:

curl -fsSL https://cokacmux.cokac.com/manage.sh | bash

Windows:

irm https://cokacmux.cokac.com/manage.ps1 | iex

설치된 실행 파일을 지우면 됩니다.

설정과 임시 파일까지 지우고 싶으면 아래 폴더를 지우세요.

원래 코딩 도구들이 저장한 대화 기록은 따로 있습니다. 위 폴더를 지워도 자동으로 지워지지 않습니다.

cokacmux는 내 컴퓨터에 저장된 대화 기록을 읽어서 보여줍니다.

대화를 다시 열 때는 내 컴퓨터에 설치된 claude, codex, opencode, pi, gjc 명령을 실행합니다.

q나 Ctrl+Q로 cokacmux를 종료해도 실행 중인 코딩 도구는 자동으로 꺼지지 않습니다. 하나만 끄려면 Ctrl+K를 쓰고, 모두 끄려면 Ctrl+Shift+K 또는 cokacmux killall을 쓰세요.

cokacmux start는 node server.js처럼 계속 떠 있어야 하는 명령을 background terminal로 관리하기 위한 기능입니다. 금방 끝나는 일회성 명령은 일반 shell에서 직접 실행하는 편이 낫습니다.

대화 삭제, 폴더 복사, 위험한 실행을 하기 전에는 중요한 파일을 따로 보관하세요.

문제가 생기거나 새 기능을 제안하고 싶으면 아래 주소를 이용하세요.

https://github.com/kstost/cokacmux

이 프로그램의 사용 조건은 MIT 라이선스입니다.

자세한 내용은 LICENSE 파일에 있습니다.

이 프로그램은 있는 그대로 제공됩니다. 잘 작동한다는 보장, 내 상황에 꼭 맞는다는 보장, 문제가 절대 생기지 않는다는 보장은 없습니다.

이 프로그램을 쓰는 동안 생기는 모든 결과는 사용자가 직접 확인하고 책임져야 합니다. 여기에는 대화 기록 삭제, 파일 삭제, 폴더 복사 실패, 잘못된 폴더에서의 실행, 코딩 도구가 만든 변경, 코딩 도구 사용 비용, 중요한 자료 손실등이 포함됩니다.

중요한 파일이나 대화 기록은 사용 전에 반드시 따로 보관하세요. 이 프로그램의 만든 사람과 기여자는 사용 중 생긴 손해, 비용, 자료 손실, 보안 문제를 비롯한 모든 문제에 대해 책임지지 않습니다.