Superset: 여러 CLI 코딩 에이전트를 동시에 다루는 차세대 개발 터미널

AI 코딩 에이전트를 하나만 써도 편리한데, 여러 개를 동시에 돌려야 한다면 어떨까요?
이 글에서는 Superset이라는 터미널 기반 개발 도구를 중심으로, 왜 이 도구가 “코딩 에이전트를 위한 터미널(The Terminal for Coding Agents)”이라 불리는지, 어떤 문제를 해결해 주는지, 그리고 실제 개발 워크플로우에서 어떤 강점을 가지는지 정리합니다.
특히 여러 CLI 코딩 에이전트를 병렬로 실행해야 하는 개발자라면, 이 글을 통해 Superset의 개념과 활용 방식을 한 번에 이해하실 수 있을 것입니다.

반응형

---

Superset이 등장한 배경: 왜 필요한가?

최근 개발 환경에서는 Claude Code, Codex CLI, Gemini CLI 등 다양한 CLI 기반 코딩 에이전트를 함께 사용하는 경우가 늘어나고 있습니다.
하지만 현실은 다음과 같은 불편함이 따릅니다.

• 터미널을 계속 오가며 컨텍스트 전환 비용이 큼
• 여러 작업이 하나의 브랜치에서 섞여 충돌 발생
• 어느 에이전트가 무엇을 하고 있는지 한눈에 보기 어려움
• 변경 사항 리뷰를 위해 IDE와 터미널을 반복 이동

Superset은 이런 문제를 해결하기 위해 “여러 코딩 에이전트를 한 곳에서, 안전하게, 빠르게” 관리하는 터미널로 설계되었습니다.

---

Superset이란 무엇인가?

Superset은 CLI 코딩 에이전트를 병렬로 실행하고 관리할 수 있는 터보차지된 터미널입니다.
핵심 개념은 단순합니다.

• 각 작업을 독립된 Git worktree로 분리
• 여러 에이전트를 동시에 실행
• 모든 에이전트의 상태를 하나의 화면에서 모니터링

즉, “기다리는 시간은 줄이고, 배포 속도는 높이자”는 목적에 맞춰 만들어진 개발자용 도구입니다.

---

핵심 기능 정리

1. 병렬 실행 (Parallel Execution)

• 하나의 머신에서 10개 이상의 코딩 에이전트를 동시에 실행
• 작업을 순차적으로 기다릴 필요 없이 병렬 처리 가능

2. Worktree 기반 작업 격리

• 각 작업은 자신만의 브랜치와 작업 디렉터리를 가짐
• 에이전트 간 코드 충돌이나 간섭을 원천 차단

3. 에이전트 모니터링

• 모든 에이전트의 상태를 한눈에 확인
• 변경 사항이 준비되면 알림을 통해 즉시 확인 가능

4. 내장 Diff 뷰어

• Superset 안에서 바로 코드 변경 사항 확인
• 간단한 수정까지 가능해 IDE 이동 최소화

5. 워크스페이스 프리셋

• 환경 설정, 의존성 설치, 초기 스크립트를 자동화
• 새 작업 시작 시 반복 작업 제거

6. 범용 호환성

• 터미널에서 실행 가능한 모든 CLI 에이전트 지원
• “터미널에서 돌아가면, Superset에서도 돌아간다”는 철학

---

지원되는 코딩 에이전트

Superset은 특정 에이전트에 종속되지 않습니다.
다음과 같은 CLI 기반 코딩 에이전트가 완전 지원됩니다.

• Claude Code
• OpenAI Codex CLI
• Cursor Agent
• Gemini CLI
• GitHub Copilot CLI
• OpenCode

결론적으로, CLI에서 실행 가능한 에이전트라면 모두 사용 가능합니다.

---

사용을 위한 기본 요구 사항

Superset을 사용하기 위해서는 아래 환경이 필요합니다.

• OS: macOS (Windows / Linux는 테스트되지 않음)
• Runtime: Bun v1.0 이상
• 버전 관리: Git 2.20 이상
• GitHub CLI: gh
• 개발 서버용: caddy

※ 소스 빌드 또는 사전 빌드된 macOS 버전으로 바로 시작할 수 있습니다.

---

워크스페이스 설정 예시로 보는 사용 방법

Superset은 워크스페이스 생성과 삭제 시 자동으로 실행할 스크립트를 설정할 수 있습니다.
.superset/config.json 예시는 다음과 같습니다.

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}

setup 스크립트 예시

#!/bin/bash
# .superset/setup.sh

# 환경 변수 복사
cp ../.env .env

# 의존성 설치
bun install

# 기타 초기 작업
echo "Workspace ready!"

이 스크립트는 워크스페이스 이름(SUPERSET_WORKSPACE_NAME)이나
루트 경로(SUPERSET_ROOT_PATH) 같은 환경 변수에도 접근할 수 있어,
프로젝트 특성에 맞는 자동화 구성이 가능합니다.

---

생산성을 높이는 키보드 중심 워크플로우

Superset은 마우스보다 키보드 중심 작업을 지향합니다.

• ⌘1~9 : 워크스페이스 빠른 전환
• ⌘T : 새 터미널 탭
• ⌘D / ⌘⇧D : 화면 분할
• ⌘B : 워크스페이스 사이드바 토글

이런 단축키 덕분에 작업 흐름이 끊기지 않습니다.

---

728x90

Superset이 주는 시사점

Superset은 단순한 터미널이 아닙니다.
**“AI 코딩 에이전트를 전제로 한 개발 환경”**을 명확히 제시하는 도구입니다.

• 여러 에이전트를 동시에 활용하는 개발 방식이 보편화되는 상황에서
• 작업 격리, 병렬 실행, 빠른 리뷰라는 핵심 문제를 정확히 짚고 해결

앞으로 코딩 에이전트 활용이 늘어날수록, Superset과 같은 도구의 가치는 더 커질 것입니다.
여러 에이전트를 쓰고 있지만 아직도 터미널과 브랜치 관리에 시간을 쓰고 있다면, Superset은 충분히 주목해볼 만한 선택지입니다.

300x250

https://github.com/superset-sh/superset

GitHub - superset-sh/superset: IDE for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine