터미널 자동완성이 아직도 형편없는 이유 (그리고 내가 대신 만든 것)

I’m happy to translate the article for you, but I’ll need the actual text you’d like translated. Could you please paste the content of the article (excluding the source link you already provided) here? Once I have the text, I’ll translate it into Korean while preserving the original formatting, markdown syntax, and technical terms.

터미널 자동완성의 문제

대부분의 쉘은 한 가지를 잘 수행합니다:

이미 입력을 시작한 내용을 완성합니다

그게 전부입니다.

다음과 같이 입력하면:

dokcer logs

아무것도 반환되지 않습니다.

다음과 같이 입력하면:

docker rec

당신이 의도한 것이 docker이고 이전에 docker logs를 여러 번 실행했음에도 아무것도 반환되지 않습니다. 쉘은 학습하거나, 적응하거나, 의도를 이해하지 못합니다—오직 접두사만 매칭합니다.

내가 원했던 것

• 실제 명령 기록에서 학습한다
• 오타를 자동으로 수정한다
• 접두사만이 아니라 의도를 이해한다
• 입력 중 지연 없이 즉시 반응한다

더 나은 자동완성 (Agensic Autocomplete)

명령을 정적 문자열로 다루는 대신 패턴으로 다룹니다. 이를 통해 다음과 같은 것이 가능해집니다:

• dokcer → docker
• docker records → docker logs

여전히 local‑first이며 빠릅니다.

AI는 기록이 충분하지 않을 때만 백업으로 사용됩니다. 대부분의 경우 제안은 다음에서 나옵니다:

• 사용량에 따라 순위가 매겨진, 저장소를 인식하는 자신의 과거 명령
• 의미 기반 매칭
• 오타 교정

쉘보다 IDE에 더 가깝게 느껴집니다.

하지만 자동완성이 진짜 문제는 아니었다

터미널에서 AI 에이전트(Codex CLI, Claude Code 등)를 사용하기 시작했을 때, 자동완성이 명령을 작성하는 데는 도움이 되지만 하지만 실제로 무슨 일이 일어났는지 이해하는 데는 도움이 되지 않는다는 것을 깨달았습니다.

누락된 레이어: 명령 프로비넌스 (Agensic Provenance)

에이전트가 여러분을 위해 명령을 실행할 때, 셸 히스토리는 이를 추적하지 않습니다—마치 블랙 박스 안에서 동작하는 것과 같습니다. 저는 모든 명령을 분류하고 추적하는 프로비넌스 레이어를 추가했습니다:

• HUMAN_TYPED
• AI_SUGGESTED_HUMAN_RAN
• AI_EXECUTED
• …등.

에이전트가 실행한 명령에는 암호학적 증명이 제공되어, 어떤 명령이 왜 실행되었는지 명확하고 감사 가능한 타임라인을 제공합니다.

그때 세션이 등장했습니다 (Agensic Sessions)

실행된 내용은 알 수 있어도 전체 세션을 쉽게 재구성할 수는 없습니다. 세션 추적을 추가하여 다음을 할 수 있게 했습니다:

• 전체 터미널 세션을 재생
• 명령어 타임라인을 검사
• 디버깅이나 사고 검토를 위해 실행을 내보내기

리포지토리를 위한 시간 여행

특정 시점에 리포지토리가 정확히 어떤 상태였는지 바로 되돌아갈 수 있습니다—“대략 기억나는 대로” 혹은 “git reflog 고고학”이 필요 없습니다. 세션 체크포인트와 연결된 정확한 상태입니다.

함께 묶어 보기

What started as “better autocomplete” turned into a broader toolset:

• autocomplete → 더 빠르게 작성할 수 있도록 도와줍니다
• provenance → 무슨 일이 일어났는지 이해하는 데 도움을 줍니다
• sessions → 재구성하고 디버그하는 데 도움을 줍니다

Because once AI agents enter the terminal:

• 속도가 더 이상 병목 현상이 아닙니다
• 이해가 병목 현상입니다.

최종 생각

터미널 도구는 오늘날 우리의 작업 방식에 맞추어 발전하지 못했습니다. 우리는 더 이상 단순히 명령을 입력하거나 스크립트를 실행하는 것이 아니라:

• 에이전트와 협업하고
• 실행을 위임하며
• 우리가 따라잡을 수 없을 정도로 빠르게 움직이고 있습니다

가시성이 없으면 상황이 빠르게 무너집니다.

궁금하시면

프로젝트를 여기서 오픈소스했습니다:

👉

특히 터미널에서 AI 에이전트를 사용하는 분들의 피드백을 받고 싶습니다.