개요

Prospero는 w64devkit 저자 Chris Wellons(skeeto, 블로그 nullprogram.com)가 만든 코딩 하네스다. Windows·macOS·Linux에서 도는 네이티브 GUI 앱이고, 모델 공급자에 연결해 에이전트가 파일을 읽고 쓰고 명령을 돌리고 화면까지 조작하며 소프트웨어를 개발하게 한다. 문제의식은 블로그 첫 문단에 있다. 대부분의 하네스가 웹 스택으로 만들어져 메모리를 기가바이트 단위로 먹는데, 코딩 하네스의 핵심은 “curl을 popen()에 붙인 것”에 불과하다는 것이다. 그래서 Dear ImGui 도킹 UI를 얹은 C++ 단일 실행 파일로 만들었고, 다른 하네스보다 자원을 “두 자릿수(100배)가량 적게” 쓴다고 주장한다. 이 수치는 작성자 주장이고 측정 자료는 공개되지 않았다.

2026-11-01 수집 시점 지표: 스타 102개, C++, Unlicense(퍼블릭 도메인), 저장소 생성 2026-10-21, 최신 릴리스 v0.10.0(11-01). 첫 커밋은 10-20이고 열흘 남짓 사이 커밋 388개, src/ 약 13만 줄이 쌓였다. 커밋 388개 중 385개에 Co-Authored-By: Claude Opus 5.5가 붙어 있어, 하네스 자체를 AI 에이전트와 함께 짰다는 점이 드러난다.

무엇이 다른가

공급자는 직접 붙인다

내장 공급자가 없다. OpenAI Chat Completions 호환 API(llama.cpp, vLLM, LiteLLM, OpenRouter 등)와 Anthropic Messages API(extended thinking, 프롬프트 캐싱 포함) 두 가지를 말한다. 작성자가 처음부터 겨냥한 것은 로컬 오픈웨이트 모델이다. 소비자급 고성능 하드웨어에서 돌아가는 모델도 간단한 프로그래밍 작업은 믿을 만해졌다는 판단에서 출발했다. llama-cpp 서버의 chat_template_kwargs를 template.NAME = VALUE로 넘길 수 있고, like = OTHER로 같은 모델의 추론 강도만 다른 변형(예: large-quick, large-deep)을 별도 모델처럼 고를 수 있다. Claude 구독으로는 쓸 수 없고 API 키가 필요하다.

”절대 영원히 기다리지 않는다”

블로그가 꼽는 최우선 설계 원칙이다. 밤새 맡긴 작업이 두 시간째 사소한 문제에 걸려 아침까지 멈춰 있던 경험에서 나왔다.

  • 권한 요청에 타임아웃: 허락을 묻는 카드는 기본 30초([guard] ask_timeout) 안에 답이 없으면 거부된다. 에이전트는 그 경로 없이 계속하고, 끝내 필요하면 턴을 마칠 때 사용자에게 요청한다. 아무도 보지 않는 세션(prospero run, eval, 백그라운드)은 묻는 즉시 거부된다.
  • 셸 타임아웃 → 백그라운드 작업: 시간 초과한 명령은 죽이지 않고 비동기 백그라운드 작업으로 바뀐다. 에이전트는 주기적으로 깨어나 더 기다릴지 판단한다.
  • 모든 네트워크 요청에 타임아웃과 watchdog, 에이전트 간 메일박스는 크기를 제한한다.
  • 예외는 Plan 모드다. 계획 승인이나 ask_user 질문은 무기한 기다린다. Plan 모드에서는 사용자가 지켜보고 있다고 전제한다.

떠도는 프로세스를 남기지 않는다

에이전트가 병렬 빌드를 시작했다가 타임아웃으로 “멈추면” 빌드 시스템 일부만 죽고 나머지는 계속 돈다. 다시 시도하면 빌드 두 개가 서로 간섭하며 시스템을 마비시킨다. Prospero는 명령의 프로세스 트리 전체를 한 덩어리로 묶어, 멈추면 정말 멈추게 한다. Windows는 Job Object로 쉽지만 macOS·Linux는 어려운데 끝까지 구현했다고 한다. 테스트 스위트에도 하네스를 강제 종료해도 프로세스가 남지 않는지 보는 cleanup 항목이 있다.

