<p align="center">
<img src="https://raw.githubusercontent.com/styleio/ShikishaTerm/main/assets/banner.png" alt="SHIKISHA-TERM — Conduct all your AIs from one window" width="820">
</p>
<p align="center">
<b>여러 AI 에이전트를 한 번에 실행하고, 서로 도움을 주고받도록 @mention할 수 있습니다. PC, 클라우드 또는 휴대폰에서 가능합니다.</b><br>
Windows용으로 Microsoft Store나 포터블 zip 파일로 사용 가능하며, 이미 가지고 있는 AI 구독을 활용합니다.
</p>
<p align="center">
<sub><b>호환되는 서비스:</b> Claude Code · Codex · Gemini CLI · Aider · OpenAI · Anthropic · DeepSeek · Mistral · OpenRouter · Ollama · LM Studio — 또는 SSH를 통한 모든 셸</sub>
</p>
<p align="center">
<a href="https://apps.microsoft.com/detail/9PB8XQVM87Z0?launch=true&mode=full">
<img alt="Microsoft에서 받기" src="https://get.microsoft.com/images/en-us%20dark.svg" height="56">
</a>
</p>
<p align="center">
<a href="https://github.com/styleio/ShikishaTerm/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/styleio/ShikishaTerm?style=social"></a>
<a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
<a href="https://github.com/styleio/ShikishaTerm/releases/latest"><img alt="Release" src="https://img.shields.io/github/v/release/styleio/ShikishaTerm?include_prereleases"></a>
<a href="https://github.com/styleio/ShikishaTerm/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/styleio/ShikishaTerm/actions/workflows/ci.yml/badge.svg"></a>
<a href="README.ja.md"><img alt="일본어" src="https://img.shields.io/badge/README-%E6%97%A5%E6%9C%AC%E8%AA%9E-red.svg"></a>
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/styleio/ShikishaTerm/main/assets/demo.gif" alt="SHIKISHA-TERM 사용 모습 — 하나의 AI가 검토 루프를 위해 다른 AI를 @mention하고, 네 개의 AI가 나란히 배치되며, MicroVM의 클라우드 에이전트와 휴대폰에서 받은 답변"
width="820">
</p>
<p align="center">
<sub>⭐ 유용하다면 <b>star</b>를 눌러 다른 사람들이 찾을 수 있도록 도와주세요.</sub>
</p>
다른 채팅 앱처럼 @멘션으로 다른 에이전트를 호출할 수 있습니다.
"이 기능을 만들고, @codex에게 검토를 요청한 다음, 수정할 것이 없을 때까지 반복합니다."
그 한 줄의 명령어가 작성 및 검토 루프를 시작합니다. 더 이상 복사-붙여넣기 전달자가 될 필요가 없습니다."
휴대폰으로 AI 상태를 확인하고 계속 진행하도록 지시할 수 있습니다.
QR 코드를 스캔하기만 하면 모든 탭이 무엇을 하고 있는지 볼 수 있고, 기차 안에서든, 카페에서든, 침대에서든 명령을 보낼 수 있습니다.
왜 필요한가 (Why)
터미널 AI 하나를 실행하는 것은 쉽습니다. 네 개를 실행하는 것은 아닙니다.
에이전트마다 창이 생겨서 어느 것이 기다리고 있는지 알기 어렵고, 그 사이사이에 복사-붙여넣기를 많이 하게 됩니다. SHIKISHA-TERM은 이들을 하나의 창에 모아놓고 작업 중, 완료, 그리고 인간의 개입을 기다리는 상태를 구분합니다. 에이전트들은 @ 멘션을 통해 작업을 서로에게 넘기고 답변을 다시 읽어옵니다. PC에서든 클라우드 MicroVM에서든 실행할 수 있으며, 휴대폰으로 제어할 수 있습니다.
터미널에서 돌아가는 모든 것과 통신하므로 특정 공급업체에 종속되지 않습니다: Claude Code, Codex CLI, Gemini CLI, DeepSeek, Ollama, Aider 또는 SSH를 통한 일반 셸도 가능합니다.
대부분의 AI 터미널은 단일 에이전트를 실행합니다. 이 터미널은 여러 개를 실행하며 — PC에서든 클라우드에서든입니다.
예를 들어:
- "@codex에게 검토를 요청하고, 깨끗해질 때까지 반복하게 하라" — 한 줄의 명령어로 두 에이전트가 주고받으며 작업합니다.
- 네 개의 브랜치에 각각 하나씩, 모두 하나의 창에서 작업하는 네 개의 에이전트.
- 클라우드 MicroVM에서 YOLO 모드로 작동하는 에이전트를 PC와 분리하여 운영할 수 있습니다.
- 개발 서버를 내장 브라우저로 열고 자체적으로 디버깅하는 AI.
- 장기 작업을 시작하고 퇴근길에 휴대폰으로 상태를 확인하며 계속 진행하도록 지시할 수 있습니다.
설치 (Install)
Microsoft Store에서 — 여기서 받기. Microsoft가 스토어 버전을 서명하기 때문에, 지나쳐야 할 보안 경고가 없고 업데이트도 자동으로 도착합니다.
또는 포터블(portable) 버전을 사용하세요. 설치를 원하지 않을 경우에 적합합니다:
- Releases에서
SHIKISHA-TERM.zip을 다운로드합니다.
- 아무 곳에나 압축을 해제하면 됩니다 — USB 스틱과 동기화된 폴더 모두 작동합니다.
SHIKISHA-TERM.exe를 실행합니다.
이것은 자체 창을 엽니다. 실행하기 위해 별도로 필요한 것은 없습니다 — 설정할 터미널도, 제대로 맞출 글꼴이나 색상 구성표도 필요하지 않습니다.
그 폴더 외에는 아무것도 쓰여지지 않습니다. 설치 프로그램(installer)도 없고, 실행 환경(runtime)을 설치할 필요도 없습니다.
기존에 사용하던 AI 구독 서비스를 해당 CLI를 통해 활용합니다. API 키는 저장되지 않으며, 필요한 것도 없습니다.
서버에서 (Linux)
리눅스에서는 창이 존재하지 않습니다. 여기서 작동하는 것은 실제로 작업을 수행하는 부분입니다 — 터미널을 열고, 각 에이전트가 무엇을 하는지 관찰하며, 자동화를 실행하고, 사용자는 브라우저나 휴대폰으로 접속합니다. VPS 또는 클라우드 VM에 설치하면 노트북을 닫아도 에이전트는 계속 작동합니다.
Debian / Ubuntu
curl -fsSL https://pkg.shikisha-term.com/shikisha-archive-key.asc \
| sudo tee /etc/apt/keyrings/shikisha.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/shikisha.asc] https://pkg.shikisha-term.com/apt stable main" \
...
Fedora / RHEL / openSUSE
sudo rpm --import https://pkg.shikisha-term.com/shikisha-archive-key.asc
sudo tee /etc/yum.repos.d/shikisha.repo <<'REPO'
[shikisha]
...
그 외 모든 경우 — 사용자 홈 폴더에 배치하는 정적 바이너리 하나만 있으면 됩니다. 아무것도 요구하지 않습니다:
curl -fsSL https://raw.githubusercontent.com/styleio/ShikishaTerm/main/packaging/linux/install.sh | sh
설치한다고 해서 바로 작동하는 것은 아닙니다. 실행하고 싶을 때 다음 명령어를 사용합니다:
systemctl --user enable --now shikisha
loginctl enable-linger "$USER"
이것은 보드를 열 수 있는 주소를 출력합니다. 모든 것은 하나의 키로 서명되어 있으며, 위의 모든 경로는 설치 전에 이를 확인합니다.
Windows 경고에 대하여
스토어(Store) 버전은 Microsoft가 서명했으며 경고를 표시하지 않습니다. 이 섹션은 zip 파일에만 해당됩니다.
압축 파일에는 코드 서명 인증서가 포함되어 있지 않아, 압축을 해제한 사본을 처음 실행하면
"Windows가 PC를 보호합니다" (코드 서명 정책)라는 메시지가 표시됩니다. 계속하려면 더 많은 정보 → 그래도 실행을 클릭하세요.
이 경고를 사라지게 하는 데 도움을 줄 수 있습니다. 이 경고가 사라진다는 것은 인증서가 필요하다는 의미이며, SignPath Foundation은 오픈 소스 프로젝트에 무료로 이를 발급합니다. 하지만 이런 프로그램의 경우 그들은 이름 뒤에 붙이기 전에 *"특정 검증 가능한 평판"*을 요구합니다. GitHub상의 프로젝트에서 이 평판이 가장 명확한 형태는 별(star)입니다. 따라서 이것이 여러분에게 유용하다면, 리포지토리를 별표 표시 해주세요. 몇 초밖에 걸리지 않으며, 다운로드하는 사람의 손에 서명된 빌드를 전달할 가능성이 가장 높은 행동입니다.
만약 먼저 다운로드를 확인하고 싶다면 — 인터넷에서 받은 서명되지 않은 실행 파일에 주의를 기울이는 것은 올바른 본능입니다:
- 모든 릴리스는 누군가의 노트북이 아닌 GitHub Actions에서 이 소스 코드로 빌드됩니다. 다운로드한 파일의 빌드 로그는 공개적입니다.
- zip 옆에
SHIKISHA-TERM.zip.sha256 파일이 게시됩니다:
Get-FileHash SHIKISHA-TERM.zip -Algorithm SHA256
빠른 시작
처음 실행하면 설정하기(Getting set up) 화면이 열립니다. 이 PC에 설치된 여러 AI 중 주력 AI를 선택하고 GitHub CLI를 확인하세요. 아직 가지고 있지 않은 AI는 그 자리에서 설치 페이지가 열립니다.
그런 다음 화면은 **프로젝트 추가(add a project)**로 안내합니다: 폴더를 선택하거나 Git URL로부터 클론할 수 있습니다 (MicroVM 또는 SSH 서버에도 가능). 다음에 표시되는 곳을 누르면, 해당 AI가 그 폴더에서 시작되며 — JSON 편집이 필요 없습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/styleio/ShikishaTerm/main/assets/setup.png" alt="설정하기 — 이 PC에 설치된 여러 AI 중 주력 AI 선택" width="880">
</p>
설정만 열고 싶거나 (앱 시작이 안 되는 경우 돌아가는 방법), **Settings.cmd**를 더블클릭하세요.
기능 설명
<p align="center">
<img src="https://raw.githubusercontent.com/styleio/ShikishaTerm/main/assets/desktop.png" alt="SHIKISHA-TERM desktop — a mission-control dashboard of several AI agents, each showing whether it is working, waiting or done" width="880">
</p>
1. @mention: 서로에게 작업을 요청하는 에이전트
- 채팅처럼
@로 호출 — 입력창에 @를 입력하면 이 데스크의 탭 목록이 표시됩니다. 선택된 항목은 칩(chip) 형태로 나타납니다. 앞에 있는 에이전트가 작업을 넘겨받고, 답변을 읽어 다음 작업을 진행합니다.
- 검토 루프 (Review loops) — “@codex에게 검토를 요청하고, 수정할 것이 없을 때까지 반복”과 같은 명령은 주고받는 과정을 실행합니다. 앱은 설정(Settings) > “작업 위임 제한(Limits on handing work)”에 지정된 한도까지 라운드 수를 계산해 줍니다.
- 터미널 및 페이지도 가능 — 이름이 지정된 터미널에서 명령을 실행하거나, 이름이 지정된 웹페이지에 목표를 일반 단어로 제시할 수 있습니다.
@로 이름을 붙인 사람의 탭만 구동될 수 있습니다.
- 아무도 긴 작업 때문에 기다리지 않음 — 답변은 작업을 요청한 탭으로 돌아와 완료되었음을 알려줍니다.
2. 여러 작업을 동시에 실행
- 실제 상태를 보여주는 탭 — 모든 탭은 특정 공급업체 API가 아닌 화면 자체에서 감지하여 작업 중인지, 완료되었는지, 아니면 사용자를 기다리는지를 보여줍니다.
- 분할 패널 (Split panes) — 원하는 방식으로 자유롭게 분할할 수 있습니다. 에이전트를 나란히 배치하거나, 에이전트 옆에 해당 에이전트가 구동하는 브라우저를 배치할 수 있습니다.
- 작업 트리 (Worktrees) — 각 브랜치마다 전용 폴더를 가지므로 여러 브랜치를 한 번에 이동시킬 수 있습니다.
- 중단했던 곳부터 재개 — 앱을 닫았다가 대화를 이어서 할 수 있습니다 (Claude Code, Codex).
- 알림 기능 — 작업이 완료되면 Slack / Discord / Telegram, 이 PC 또는 휴대폰으로 알림을 받을 수 있습니다.
3. 클라우드 에이전트 (MicroVM)
- 독립적인 머신 (A machine of its own) — 프로젝트를 클라우드 MicroVM(E2B)에 복제하여 에이전트를 실행할 수 있습니다. 여기서 수행되는 모든 작업은 사용자의 PC로 전송되지 않기 때문에 YOLO 모드를 위한 장소입니다.
- 한 번 설정 (Set up once) — 모든 워크트리는 프로젝트 머신의 사본이므로, 설치하고 로그인한 내용은 이미 그곳에 존재합니다.
- 유휴 시 일시 정지 (Pauses when idle) — 모든 것을 유지하며, URL이나 웹훅(webhook) 호출이 오면 멈췄던 곳부터 다시 시작합니다.
- 토큰 외부 저장 (The token stays outside) — git 서버의 토큰은 나갈 때 추가되므로, 내부 에이전트가 이를 읽을 수 없습니다.
- URL로 미리 보기 (Previews by URL) — 머신이 제공하는 내용을 URL로 열어보며, 비공개 또는 사설 페이지도 확인할 수 있습니다.
4. 내장 기능 (Built in)
- 브라우저 (Browser) — 앱 내부에서 페이지를 열고 AI가 구동하며 확인하도록 할 수 있습니다. 개발 서버의 포트도 브라우저 탭으로 열립니다.
- Git 패널 (Git panel) — diff의 일부를 스테이징하고, AI에게 커밋 메시지 작성을 요청하거나, AI에게 충돌(conflict)을 해결하는 작업을 맡길 수 있습니다.
- SFTP — 왼쪽은 PC, 오른쪽은 서버입니다. 파일을 보내고 가져올 수 있습니다.
- 실제 터미널 (A real terminal) — SSH, Docker, WSL, 점프 호스트(jump hosts), 키 파일, 포트 포워딩(port forwarding), 세션 로그, 레거시 인코딩, IME 입력 및 마우스 지원을 포함합니다.
5. 휴대폰에서 답변하기 (Answer from your phone)
- QR 코드를 스캔하여 모든 탭을 확인하고 지침을 보낼 수 있습니다. PC에서 할 수 있는 모든 것을 휴대폰에서도 할 수 있습니다(아래 참조).
기타 기능 (Also)
- 데스크 (Desks) — 가상 데스크톱처럼 프로젝트별 전체 탭 레이아웃을 전환할 수 있습니다. 자동화 스크립트를 포함하여 하나를 단일 파일로 내보내 다른 머신이나 사람에게 전달할 수 있습니다.
- 자동화 (Automation) —
<p align="center">
<img src="https://raw.githubusercontent.com/styleio/ShikishaTerm/main/assets/phone.png" alt="SHIKISHA-TERM on a phone — a live dashboard of several AI agents, each showing whether it is working, waiting or done" width="340">
</p>
설정에서 "휴대폰으로 사용하기(Use from your phone)"를 켜면 QR 코드가 나타납니다. 이를 스캔하면 모든 탭 목록과 각 탭의 상태, 그리고 지침을 보낼 수 있는 상자가 포함된 작은 웹 페이지가 표시됩니다. Ctrl+B 0 다음 i를 누르면 이와 동일한 코드가 보드에 표시됩니다.
코드 아래에는 조치를 취할 가치가 있는 두 가지 항목만 있습니다. **📋 링크 복사(copies the link)**는 토큰을 포함하여 전체 링크를 클립보드에 복사합니다. 이는 화면 촬영이 불가능한 휴대폰용이며, 그 옆의 배지는 해당 링크가 어떤 네트워크로 연결되는지를 알려줍니다: Tailscale(자신 소유 기기, 어디서든)은 녹색, LAN(해당 Wi-Fi 또는 사무실 네트워크의 모든 사람)은 호박색입니다. 이 링크 자체는 절대 인쇄되지 않습니다. 토큰이 붙어있을 때만 기계에 대한 열쇠가 되며, 토큰 없이 사용하면 아무것도 열리지 않습니다.
접근 가능한 위치 알기(Know where it is reachable from) — 이 기능은 휴대폰으로 사용자님의 기기에 명령을 실행할 수 있게 해줍니다: