agent-history로 AI 코딩 세션 기록을 확인하고 프로젝트로 빠르게 이동한다

agent-history는 Zsh와 Bash에서 AI 코딩 도구의 최근 세션을 찾아 대시보드로 보여주는 셸 플러그인이다. 목록에서 번호를 지정하면 해당 프로젝트 디렉터리로 이동할 수 있다.

Claude Code, GitHub Copilot, Aider, Gemini / Antigravity, Pi, Droid, Factory, Codex, OpenClaw, Hermes, OpenCode 등의 실행 로그와 세션 데이터베이스를 검색한다. 프로젝트가 삭제되거나 이름이 바뀐 경우와 홈 디렉터리 자체는 목록에서 제외한다. 데모 화면도 공개돼 있다.

설치와 사용

설치 스크립트로 설치하거나 업데이트할 수 있다.

curl -sSL https://raw.githubusercontent.com/aaronbronow/agent-history/main/install.sh | bash

Oh My Zsh 사용자는 저장소를 사용자 플러그인 디렉터리에 복제하고 ~/.zshrc의 plugins=(...) 목록에 agent-history를 추가한다. Antidote와 Zinit에서는 플러그인 목록에 aaronbronow/agent-history를 추가한다. Bash 등에서 수동 설치하려면 저장소를 복제한 뒤 셸 설정 파일에서 플러그인 스크립트를 불러온다.

git clone https://github.com/aaronbronow/agent-history.git ~/.agent-history

최근 프로젝트를 보려면 agent-history 또는 단축 명령 ah를 입력한다. 목록의 두 번째 프로젝트로 이동하려면 ah 2를 실행한다. ah -a 또는 ah --all은 성능 제한 내에서 최대 25개 세션을 표시하고, ah -n <num>은 지정한 개수(1~25)를 표시한다. ah -h 또는 ah --help는 도움말을, ah -v 또는 ah --version은 버전을 출력한다.

AGENT_HISTORY_PATH 환경 변수에는 검색할 에이전트 설정 디렉터리 경로를 콜론으로 구분해 지정할 수 있다. 설정하지 않으면 기본적으로 해당 디렉터리를 모두 검색한다. AGENT_HISTORY_LIMIT으로 표시할 프로젝트 수를 정할 수 있으며 기본값은 5, 최댓값은 25다.

터미널을 열 때마다 목록을 표시하려면 셸 설정 파일에 ah를 추가한다. SSH 로그인 때만 실행하도록 구성할 수도 있다. Powerlevel10k의 Instant Prompt를 사용한다면 초기화 경고를 막기 위해 SSH 실행 코드를 Instant Prompt 설정 블록보다 위에 두라고 안내한다.

제작자는 핵심 엔진이 Zsh와 일반 Bash용으로 작성됐다고 설명한다. Fish, PowerShell, NuShell 등 다른 셸용 구현은 제공하지 않으며, 해당 셸로 이식하려는 사용자는 저장소를 포크해 구현할 수 있다. 관련 저장소로 awesome-zsh-plugins와 최신 릴리스를 안내한다.