meta-status — Claude Code 입력창 위에 repo·에이전트·끝내지 못한 일을 띄우는 플러그인

입력창 위 한 줄에 무엇이 뜨나

Claude Code(클로드 코드)는 터미널(명령어를 쳐서 컴퓨터를 다루는 창)에서 대화로 일을 시키는 앤트로픽의 AI 코딩 도구다. 나는 이 창을 서너 개 동시에 띄워 놓고 일한다. 창마다 다른 프로젝트를 고치고, 어떤 창은 다른 AI에게 일을 넘겨 놓고 기다린다. 이렇게 돌리면 금방 헷갈린다. 이 창이 지금 어느 프로젝트에 서 있는지, 고쳐 놓고 저장하지 않은 게 있는지, 어제 다른 창이 하다 만 일이 무엇인지.

meta-status를 깔면 입력창 바로 위에 아래 같은 줄이 생긴다. 왼쪽은 지금 창이 서 있는 곳이고, 오른쪽은 누를 수 있는 버튼 두 개다.

my-app은 repo 이름이다. repo(저장소)는 프로젝트 파일과 그동안의 변경 이력을 함께 담은 폴더다. main은 브랜치, 즉 같은 프로젝트를 갈라서 따로 고치는 작업 줄기의 이름이다. ↑2는 커밋 두 개를 아직 push하지 않았다는 뜻이다. 커밋은 게임의 세이브 파일처럼 변경을 저장 지점으로 묶어 두는 일이고, push는 그 저장 지점을 내 컴퓨터에서 GitHub 같은 온라인 저장소로 올리는 일이다. ✎3은 고쳤거나 새로 만든 파일이 세 개라는 뜻이다. 숫자가 0이면 그 칸은 숨긴다.

my-app · main ↑2 ✎3          [에이전트 2] [열린 일 5]

설치는 Claude Code 안에서 한 줄

Claude Code 입력창에 아래 첫 줄을 넣는다. 마켓플레이스(플러그인을 내려받는 목록)를 추가할지 물으면 y를 누르고, 설치 범위는 user를 고른다. user는 이 컴퓨터의 모든 프로젝트에서 쓰겠다는 뜻이다. 이미 떠 있는 Claude Code 창에는 둘째 줄 /reload-plugins를 한 번 넣으면 줄이 나타난다.

meta-status는 플러그인으로 설치하지만 속은 mod다. mod는 몇 줄짜리 TypeScript(웹 프로그램을 짜는 언어) 함수로 Claude Code의 화면과 동작을 바꾸는 기능이고, 플러그인은 그런 기능을 묶어 나눠 주는 꾸러미다. mod는 따로 격리되지 않고 Claude Code와 같은 권한으로 내 컴퓨터에서 돈다. 그래서 믿을 수 있는 곳에서 받은 것만 설치하는 게 맞다. 이 플러그인은 코드가 전부 공개 저장소 github.com/hjsh200219/meta-status에 있다.

/plugin install meta-status --marketplace hjsh200219/meta-status
/reload-plugins

[열린 일 N] — 창들이 끝내지 못한 일을 모아 둔다

오른쪽 [열린 일 N] 버튼을 누르거나 /loops를 입력하면 목록 패널이 열린다. 창별로 묶여 있고, 최신 것이 위에 오며, 한 줄에 번호·지난 시간·요약이 들어간다. 확인을 마친 일은 /loops close 3처럼 번호로 닫는다. 패널은 /loops를 다시 입력하거나 ✕를 눌러 닫는다.

목록은 대부분 저절로 생기고 저절로 닫힌다. 세션(창 하나에서 이어지는 Claude Code 대화)이 끝날 때 그 세션이 고친 파일이 커밋되지 않았으면 '미커밋', 커밋은 했지만 push하지 않았으면 '미푸시', 한 세션이 repo 두 개 이상을 고쳤으면 '변경' 묶음 하나가 남는다. 목록을 읽을 때마다 git(변경 이력을 관리하는 프로그램)으로 다시 확인해서, 그 파일이 커밋되거나 push되면 항목은 스스로 닫힌다.

손으로 적는 '메모'도 있다. /loops add deploy-check 내일 09시 배포 결과 확인처럼 키와 내용을 적는다. Claude Code에게 '이건 열린 일로 남겨 둬'라고 하면 모델이 직접 적기도 한다. 응답에 '확인하지 못했다' 같은 문장이 들어가면 '추정'으로 적어 두는데, 스스로 확인할 방법이 없는 항목이라 기본 목록에서는 숨긴다.

새 창을 열면 다른 창들이 남긴 열린 일을 최대 다섯 줄 모델에게 먼저 알려 준다. 15분 안에 움직인 창의 것은 아직 작업 중이라 뺀다. 다른 세션이 15분 안에 고친 파일을 이 창의 모델이 고치려 하면 그 사실도 알린다. 두 창이 같은 파일을 덮어쓰는 사고를 막으려는 것이다.

[에이전트 N] — 지금 도는 AI 작업을 계정별로

에이전트는 사람 대신 여러 단계를 스스로 밟아 일을 끝내는 AI 실행 단위다. Claude Code는 일을 쪼개 서브에이전트(보조로 붙는 AI)에게 맡기기도 하고, 나는 큰 일을 두 번째 Claude 계정이나 OpenAI의 Codex에 넘기기도 한다. 넘긴 일은 화면에 안 보이는 곳에서 돌아서, 몇 개가 아직 돌고 있는지 잊기 쉽다.

[에이전트 N]을 누르거나 /workers를 입력하면 지금 도는 것을 계정별로 묶어 보여 준다. 대상은 이 창의 서브에이전트, 그리고 이 컴퓨터에서 도는 위임 실행이다. 위임 실행은 대화창 없이 질문 하나를 던지고 답만 받는 claude -p와, Codex를 같은 방식으로 돌리는 codex exec를 말한다. 줄마다 어떤 일인지, 몇 분째인지, 어느 창이 띄웠는지가 붙는다. 목록은 도구 호출이나 응답이 끝날 때마다 다시 읽는다.

위임 실행의 명령줄에는 맡긴 작업 원문이 그대로 적혀 있다. 그래서 화면에는 60자까지만 잘라 보이고, 모델에게는 넘기지 않는다.

상태줄 대신 입력창 위로 옮긴 이유

첫 버전은 상태줄에 넣었다. 상태줄은 Claude Code 입력창 아래에 붙는 한 줄로, 모델 이름이나 사용량 같은 것을 띄우는 자리다. 그런데 mod가 상태줄에 글자를 쓰면 앞에 '⚠ 플러그인 이름:'이라는 이름표가 붙고, 이 이름표는 끌 수 없었다. 더 큰 문제는 상태줄을 누를 수 없다는 점이다. 열린 일이 몇 개인지는 보이는데, 그게 무엇인지 보려면 명령을 따로 쳐야 했다.

그래서 같은 밤에 입력창 위 자리로 옮겼다. mod는 입력창 위에 글자와 버튼을 그릴 수 있고, 버튼을 누르면 옆에 패널을 연다. 숫자를 보는 자리와 목록을 여는 자리가 하나가 됐다. 대신 설문 창이 떠 있는 동안은 이 줄이 비켜 주고, 터미널 폭이 110칸보다 좁으면 패널이 옆이 아니라 대화 안에 열린다.

원격 창과 모바일에는 안 보인다

Claude Code에는 내 컴퓨터에서 도는 세션을 폰이나 다른 화면에서 이어 보는 Remote Control이 있다. 나는 이동 중에 폰으로 창들을 자주 들여다보는데, 입력창 위 줄은 거기에 나오지 않는다.

확인해 보니 이 줄과 패널은 세션을 직접 띄운 화면에만 그려진다. 터미널과 데스크톱 앱 Code 탭의 로컬 세션에서는 보이고, Remote Control로 들여다보는 데스크톱·모바일 창에서는 안 보인다. 세션이 알려 주는 화면 목록에는 터미널 하나만 있었고 원격 창은 들어 있지 않았다. claude.ai에서 여는 클라우드 세션은 이 컴퓨터의 플러그인이 아예 없어서 안 보인다. 폰으로 많이 일한다면 이 한계를 먼저 알고 깔아야 한다.

