GitHub 오픈소스 탐험

개발자라면 코드 작성의 효율성을 높이고 싶어 하실 텐데요. 오늘 소개할 프로젝트는 멀티플렉서를 통해 AI 코딩 에이전트를 보다 효과적으로 관리할 수 있게 도와주는 도구, Séance입니다. Séance는 단순한 터미널 멀티플렉서를 넘어 AI 코딩 에이전트의 작업 상태를 실시간으로 추적하는 기능을 제공합니다. 이로 인해 개발자는 복잡한 작업 흐름을 보다 쉽게 관리할 수 있습니다. 그럼, Séance의 주요 기능과 설치 방법, 기본 사용법에 대해 자세히 알아보겠습니다.

Séance의 주요 기능

AI 에이전트 자동 추적: Séance는 Claude Code, Codex, Pi와 같은 AI 코딩 에이전트 세션을 자동으로 감지하고, 이들의 상태(작업 중, 권한 요청 대기, 대기 중)를 사이드바에서 실시간으로 확인할 수 있습니다.
제로 설정: 별도의 설정 파일이나 환경 설정이 필요 없으며, 에이전트를 하나의 패널에서 열기만 하면 자동으로 추적됩니다.
스크롤 레이아웃: 패널이 수평으로 배열되어 있어 긴 에이전트 세션을 보다 쉽게 탐색할 수 있으며, 스크롤 가능한 타일링 레이아웃을 제공합니다.
스크립트 가능: 모든 작업은 seance ctl을 통해 가능합니다. 이 명령은 실행 중인 인스턴스와 유닉스 도메인 소켓을 통해 통신하여, 다양한 작업을 자동화할 수 있습니다.
다양한 플랫폼 지원: GTK4 및 libadwaita 기반으로 GNOME과의 통합이 원활하며, X11 및 Wayland에서도 사용할 수 있습니다.

설치 방법

Arch Linux (AUR)

Arch Linux를 사용하신다면 AUR에서 쉽게 설치할 수 있습니다. 아래 명령어를 사용해 보세요:

yay -S seance

Nix (flake)

Nix를 사용하시는 경우, 아래와 같은 명령으로 직접 실행하거나 설치할 수 있습니다.

직접 실행하기:

nix run "git+https://github.com/no1msd/seance?submodules=1"

영구적으로 설치하기:

nix profile install "git+https://github.com/no1msd/seance?submodules=1"

주의: NixOS가 아닌 경우, EGL 초기화에 GL 래퍼가 필요합니다. Intel/AMD의 경우 nixGL을 활용하여 간단히 실행할 수 있습니다:

nix run --impure github:nix-community/nixGL#nixGLIntel -- \
  nix run "git+https://github.com/no1msd/seance?submodules=1"

기본 사용법

Séance를 설치한 후, 터미널에서 seance 명령어를 입력하면 애플리케이션이 실행됩니다. UI는 직관적이며, 각종 AI 에이전트를 패널에 추가하면, 상태가 자동으로 업데이트됩니다. 다음은 기본 사용법입니다:

에이전트 추가: 패널에서 AI 에이전트를 열면, 자동으로 해당 세션이 추적됩니다.
작업 상태 확인: 사이드바에서 현재 작업 상태를 확인할 수 있습니다.
스크립트 사용: seance ctl 명령을 통해 여러 작업을 자동화할 수 있습니다. 예를 들어, 특정 세션의 출력을 읽어오고 싶다면 아래와 같이 사용할 수 있습니다:

seance ctl get-output <세션-ID>

실무에서의 활용 시나리오

예를 들어, 개발자가 Codex API를 사용하여 복잡한 코드를 작성할 때, Séance를 통해 Codex의 작업 상태를 실시간으로 파악하고, 권한 요청 시 즉시 대응할 수 있습니다. 이를 통해 팀원 간의 협업이 더욱 원활해지고, 불필요한 대기 시간을 줄일 수 있습니다.

비슷한 도구와의 비교

현재 다양한 터미널 멀티플렉서가 존재하지만, Séance는 AI 에이전트와 직접 통합되어 실시간으로 상태를 추적할 수 있는 점에서 차별화됩니다. 예를 들어, tmux와 같은 기존 멀티플렉서는 강력한 기능을 제공하지만, AI 에이전트의 상태 추적 기능은 내장되어 있지 않습니다. 따라서 AI 중심의 개발 환경에서는 Séance가 더욱 유용할 것입니다.

AI 코딩 에이전트를 추적하는 멀티플렉서는 왜 필요할까?