Superset은 CLI(Command Line Interface) 기반의 코딩 에이전트(coding agents) 실행을 돕고 개발 워크플로우를 향상시키는 데 특화된 터보차지드 터미널(turbocharged terminal) 애플리케이션입니다. 이 도구는 에이전트 기반 개발에서 발생하는 여러 비효율성을 해결하는 데 중점을 둡니다.

해결하는 주요 문제:
Superset은 다음과 같은 문제들을 해결합니다:

1. 컨텍스트 전환 오버헤드(Context Switching Overhead): 여러 에이전트 또는 작업을 동시에 실행할 때 발생하는 번거로움.
2. 에이전트 간 간섭(Interference between Agents): 서로 다른 작업이나 에이전트가 동일한 코드베이스에 접근하여 발생하는 충돌 및 환경 오염.
3. 모니터링의 어려움(Monitoring Difficulties): 다수의 에이전트 진행 상황을 한눈에 파악하기 어렵고, 완료 시점을 놓치기 쉬움.
4. 변경 사항 검토 지연(Slow Review Process): 에이전트가 생성한 변경 사항을 빠르고 효율적으로 검토하기 어려움.

핵심 기능 및 방법론:

Superset의 핵심은 이러한 문제들을 해결하기 위한 독특한 방법론에 있습니다:

5. 워크트리 격리(Worktree Isolation):
   • 각 태스크(작업)는 독립적인 Git worktree에서 실행됩니다. Git worktree는 단일 Git 리포지토리에서 여러 개의 독립적인 작업 디렉토리(working directory)를 생성할 수 있는 기능입니다.
   • 이는 각 작업에 고유한 Git 브랜치와 작업 디렉토리를 할당하여 에이전트들이 서로의 환경에 영향을 주지 않도록 완벽하게 격리시킵니다. 따라서 한 에이전트의 변경 사항이 다른 에이전트의 작업에 방해가 되거나, 종속성 충돌이 발생하는 것을 방지합니다.
   • 이 격리된 환경 내에서 .superset/config.json 파일을 통해 setup 및 teardown 스크립트를 정의할 수 있습니다. setup 스크립트는 워크스페이스 생성 시 실행되어 환경 변수 설정, 종속성 설치 등 초기 설정을 자동화하며, teardown 스크립트는 워크스페이스 삭제 시 정리 작업을 수행합니다. 이를 통해 각 워크스페이스의 환경 준비 및 관리가 자동화되고 일관성을 유지할 수 있습니다. 스크립트 내에서는 SUPERSET_WORKSPACE_NAME 및 SUPERSET_ROOT_PATH와 같은 환경 변수를 활용할 수 있습니다.

6. 병렬 실행(Parallel Execution):
   • 워크트리 격리 덕분에 10개 이상의 코딩 에이전트를 사용자의 머신에서 동시에 병렬로 실행할 수 있습니다. 이는 컨텍스트 전환 없이 여러 프로젝트나 작업을 동시에 진행할 수 있게 하여 개발 생산성을 극대화합니다.

7. 에이전트 모니터링(Agent Monitoring):
   • 모든 에이전트의 상태를 한곳에서 추적하고, 변경 사항이 준비되거나 특정 조치가 필요할 때 알림을 제공합니다. 이는 개발자가 에이전트의 진행 상황을 효과적으로 관리하고 개입할 시점을 알 수 있게 합니다.

8. 내장 Diff 뷰어 및 에디터(Built-in Diff Viewer and Editor):
   • 애플리케이션을 벗어나지 않고 에이전트가 생성한 변경 사항을 빠르게 검토하고 편집할 수 있는 기능을 제공하여, 변경 사항 검토 프로세스를 가속화합니다.

9. 워크스페이스 프리셋(Workspace Presets):
   • 환경 설정 및 종속성 설치와 같은 반복적인 작업을 자동화하는 프리셋을 제공하여, 새로운 작업 환경을 빠르게 구성할 수 있도록 돕습니다.

10. 범용 호환성(Universal Compatibility):
    • 터미널에서 실행되는 모든 CLI 기반 코딩 에이전트와 호환됩니다. Claude Code, OpenAI Codex CLI, Cursor Agent, Gemini CLI, GitHub Copilot, OpenCode 등 다양한 에이전트를 지원하며, 사실상 모든 CLI 에이전트가 Superset에서 작동합니다.

11. 빠른 컨텍스트 전환 및 IDE 통합(Quick Context Switching & IDE Integration):
    • 직관적인 키보드 단축키를 통해 워크스페이스(작업) 간을 빠르게 전환할 수 있습니다. 또한, 어떤 워크스페이스든 선호하는 IDE에서 원클릭으로 열 수 있는 기능을 제공합니다.

기술 스택 및 요구사항:

• 운영체제(OS): macOS (Windows/Linux는 테스트되지 않음)
• 런타임(Runtime): Bun v1.0+
• 버전 관리(Version Control): Git 2.20+
• 기타 도구: GitHub CLI (gh), Caddy (개발 서버용 리버스 프록시)

Superset은 개발자가 코딩 에이전트를 활용하여 보다 효율적이고 병렬적으로 작업하며, 복잡한 환경 설정과 컨텍스트 전환의 부담을 줄일 수 있도록 설계된 도구입니다.