가벼워서 가능한 일

  • 패시브 렌더링: ImGui는 보통 게임처럼 vsync마다 다시 그리지만, Prospero는 할 일이 없으면 아무것도 그리지 않는다. 에이전트가 빌드를 기다리는 동안 GPU를 쓰지 않는다.
  • 퍼징 캠페인: 헤드리스 리눅스에서 퍼징을 몇 시간 돌리면 OOM killer가 폭주한 퍼징 대상 대신 메모리를 많이 먹는 하네스를 죽이곤 했다. 가벼운 하네스라면 퍼징 도중 발견한 버그를 에이전트가 고치면서 캠페인을 이어 갈 수 있다는 것이 작성자의 논리다.
  • 오래된 OS: Windows x86 엔진은 Windows XP에서도 돈다. 테스트에 XP 데스크톱의 메모장을 실제 헬퍼로 조작하는 시나리오가 있다.

기능 구성

영역내용
UI세션 트리(서브에이전트는 부모 아래), 마크다운 transcript, 도구 호출별 Undo, 턴 시작 지점으로 Rewind, 할 일 목록, 백그라운드 작업 창. 창을 드래그·도킹해 배치하고 레이아웃을 이름 붙여 저장
모드Build(기본), Plan(plan.md만 쓰기, 승인 후 실행), Bypass(빨간색, 아무것도 묻지 않음, 사용자만 켤 수 있음)
세션포크, 사이드 챗(작업 중에도 만드는 포크, 파일 수정 금지), git worktree 세션, 세션 간 메시지(8홉·턴당 20개 제한), 내보내기·가져오기
서브에이전트병렬 작업·컨텍스트 분리용. 실행 중인 명령이나 서브에이전트를 Ctrl+B로 백그라운드로 보내고 대화 계속
데스크톱 제어스크린샷, 클릭, 드래그, 키 입력, 창 목록, 프로그램 실행. Windows(XP 이상), macOS(15.2 이상), Linux(X11·Wayland). 기본은 동작마다 승인
원격·백그라운드같은 실행 파일을 헤드리스 엔진으로 돌려 ssh·WSL 너머에서 작업. prospero deploy로 원격에 엔진 업로드, 창을 닫아도 호스트로 계속 실행하고 나중에 다시 붙음
확장스킬(.claude/skills·.agents/skills·.cursor/skills·.codex/skills 탐색, Claude Code와 같은 형식), MCP(stdio·Streamable HTTP, OAuth), 프로젝트 .mcp.json, 프로젝트 메모리
웹web_search(SearXNG, Exa, Anthropic 웹 검색), web_fetch. 기본 꺼짐, 요청마다 승인
자기 도움말내장 prospero 스킬이 자기 문서를 읽고, 답변에 설정·창으로 바로 가는 링크를 달며, prospero.ini를 고쳐 다시 읽힌다
셸Windows에서는 w64devkit 셸을 우선 사용. 세션 중간에 PowerShell·bash·zsh로 바꿀 수 있고 에이전트에 셸의 알려진 특성을 알려 준다

내장 터미널과 편집기는 없다. Ctrl+G로 외부 편집기($EDITOR)에서 프롬프트를 쓰고, 터미널도 외부 것을 연다. TUI가 없는 이유는 헤드리스 엔진 때문이다. 엔진은 서버에서 돌고 GUI는 내 노트북에서 붙는다.

설정은 INI 하나

~/.config/prospero/prospero.ini 하나로 끝나고, 설정 창도 같은 파일을 줄 단위로 고친다. API 키는 파일에 쓰지 않고 key = env:NAME 또는 key = file:PATH로 읽는다. include =로 다른 파일이나 URL을 포함할 수 있어 팀 공용 설정을 쓸 수 있다. 단, URL로 포함한 파일은 명령 실행이나 무승인 동작으로 이어지는 키(MCP command, trust = yes, [desktop], [remote], 편집기 경로 등)를 설정할 수 없다. 작성자도 “엔드포인트를 제어하는 쪽이 환경 변수를 API 키로 빼낼 수 있으니 어느 정도 신뢰는 필요하다”고 적었다.

편집 형식 벤치마크

