<- runpane.com으로 돌아가기

runpane cli

에이전트가 pane을 쓰게 해주는 cli

runpane은 Pane을 설치하고 에이전트에 pane 생성, 터미널 출력 확인, 입력 전송 명령을 제공합니다. Windows, WSL, macOS, Linux, 로컬 머신, 원격 호스트에서 작동합니다.

모든 os를 제대로 지원합니다

Windows와 WSL도 나중에 덧붙인 지원이 아닙니다. macOS, Linux, VM, 원격 호스트에서도 같은 흐름으로 작동합니다.

npm, pnpm, pypi

npx, pnpm dlx, pipx로 시작하세요. 에이전트가 PATH에서 runpane을 찾아야 한다면 전역으로 설치하세요.

에이전트가 pane을 제어합니다

shell 명령을 실행할 수 있는 에이전트라면 저장소 추가, pane 생성, 터미널 출력 확인, 입력 전송을 할 수 있습니다.

에이전트 루프에 맞춰 만들었습니다

에이전트는 Pane을 자신이 관리하는 워크스페이스로 쓸 수 있습니다. 호스팅 scheduler도, 전용 SDK도 없습니다. 터미널 명령이면 됩니다.

설치

한 번 설치하거나 업데이트할 때는 runner를 쓰세요. 최신 버전을 받고 아무것도 남기지 않습니다:

npx --yes runpane@latest
pnpm dlx runpane@latest
pipx run runpane

에이전트나 스크립트에서 runpane을 반복해서 호출한다면 전역으로 설치하세요:

npm i -g runpane
runpane setup

python -m pip install runpane
python -m runpane setup

mcp 대신 cli를 쓰는 이유

MCP는 외부 도구에 아주 좋습니다. 에이전트는 GitHub, Linear, Jira, Slack 등에 MCP를 사용할 수 있습니다. Pane은 이를 대체하지 않습니다.

하지만 모든 에이전트에는 이미 터미널이 있습니다. CLI는 Codex, Claude Code, Aider, Goose, OpenCode, shell 스크립트, cron, CI에서 작동합니다. 추가 server 설치도, 에이전트별 설정도 필요 없습니다.

기본부터 가볍습니다. runpane agent-context는 짧은 요약만 출력합니다. 에이전트는 실제로 필요할 때만 전체 명령 세부 정보를 불러옵니다.

설치 전에 에이전트가 읽을 수 있습니다. 전체 명령 목록은 /runpane-cli-contract.json에 공개되어 있습니다.

전체 워크플로가 오픈 소스입니다. CodexClaude Code orchestrator skill이 issue부터 PR까지 전체 과정을 처리합니다.

사람과 에이전트가 같은 CLI를 씁니다. 설치, 업데이트, 진단, pane 생성, 출력 확인, 입력 전송까지 모두 같은 runpane 명령입니다.

핵심 루프 명령

runpane doctor --json
runpane agent-context
runpane agent-context --command "panels wait" --json

runpane repos list --json
runpane repos add --path "$PWD" --yes --json
runpane agents doctor --agent codex --repo active --json

runpane panes create --repo active --name "issue-252" --agent codex --prompt "Plan this issue" --source agent --wait-ready --yes --json
runpane panes list --repo active --json
runpane panels list --pane <pane-id> --json
runpane panels wait --panel <panel-id> --for ready --json
runpane panels screen --panel <panel-id> --limit 80 --json
runpane panels output --panel <panel-id> --limit 200 --json
runpane panels submit --panel <panel-id> --text "Continue" --yes --json
runpane panels submit-composer --panel <panel-id> --strategy auto --yes --json

wsl과 windows

에이전트는 WSL에서 실행되고 Pane은 Windows에 설치되어 있다면 PowerShell로 Windows wrapper를 호출하세요:

powershell.exe -NoProfile -Command \
  'Set-Location $env:TEMP; runpane repos list --json'

다음 단계

- 첫 AI 에이전트 루프 설정하기

- runpane CLI 레퍼런스 읽기

- 전체 CLI 명령 목록 보기

- Codex용 RunPane Orchestrator skill 사용하기

- Claude Code용 RunPane Orchestrator skill 사용하기

- 에이전트 루프 문서

자주 묻는 질문

또는
다운로드*
Windows SmartScreen 경고Pane에 서명이 없는 동안 직접 다운로드하면 SmartScreen 경고가 표시될 수 있습니다. Pane은 완전한 오픈 소스입니다. 직접 코드를 확인하거나 소스에서 빌드할 수 있습니다.1. 추가 정보 클릭2. '그래도 실행' 클릭3. 설치 계속PowerShell 설치는 공식 릴리스를 바로 받습니다. 브라우저 다운로드에서 생기는 번거로움도 대부분 피할 수 있습니다.npm 전역 설치
PowerShell에 붙여넣으세요.MacLinux