<p align="center">
<img src="https://raw.githubusercontent.com/deivid11/tide-commander/master/docs/tide-commander-logo.png" alt="Tide Commander" width="360" />
</p>
<h1 align="center">Tide Commander</h1>
<p align="center">
<strong>새로운 세대의 크리에이터를 위한 비주얼 AI 빌드 스위트입니다.</strong>
</p>
<p align="center">
아이디어를 소프트웨어, 자동화(automations), 워크플로우(workflows), 문서, 데이터 도구, 그리고 3D 프로젝트로 변환하세요—IDE 내부에 머무르지 않고도 가능합니다.
</p>
<p align="center">
Claude Code · Codex · OpenCode · Grok · Pi
</p>
<p align="center">
<a href="https://www.npmjs.com/package/tide-commander"><img src="https://img.shields.io/npm/v/tide-commander?style=flat-square&logo=npm" alt="npm version" /></a>
<a href="https://github.com/deivid11/tide-commander/stargazers"><img src="https://img.shields.io/github/stars/deivid11/tide-commander?style=flat-square&logo=github" alt="GitHub stars" /></a>
<a href="https://github.com/deivid11/tide-commander/blob/master/LICENSE"><img src="https://img.shields.io/github/license/deivid11/tide-commander?style=flat-square" alt="MIT license" /></a>
<img src="https://img.shields.io/badge/Node.js-18%2B-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 18+" />
</p>
<p align="center">
<a href="https://tidecommander.com/app"><img src="https://img.shields.io/badge/TRY_LIVE_DEMO-OPEN-2563EB?style=for-the-badge&logo=googlechrome&logoColor=white" alt="실시간 데모 체험하기" /></a>
<a href="https://www.youtube.com/watch?v=r1Op_xfhqOM"><img src="https://img.shields.io/badge/WATCH_DEMO-YOUTUBE-DC2626?style=for-the-badge&logo=youtube&logoColor=white" alt="데모 시청하기" /></a>
</p>
Tide Commander visual multi-agent command center
단순한 에이전트 관리자를 넘어선 존재. 단순한 IDE를 넘어선 존재. Tide Commander는 AI 에이전트 팀을 중심으로 설계된 완전한 빌드 환경입니다. 모든 캐릭터(agent)는 네이티브 도구, 자격 증명(credentials), 컨텍스트(context), 세션 기록을 사용하여 실제 프로젝트 파일에서 작업하는 실제 프로세스입니다.
기존의 제작 도구들은 IDE, 터미널 멀티플렉서(terminal multiplexer), Git 클라이언트, 파일 브라우저, 자동화 캔버스(automation canvas), 인프라 대시보드(infrastructure dashboard) 그리고 늘어나는 AI 채팅창 등 여러 영역에 걸쳐 작업을 분산했습니다. Tide Commander는 이러한 모든 표면을 하나로 통합하여 사용자가 의도(intent)에서 완성된 결과물까지 한 곳에서 이동할 수 있도록 합니다.
사용하기 위해 코딩 환경에 머무를 필요가 없습니다. 자연어와 시각적 컨트롤로 시작하고, 더 깊은 제어가 필요할 때만 정확한 파일, 명령어, diff, 데이터 또는 인프라를 열면 됩니다.
⚡ 30초 만에 실행
npx tide-commander@latest
**http://localhost:6200**을 여세요. Claude Code, Codex, OpenCode, Grok 또는 Pi가 이미 설치 및 인증되어 있다면, 첫 번째 에이전트를 생성할 준비가 된 것입니다.
Bun을 선호하십니까? bunx tide-commander@latest를 사용하세요.
크리에이터들이 Tide Commander를 사용하는 이유
기존의 IDE는 한 사람이 한 번에 하나의 파일을 편집하도록 설계되었습니다. AI 네이티브(AI-native) 제작은 다릅니다. 여러 에이전트가 연구하고, 계획하고, 구축하고, 테스트하고, 문서를 작성하며, 자동화하고, 운영하는 작업을 병렬로 수행할 수 있습니다. Tide Commander는 이러한 변화를 위한 작업 공간입니다. 팀이 실행을 처리하는 동안 사용자가 결과물을 지휘할 수 있는 시각적 빌드 스위트입니다.
<p align="center"><strong>솔로 크리에이터, 창업가(founders), 연구원, 운영자, 엔지니어, 제품팀, 그리고 AI를 활용하여 구축하는 모든 사람들을 위해.</strong></p>
<table
<tr>
<td width="33%" valign="top">
<h3>✨ 의도(intent)로부터 생성 시작</h3>
원하는 결과물부터 시작합니다. 전문 에이전트를 배포하고 컨텍스트를 제공하며, 보스 에이전트가 작업을 조정하도록 합니다.
</td>
<td width="33%" valign="top">
<h3>👀 작업 과정 실시간 확인</h3>
조용한 스피너(spinner)를 보는 대신, 툴 호출(tool calls), PTY 출력, 백그라운드 작업, 큐(queues), 컨텍스트 사용량, 블로커 등을 라이브로 추적할 수 있습니다.
</td>
<td width="33%" valign="top">
<h3>🛠️ 툴 전환 기능 대체</h3>
파일, 소스 코드, Git, 테스트, 문서, 데이터, 터미널, 서비스 및 풍부한 미리보기 기능을 단일 빌드 스위트에서 작업합니다.
</td>
</tr>
<tr>
<td width="33%" valign="top">
<h3>🔀 적절한 하네스 사용</h3>
Claude, Codex, OpenCode, Grok, Pi를 하나의 팀으로 혼합하여 사용하고, 다른 런타임(runtime)이 더 적합할 때 대화를 마이그레이션할 수 있습니다.
</td>
<td width="33%" valign="top">
<h3>⚙️ 반복 작업 자동화</h3>
워크플로우와 트리거를 구축하고, 서비스를 연결하거나, LLM을 우회하는 로컬 플러그인 및 슬래시 명령어(/slash command)를 추가합니다.
</td>
<td width="33%" valign="top">
<h3>📱 어디서든 작업 이어가기</h3>
데스크톱, 모바일, Android 또는 브라우저 확장 프로그램에서 동일한 서버 측 세션에 다시 연결할 수 있습니다.
</td>
</tr>
</table>
생성에 필요한 모든 것
| |
|---|----
| 🎯 오케스트레이션(Orchestration)<br>보스/하위 팀, 위임 보고서, 프로젝트 영역, 작업 레이블, 추적 보드, 에이전트 메모리, 프롬프트 스태킹(prompt stacking), 기술(skills), 런타임 마이그레이션. | 📡 관측 가능성(Observability)<br>구조화된 툴 카드, 스트림 PTY 명령어, 라이브 백그라운드 작업 레일, 서버 측 메시지 큐, 인터럽트, 컨텍스트 게이지, 계정 제한, 재연결 복구(reconnect recovery). |
| ... |
🤖 좋아하는 AI 하네스 가져오기
다양한 하네스를 나란히 사용합니다—심지어 같은 프로젝트 내에서도 가능합니다. Tide Commander는 각 제공업체의 네이티브 세션이나 강점을 숨기지 않으면서, 이벤트 스트림을 하나의 대화, 툴, 상태, 컨텍스트 및 파일 차이(file-diff) 경험으로 표준화합니다.
| 하네스(Harness) | 필수 명령어(Required command) | 기본 실행 환경(Default runtime) | 선택적 영구/스트리밍 모드(Optional persistent/streaming mode) |
|---|
| Claude Code | claude | 헤드리스(Headless) stream-json 프로세스 및 표준 입력(stdin) 후속 처리 지원 | tmux 내 대화형 Claude TUI; 일반 tmux 모드는 Commander 재시작 시에도 프로세스를 보존할 수 있음 |
| ... | | | |
| 영구 모드는 **설정(Settings) → 일반(General)**에서 선택적으로 활성화할 수 있습니다. Pi는 Pi가 로드하는 모든 모델 제공업체—예를 들어 Anthropic, OpenAI Codex, xAI, Gemini, Copilot, OpenCode Go 또는 로컬 제공업체—를 사용할 수 있으며, Tide는 Pi 하네스와 별도로 활성 모델 제공업체를 표시합니다. | | | |
대화를 잃지 않고 하네스 전환하기
에이전트 편집기에서는 모든 에이전트를 지원되는 모든 하네스로 변경할 수 있습니다:
- Smart Context — 대상 컨텍스트 창에 맞춘 간결한 인계(hand-off)
- Visible Transcript — 예산 책정이 된 읽을 수 있는 대화 사본
- Fresh Start — 대화 내용을 가져오지 않고 실행 환경만 변경하기
Claude, Codex, Grok, Pi는 쓰기 가능한 네이티브 세션 저장소(writable native session stores)를 가지고 있으며 가져온 컨텍스트를 지원합니다. OpenCode도 Fresh Start로 선택할 수 있습니다. 모든 제공업체는 마이그레이션의 출처가 될 수 있습니다. Tide는 새로운 세션을 검증하고, 가져오거나 폐기된 콘텐츠를 보고하며, 원본을 아카이브하고, 세션 기록을 통해 롤백(rollback) 기능을 제공합니다.
📦 설치 및 CLI
요구 사항 (Requirements)
- Node.js 18+ (CI에서는 Node.js 22 사용), 또는
bunx를 위한 Bun
- 인증된 지원 AI 에이전트 CLI 중 최소 하나:
claude, codex, opencode, grok, 또는 pi
- 선택 사항: 프로세스 지속성, Pi RPC 재시작 복구 및 Claude 대화형 TUI 모드를 위한
tmux
설치 없이 실행하기
bunx tide-commander@latest
...
http://localhost:6200을 엽니다.
전역으로 설치하기
npm install -g tide-commander@latest
tide-commander start
서버는 기본적으로 백그라운드에서 시작됩니다:
tide-commander start
tide-commander start --foreground
tide-commander stop
...
일반 서버 옵션:
```bash
tide-commander start --port 8080 --host 127.0.0.1
tide-commander start --listen-all --port 8080
tide-commander start --restart
...
전체 CLI 참고 자료는 tide-commander --help를 실행하세요.
🔒 원격 액세스 및 HTTPS
Tide Commander는 로컬 도구를 실행하고 프로젝트 파일을 노출하므로, localhost 외부에서 접근 가능한 경우에는 항상 HTTPS/WSS와 인증 토큰(auth token)을 사용해야 합니다.
tide-commander start \
--listen-all \
--https \
...
동일한 프로세스에서 HTTP와 HTTPS를 모두 제공할 수 있습니다. PORT는 일반 리스너(plain listener)를 유지하고, HTTPS_PORT는 TLS를 추가합니다. 두 리스너 모두 동일한 에이전트 및 WebSocket 클라이언트를 공유합니다.
PORT=6200 \
HTTPS_PORT=6201 \
TLS_KEY_PATH=~/.tide-commander/certs/localhost-key.pem \
...
이 기능은 localhost가 HTTP로 유지될 수 있지만, 휴대폰이나 다른 컴퓨터에서 보안 컨텍스트(secure context)가 필요한 경우에 유용합니다. HTTPS=1을 사용하면서 HTTPS_PORT를 지정하지 않으면, HTTPS가 일반 리스너를 대체합니다.
참고 사항:
--install-local-cert는 mkcert를 사용하여 인증서를 생성하고 ~/.tide-commander/certs/에 저장합니다.- 원격 클라이언트가 해당 주소를 사용하는 경우, LAN 또는 VPN 주소를 인증서 SAN(Subject Alternative Name) 목록에 추가해야 합니다.
- 생성된 인증 토큰은 비밀번호 관리자(password manager)에 보관하세요.
- HTTPS는 전송 계층을 보호하고,
AUTH_TOKEN은 접근 권한을 제어합니다. 원격 환경에서는 둘 다 사용하세요.
🎖️ 핵심 개념
에이전트(Agents), 보스(Bosses), 및 위임(Delegation)
모든 캐릭터는 자체 작업 디렉토리, 제공자(provider), 모델, 세션, 프롬프트 스택, 메모리, 권한, 기술, 컨텍스트 사용량, 작업 상태를 가진 실제 AI 하네스 프로세스입니다. 보스는 하위 에이전트를 소유하고, 전문가를 선택하며, Tide Commander API를 통해 작업을 보내고, 보고서를 기다리며, 팀의 진행 상황을 요약할 수 있습니다.
작업 레이블과 추적 상태는 채팅 외부에서도 작업 내용을 가시화합니다. 에이전트는 '생각 중(thinking)', '작업 중(working)', '막힘(blocked)', '하위 에이전트 대기 중(waiting for subordinates)', '검토 준비 완료(ready for review)', 또는 '컨텍스트에서 제거해도 안전함(safe to clear from context)' 등의 상태를 보고할 수 있습니다.
영역(Areas)
사각형 또는 원형 영역은 프로젝트나 책임에 따라 에이전트를 구성합니다. 이 영역들은 여러 프로젝트 폴더를 소유할 수 있고, 그 안에 있는 에이전트들에게 특정 영역 전용 지침을 추가하며, 프로젝트 기반의 즉각적인 tmux 터미널을 노출하고, Commander 및 Flat 뷰에서 에이전트를 그룹화할 수 있습니다. 완성된 영역은 에이전트를 삭제하지 않고도 아카이브하고 복원할 수 있습니다.
에이전트 클래스 및 사용자 지정 모델
클래스는 역할(role), 모델(model), 지침(instructions), 기본 스킬을 묶어 제공합니다. Tide는 Scout, Builder, Debugger, Architect, Warrior, Support, Boss 클래스를 포함합니다. 사용자 지정 클래스는 스케일, 오프셋, 유휴/걷기/작업 애니메이션 매핑이 적용된 업로드된 GLB 캐릭터 모델을 사용할 수 있습니다.
Create Agent Class
프롬프트 스태킹 및 메모리
지침은 계층적으로 구성됩니다:
- Tide Commander 기본 규칙
- 글로벌 시스템 프롬프트
- 영역 프롬프트
- 에이전트 클래스 지침
- 개별 에이전트 지침
- 할당된 스킬, 정체성(identity), 영구 에이전트 메모리
이를 통해 조직 전체의 규칙을 한 번 정의하고, 프로젝트/클래스별로 전문화하며, 모든 곳에 동일한 프롬프트를 복사할 필요 없이 에이전트별로 지속적인 노트를 유지할 수 있습니다.
스킬(Skills)
스킬은 도구 권한 및 선택적 모델/컨텍스트 동작을 가진 재사용 가능한 지침 세트입니다. 이는 직접 할당되거나 클래스로부터 상속될 수 있습니다. 내장 기능에는 알림, 에이전트 간 메시징, 위임 보고서, 추적(tracking), 영구 메모리, 스트리밍 실행, Git/릴리스 워크플로우, 서버/PM2 로그, 테스트, 데이터베이스, 브라우저/컴퓨터 제어, HTTP 요청, 워크플로우, 트리거, Mermaid, Bitbucket 검토, 백업/복원 등이 포함됩니다.
사용자 지정 스킬은 Markdown 기반이며 UI에서 관리할 수 있습니다. 변경 사항은 세션을 보존하면서 할당된 에이전트들에게 핫 리로드(hot-reload) 됩니다.
플러그인(Plugins)
신뢰할 수 있는 로컬 플러그인은 다음을 추가할 수 있습니다:
- LLM을 우회하는 슬래시 명령어
- 구조화된 Guake/Spotlight 결과 카드
- 오른쪽 사이드바 뷰 및 모달
- 상호작용 액션 및 WebSocket 패치
- 브라우저 측 UI 번들 및 스타일
- 서버 핸들러 및 통합 기반 설정
- 구성 가능한 전역 단축키
최근 내장 기능은 Gmail 받은 편지함 카드, Jira 티켓 검색/세부 정보, 모든 하네스(harness)의 계정 사용량, 작업 보드, 관리형 셸 명령어 등을 노출합니다. 플러그인은 Tide Commander의 로컬 권한으로 실행되므로 신뢰하는 코드만 설치하세요.
워크플로우 및 트리거
워크플로우 편집기는 액션(action), 대기(wait), 결정(decision), 종료(end) 상태로부터 스테이트 머신을 구축합니다. 액션은 에이전트 작업 할당, 이벤트 대기, 변수 설정, 에이전트 완료, 변수 조건, 시간 초과, cron 스케줄, 트리거 또는 수동 결정을 통해 전환할 수 있습니다. 실행 인스턴스는 일시 중지(pause), 재개(resume), 취소(cancel), 타임라인, 변수, 추론 추적(reasoning traces), 범위 지정된 워크플로우 채팅을 지원합니다.
트리거는 웹훅(webhooks), cron/일회성 스케줄, Gmail, Slack, Jira, WhatsApp, Bitbucket에 반응할 수 있습니다. 매칭은 구조적(structural), LLM 기반, 또는 하이브리드 방식이 가능하며, 선택적으로 변수 추출, 서명 검증(signature validation), 전송 중복 제거(delivery deduplication), 그리고 발화/매처 기록을 지원합니다.
구성 요소 (Buildings)
구성 요소는 장식이 아닌 기능적 객체입니다:
| 유형 | 역할 |
|---|
| Server | 사용자 지정 또는 PM2 시작/중지/재시작, 로그, 상태 확인(health), CPU/메모리 및 포트 감지 |
| ... | |
🖥️ 뷰 및 탐색