[model] edit_format은 편집 도구가 변경을 받는 형식이다. replace(옛 텍스트→새 텍스트, 기본), patch(*** Begin Patch apply_patch 형식), hashline(read가 보여 준 줄 번호를 파일 내용 태그로 검증) 세 가지가 있다. 저장소의 tests/bench/RESULTS.md는 한 줄짜리 버그 40개(C++ 24, Python 10, JS 6)로 모델 3개×형식 3개, 총 600회를 돌린 결과를 싣고 있다.

모델결과 요지
DeepSeek V4.1(원격)세 형식 모두 100%. hashline이 호출 3.1회·읽기 1.05회로 가장 적음
Qwen3.8 Flash Next(로컬, IQ4_XS)hashline만 100%, 호출·출력 토큰·시간도 최소
Qwen3.8 27B(로컬, Q8_0)replace가 100%이고 가장 저렴
  • patch는 실패한 편집이 200회 중 16건으로 가장 많았다. replace는 0건, hashline은 3건이었다. 실패한 편집은 모두 다음 시도에서 성공했고, 그만큼 요청이 한 번씩 더 들었다.
  • 저자 스스로 “이 벤치마크는 포화됐다”고 인정한다. 줄을 인용해 주는 한 줄 수정이라 거의 모든 형식이 풀었고, 형식 간 차이는 성공률이 아니라 같은 성공에 드는 비용(읽기·호출·토큰)에서만 나왔다. 더 어려운 과제에서는 결과가 달라질 수 있다.

같은 비교는 prospero eval 스위트로도 들어 있어, 직접 모델별 형식을 데이터로 고를 수 있다.

권한 모델의 한계

문서와 블로그 모두 권한이 악의적인 에이전트를 막지 못한다고 분명히 한다. 파일 도구는 작업 디렉터리 밖에서 승인을 묻지만, 셸 명령은 묻지 않는다. 에이전트에게 작업 디렉터리 안에 머물라고 지시할 뿐 강제하지 않고, 명령이 바꾼 파일은 Undo도 안 된다. 블로그 표현으로는 권한이 “프로젝트 안에 있어라” 같은 가벼운 상기 장치이자 단순 실수를 잡는 장치다. 정말 막으려면 컨테이너나 라즈베리 파이처럼 하네스 자체를 격리해야 한다. Bypass 모드에서도 상태 디렉터리 쓰기, 대화에 나온 적 없는 웹 주소, 로컬 주소 접근은 여전히 거부된다.

Community Edition과 Professional Edition

  • Community Edition: GitHub 빌드, 무료. 헤드리스 엔진이 내장되지 않아 원격 배포가 제한되고 Community Edition이라는 작은 안내 문구가 뜬다.
  • Professional Edition: itch.io에서 $25(수집 시점). DRM 없는 다운로드, 무료 업데이트. x86·x86-64·ARM64 × macOS·Windows·Linux 원격 엔진이 모두 들어 있어 버튼 하나로 원격 배포가 된다.

두 판 모두 Windows·macOS 빌드는 코드 서명돼 있다. 소스는 퍼블릭 도메인이라 직접 빌드할 수 있다(CMake). 업무에 쓴다면 원격 기능을 안 쓰더라도 구매해 달라는 것이 작성자의 요청이다.

평가

  • 강점: 무인 장시간 작업에서 하네스가 걸려 멈추는 문제와 고아 프로세스 문제를 설계 원칙으로 정면에서 다룬다. 로컬 모델용 템플릿 인자·모델 변형·편집 형식 선택을 1급 설정으로 두고, 그 선택을 eval 데이터로 정하게 한다. 데스크톱 제어가 앱별 MCP 없이 기본 내장이라 GUI 앱 개발·테스트에 쓸 수 있다.
  • 주의할 점: 공개 2주가 안 된 0.x 버전이고 스타 102개로 사용자 검증이 적다. “자원 100배 절약”, “현존 최고 하네스 중 하나”는 작성자 자평이다. 셸 명령은 승인 없이 실행되고, 시간 초과 거부 방식이라 무인 실행에서는 에이전트가 권한 없는 길을 우회해서라도 끝내려 할 수 있다. 모델 품질에 대한 보정이 하네스에 없으므로, 약한 로컬 모델일수록 결과는 모델에 달려 있다.

관련