agf: AI 코딩 에이전트 세션을 한눈에 관리하는 터미널 TUI

AI 코딩 에이전트인 Claude Code나 Codex를 사용하다 보면 세션이 계속 쌓입니다. 그러다 보면 “이 프로젝트를 어떤 세션에서 작업했지?”, “세션 ID가 뭐였더라?” 같은 고민이 반복됩니다. 이 글에서는 이러한 불편을 해결하기 위해 만들어진 TUI 기반 도구 agf의 개념과 특징, 그리고 실제 활용 방법을 정리합니다.

반응형

---

agf란 무엇인가

agf는 AI 코딩 에이전트 세션을 한 곳에서 관리할 수 있도록 돕는 터미널 기반 TUI(Text User Interface) 도구입니다. Rust로 작성되어 빠르게 동작하며, 설치 후 터미널에서 agf 한 줄만 입력하면 모든 세션을 한눈에 확인할 수 있습니다.

특히 여러 에이전트를 동시에 사용하는 개발 환경에서 세션을 통합 관리할 수 있다는 점이 핵심입니다.

---

왜 필요한가: 세션 관리의 반복적인 불편

Claude Code, Codex 등 다양한 AI 코딩 에이전트를 프로젝트마다 활용하다 보면 다음과 같은 상황이 자주 발생합니다.

• 어떤 프로젝트를 어떤 세션에서 작업했는지 기억이 나지 않음
• 세션 ID를 다시 찾기 위해 히스토리를 뒤져야 함
• 오래된 세션이 쌓여 목록이 복잡해짐
• 여러 에이전트를 오가며 관리해야 하는 번거로움

agf는 이러한 반복 작업을 줄이고, 세션 탐색과 재개를 단순화하는 데 초점을 맞춘 도구입니다.

---

주요 기능 정리

1. 여러 에이전트 세션 통합 표시

Claude Code, Codex 등 여러 AI 코딩 에이전트의 세션을 하나의 화면에서 통합적으로 확인할 수 있습니다. 에이전트별로 따로 관리하지 않아도 되기 때문에 작업 흐름이 단순해집니다.

2. 퍼지 검색 기반 즉시 탐색

프로젝트명이나 세션 요약을 기반으로 퍼지 검색이 가능합니다.
정확한 이름을 기억하지 못해도 일부 키워드만 입력하면 빠르게 원하는 세션을 찾을 수 있습니다.

3. 한 번의 Enter로 세션 재개

목록에서 세션을 선택한 뒤 Enter를 누르면 즉시 해당 세션을 재개할 수 있습니다.
또한 cd 기능을 통해 프로젝트 디렉토리로 바로 이동할 수 있어 작업 전환이 자연스럽습니다.

4. 필터링 및 정렬 기능

• Tab: 에이전트별 필터링
• Ctrl+S: 시간, 이름, 에이전트 기준 정렬

여러 프로젝트와 세션이 쌓여 있어도 정렬과 필터를 통해 원하는 방식으로 빠르게 정리할 수 있습니다.

5. 벌크 삭제 모드 지원

Ctrl+D를 누르면 벌크 삭제 모드에 진입합니다.
체크박스를 통해 여러 세션을 선택한 뒤 일괄 삭제할 수 있습니다.

세션이 과도하게 쌓였을 때 정리 작업을 효율적으로 수행할 수 있습니다.

6. 새 세션 시작 시 권한 모드 선택

새 세션을 시작할 때 permission/approval 모드를 선택할 수 있어, 작업 환경에 맞는 세션 설정이 가능합니다.

---

설치 방법

agf는 macOS와 Linux를 지원하며, MIT 라이선스로 공개되어 있습니다.

설치는 Homebrew를 통해 간단하게 진행할 수 있습니다.

brew install subinium/tap/agf

설치 후 터미널에서 다음과 같이 실행합니다.

agf

이 한 줄로 현재까지의 AI 코딩 에이전트 세션을 통합 확인할 수 있습니다.

---

사용 예시 흐름

1. 터미널에서 agf 실행
2. 퍼지 검색으로 프로젝트 이름 일부 입력
3. 원하는 세션 선택 후 Enter
4. 즉시 세션 재개 및 프로젝트 디렉토리로 이동

세션 정리가 필요할 경우:

1. Ctrl+D로 벌크 삭제 모드 진입
2. 체크박스로 여러 세션 선택
3. 일괄 삭제 실행

복잡한 명령어나 긴 세션 ID를 기억할 필요 없이, TUI 환경 안에서 대부분의 관리 작업을 처리할 수 있습니다.

---

728x90

agf는 AI 코딩 에이전트를 적극적으로 사용하는 개발자에게 실질적인 생산성 향상을 제공하는 도구입니다.

여러 에이전트 세션을 통합적으로 관리하고, 퍼지 검색과 정렬 기능을 통해 빠르게 접근할 수 있으며, 벌크 삭제와 권한 모드 선택 같은 세부 기능까지 지원합니다.

AI 코딩 도구가 일상화되면서 세션 관리 또한 중요한 작업이 되었습니다. agf는 이 관리 영역을 터미널 기반으로 단순화한 실용적인 해법입니다.

앞으로 AI 코딩 에이전트를 병행 사용하거나 프로젝트 수가 늘어나는 환경이라면, 세션 관리의 효율성은 곧 개발 속도와 직결될 수 있습니다. agf는 그 지점을 정확히 겨냥한 도구라고 볼 수 있습니다.

300x250

https://github.com/subinium/agf

GitHub - subinium/agf: Agent Finder — One TUI to find, resume, and manage AI coding agent sessions (Claude Code, Codex, Openco