ONEDEV

superset

AI Agent OrchestrationIDETypeScript

★ 14,118주당 +260조회 5

무엇인가

Superset은 CLI 기반 코딩 에이전트를 동시에 여러 개 굴리기 위한 데스크톱 애플리케이션이다. TypeScript로 작성됐으며 에이전트 자체를 구현하지 않는다. 터미널에서 이미 돌아가는 에이전트 프로세스를 작업 단위로 격리하고 감시하는 오케스트레이션 계층으로, 코드 편집기보다 실행 관리자에 가깝다.

어떻게 동작하나

작업마다 git worktree를 새로 만들고 전용 브랜치·터미널·환경을 붙인다. 에이전트는 자기 worktree 안에서 실행되므로 같은 저장소를 공유하는 다른 작업과 파일이 충돌하지 않는다. 사이드바가 모든 에이전트의 작업 중 표시, 완료 알림음, 주의가 필요할 때의 dock 배지를 한곳에 모은다. 내장 터미널은 탭·무한 분할·프리셋·재시작 후에도 유지되는 세션을 다루고, ⌘I 프롬프트 편집기에서 여러 줄 편집과 @파일 멘션을 쓴다. diff 뷰어에서 변경을 검토·주석·편집한 뒤 커밋과 푸시를 처리한다. 워크스페이스별로 포트를 감지해 dev 서버를 앱 내 브라우저 패널로 미리 보여준다. Automations는 정해진 스케줄에 에이전트 세션을 돌린다. 데스크톱 앱에 번들된 CLI, SDK, MCP가 같은 워크스페이스에 접속한다.

무엇과 다른가

단일 저장소에서 에이전트를 순차 실행하거나 에디터에 내장된 단일 세션 어시스턴트를 쓰는 방식과 구조가 다르다. Superset은 에이전트를 특정 제품에 묶지 않고, 터미널에서 실행되는 CLI 에이전트면 무엇이든 등록해 내장 에이전트와 동일하게 취급한다. 모델과 reasoning effort를 실행 시점에 고르고, 에이전트별 실행 명령·프롬프트 템플릿·모델 오버라이드를 설정에서 조정한다. 여러 worktree의 결과를 나란히 비교해 하나를 머지하는 흐름을 전제로 설계됐다.

어떻게 쓰나

macOS Apple Silicon·Intel용 .dmg를 내려받아 설치한다. Linux는 x64 AppImage로 실험적 지원이고 Windows 빌드는 없다. Git만 있으면 동작하며 gh는 선택 사항으로 PR 워크플로를 열어주고 앱이 설치를 제안한다. CLI는 데스크톱 앱에 포함되거나 단독으로 설치한다. 개발은 저장소를 클론해 설치된 Superset 앱에 추가하고 변경용 워크스페이스를 만든 뒤 그 터미널에서 setup.local.sh를 실행한다. 이 스크립트가 워크스페이스별 앱 아이덴티티와 포트를 잡아 개발 앱이 설치본 및 다른 개발 worktree와 나란히 뜨게 하고, Docker로 로컬 Postgres + Electric 스택을 올리고 dev 계정을 시드한다. "Sign in as dev" 버튼이나 [email protected] / supersetdev로 로그인한다.

전제와 한계

macOS가 주 타깃이고 Linux는 실험적, Windows는 미지원이며 iOS 앱은 예정 단계다. 개발 빌드에는 Bun v1.3.14+ (.bun-version에 고정), docker, jq, caddy가 필요하고 새 worktree마다 setup.local.sh를 한 번 실행해야 한다. 에이전트는 터미널에서 실행 가능한 CLI여야 하며, 모델 연결은 OpenRouter·Bedrock·Vertex·Vercel AI Gateway를 경유한다. Slack 메시지나 Linear 이슈에서 워크스페이스를 만들 수 있다.

관련 논문 3

유사 도구