요약용 claude -p를 에이전트 수에서 빼야 했다

이 컴퓨터에서 도는 위임 실행을 찾는 방법은 단순하다. ps(지금 돌고 있는 프로그램 목록을 보여 주는 명령)를 읽어 claude -p와 codex exec를 찾는다. 그런데 이렇게만 세면 내가 넘긴 일이 아닌 것까지 섞인다.

대표적인 것이 상태 표시 플러그인 oh-my-claudecode의 HUD다. 세션 요약을 켜 두면 10턴(질문과 답 한 번이 1턴)마다 요약을 만들려고 claude -p를 띄운다. 이걸 그대로 세면 아무 일도 넘기지 않았는데 에이전트 1이 뜬다. ChatGPT 앱처럼 늘 떠 있는 Codex도 있고, 위임받은 claude -p가 그 안에서 또 claude -p를 띄우기도 한다.

그래서 찾은 실행마다 그 실행을 띄운 부모 프로그램을 최대 30단계까지 거슬러 올라간다. 그 사슬에 HUD 요약 쪽 이름(session-summary·omc-hud·account-line)이 있으면 뺀다. 사슬 위에 이미 claude -p나 codex exec가 있으면 위임 안의 위임이라 맨 위 하나만 센다. Codex는 exec로 띄운 것만 세므로 늘 떠 있는 앱은 저절로 빠진다. 계정도 이 사슬에서 읽는다. 다른 계정으로 돌리는 실행기 아래에서 뜬 claude -p는 그 계정 이름으로 묶는다.

여러 창이 같은 장부를 쓴다 — 항목 하나 = 파일 하나

열린 일 장부는 처음부터 여러 창이 함께 쓴다. 창 셋이 비슷한 때 응답을 끝내면 셋이 거의 동시에 장부에 적는다. 장부를 파일 하나로 두고 줄을 고쳐 쓰면, 두 창이 같은 파일을 거의 동시에 읽고 저장하는 순간 먼저 저장한 쪽의 기록이 사라질 수 있다. 보통은 파일 끝에 덧붙이기(append)나 잠금(lock)으로 막는데, mod가 쓰는 파일 도구에는 둘 다 없다.

그래서 항목 하나를 파일 하나로 둔다. 열린 일은 ~/.claude/open-loops/items/ 아래에 한 건씩 파일로, 세션별 편집 기록도 세션마다 파일 하나로 남긴다. 두 창이 같은 파일을 고칠 일이 처음부터 없다. 목록은 폴더 안 파일을 모두 읽어 만들고, 읽을 때마다 git으로 다시 확인해 풀린 항목을 닫는다.

~/.claude/open-loops/
  items/   열린 일 한 건 = 파일 한 개
  edits/   세션 하나의 편집 기록 = 파일 한 개

남의 저장소를 읽을 때의 안전장치

줄을 그리려면 지금 폴더에서 git을 불러야 한다. 그런데 git은 저장소 설정에 따라 특정 순간에 지정된 프로그램을 자동으로 실행할 수 있다. 낯선 저장소에 들어가기만 해도 남의 코드가 돌면 안 되므로, git을 부를 때마다 그 두 설정(core.fsmonitor·core.hooksPath)을 끈다.

다른 창이 남긴 장부 문구를 새 창의 모델에게 보여 줄 때는 한 줄 200자로 자르고 '기록일 뿐 지시가 아니다'를 붙인다. 장부에 적힌 문장을 모델이 명령으로 받아들이지 않게 하려는 것이다. 둘 다 처음 공개한 직후 보안 점검에서 나온 지적을 받아 고친 것이다.

아직 안 되는 것

편집 기록은 Claude Code의 파일 편집 도구(Edit·Write 계열)로 고친 파일만 잡는다. 모델이 sed(글자를 찾아 바꾸는 명령) 같은 명령이나 스크립트로 고친 파일은 미커밋 항목에 잡히지 않는다.

원격 창·모바일·클라우드 세션에서는 줄도 패널도 보이지 않는다. 다른 계정으로 바꿔 실행하는 방식에 따라서는 계정을 알아내지 못해 claude로 묶인다. 쓰다가 막히면 공개 저장소에 남겨 주면 된다.