2026-03-22Active

Agent Space

Claude Code, Codex CLI, Gemini CLI, Bash 같은 로컬 에이전트를 하나의 화면에서 실행하고 관리할 수 있도록 만든 프로젝트입니다. PTY와 WebSocket 기반으로 세션을 스트리밍하고, 브라우저와 Electron 환경에서 다중 세션 작업 흐름을 다룰 수 있게 구성했습니다.

Node.jsTypeScriptReactElectronWebSocket
Agent Space

Summary

로컬 CLI 에이전트를 PTY로 실행하고 브라우저에서 세션을 관리하는 애플리케이션입니다.

Why I Built It

로컬에서 여러 CLI 에이전트를 동시에 실행할 때 세션 관리, 출력 확인, 작업 전환이 번거로웠습니다. 각 터미널을 개별적으로 띄우는 방식 대신, 한 화면에서 상태를 보고 제어할 수 있는 작업 공간이 필요했습니다.

Approach

Node.js 백엔드에서 PTY 세션을 생성하고 WebSocket으로 출력을 스트리밍하도록 구성했습니다. 프론트엔드는 React와 xterm.js를 사용해 터미널 UI를 구현했고, Electron 실행도 지원해 브라우저와 데스크톱 앱 두 환경에서 동일한 흐름으로 사용할 수 있게 했습니다.

Key Features

  • PTY 기반 에이전트 세션 생성, 종료, 재연결
  • WebSocket 실시간 출력 스트리밍
  • 여러 세션 동시 실행 및 브로드캐스트 입력
  • 브라우저와 Electron 환경 모두 지원

Tech Stack

Node.jsExpresswsnode-ptyReactViteElectronTailwind CSS