Paseo와 TaskHandoff 중 무엇을 선택할까? 답은 코드가 실제로 실행되는 위치에 달려있다

만약 어디서든 코딩 에이전트를 실행하는 오픈 소스 방법을 찾아본다면, 아마 같은 오후에 두 개의 프로젝트인 Paseo와 TaskHandoff를 접하게 될 것입니다.

두 프로젝트는 겉으로 보기에는 거의 동일합니다. 둘 다 오픈 소스이며, 데스크톱과 휴대폰을 연결하고, 여러 에이전트를 동시에 실행하며, 하나 이상의 장치를 아우릅니다.

하지만 이들을 완전히 분리하는 한 가지 차이가 있으며, 이는 하나의 문장으로 설명할 수 있습니다: 코드가 실제로 어디에서 실행되는가?

Paseo에 대해 먼저 공정하게 살펴보자

Paseo는 이 분야의 현존 리더입니다. GitHub에서 **20,000개 이상의 별(stars)**을 보유하고 있으며, Apache-2.0 라이선스를 따르고 매우 활발합니다. 스스로를 '데스크톱과 모바일에서 여러 코딩 에이전트를 오케스트레이션하는 것'이라고 소개하며, Claude Code, Codex, Copilot, OpenCode, Pi, Antigravity, Muse Code 등 7개의 프로바이더를 지원합니다. 또한 음성 제어, 플러그인 레지스트리, 스케줄링 기능, 내장 브라우저도 갖추고 있습니다.

아키텍처적으로는 사용자의 장치에 데몬(daemon)을 실행하며, 데스크톱 앱, 모바일 앱, 웹 UI 및 CLI가 모두 이 데몬에 연결됩니다.

그리고 그 자체의 README 파일 한 줄이 이어지는 모든 것을 설명합니다:

"에이전트는 사용자의 전체 개발 환경에서 사용자의 장치에서 실행됩니다. 사용자의 도구, 설정, 그리고 기술을 사용하세요."

Paseo는 Docker 이미지를 배포하지만, 이 이미지가 실행하는 것은 데몬과 웹 UI이지, 사용자 세션이 아닙니다. 문서를 보면 명확합니다: 이 이미지는 에이전트 CLI를 번들링하지 않으며, 사용자가 자체 자식 이미지로 추가해야 합니다.

따라서 Paseo의 기본 가정은 다음과 같습니다: 이 장치는 나의 것이고, 이 환경은 신뢰할 수 있으니, 에이전트가 이를 직접 사용하게 하라. 대부분의 경우, 이 가정이 맞습니다. 그리고 바로 이것이 Paseo가 매우 부드럽게 느껴지는 이유입니다—모든 사용자 설정, 모든 기술, 모든 도구링이 그곳에 있기 때문입니다.

TaskHandoff는 반대 가정에서 시작한다

TaskHandoff 역시 오픈 소스(Apache-2.0) 제어 평면(control plane)이지만, 다음과 같은 가정을 합니다:

이 코드는 사용자가 신뢰할 수 있는 것이 아닐 수도 있다.

그래서 세 개의 레이어로 구축되었습니다:

Control Plane        ← 보는 콘솔
     ↓
  Node Agent         ← 장치당 하나...
... 

에이전트 배포 환경 선택 가이드: 컨테이너와 호스트 접근 방식 비교

모든 세션은 호스트에 직접 실행되지 않고 자체 컨테이너에서 실행됩니다. 이 단 하나의 선택이 아래의 모든 내용에 영향을 미칩니다.

그렇다면 실제로 어떻게 선택해야 할까요?

에이전트에게 전체 액세스를 부여하고 싶을 때 → TaskHandoff

다음은 --dangerously-bypass-approvals-and-sandbox에 대한 Codex 도움말 텍스트입니다:

"매우 위험함. 외부적으로 샌드박스화된 환경에서 실행하는 목적으로만 설계됨."

마지막 네 단어가 핵심 논점 전체를 이룹니다. 개인 노트북에서 승인 절차(approvals)를 비활성화하는 것은 정말 무모합니다. 삭제할 컨테이너 내부에서 이를 비활성화하는 것이 문서화되고 의도된 사용 방식입니다. Paseo의 기본 배포는 "사용자 기기에서 전체 개발 환경을 갖춘 에이전트"입니다. 이는 훌륭하지만, 경계가 사용자 호스트라는 의미이므로 승인 절차를 유지해야 하고 계속 방해받게 됩니다. 만약 원하는 것이 "방해받지 않고 걱정거리가 없는 것"이라면 컨테이너가 필요합니다.

코드가 본인의 것이 아닐 때 → TaskHandoff

AI 생성 코드, 타사 PR(Pull Request), 고객이 건네준 스크립트 등 그 어떤 것도 사용자 기기에 전체 액세스를 허용해서는 안 됩니다.

여러 고객이나 신원을 다룰 때 → TaskHandoff

TaskHandoff는 Git 자격 증명에 대한 실제 모델을 갖추고 있습니다. 이들은 원격 저장소(remote) (스키마 + 호스트 + 포트 + 리포지토리 경로 접두사)에 범위가 지정됩니다. 비밀 정보는 저장 후 쓰기 전용입니다. HTTPS 토큰은 단일 자격 증명 도우미(credential-helper) 요청 기간 동안만 존재합니다. SSH 개인 키는 Node Agent를 절대 벗어나지 않습니다. 인스턴스는 공개 신원과 서명 프록시를 얻으며, 최초 사용 시 신뢰(trust-on-first-use)는 전혀 허용되지 않습니다. 자격 증명은 명시적으로 해당 인스턴스에 보존하지 않는 한 초기 클론만 승인합니다. 여러 고객을 다루게 될 때, 그 계층 구조가 순수한 속도보다 훨씬 중요합니다.

환경이 재현 가능해야 할 때 → TaskHandoff

TaskHandoff는 **환경 템플릿(environment templates)**을 갖추고 있습니다: 작동하는 컨테이너를 가져와 재사용 가능한 템플릿으로 커밋하고, 모든 새 인스턴스는 그 동일한 환경에서 시작합니다. "내 기기에서는 되는데"라는 상황 대신에 말입니다.

그렇다면 언제 Paseo가 더 나은 선택일까요?

솔직히 말씀드리자면 다음과 같습니다:

• 사용자 자신의 노트북에서 여러 에이전트를 실행하고 싶고, 음성 기능, 플러그인 레지스트리, 그리고 더욱 세련된 모바일 앱을 원할 때.
• 프로젝트가 항상 사용자 장치 내에만 존재하며, 코드 주변에 경계가 필요하지 않을 때.

이런 경우라면 Paseo가 더 나은 선택입니다. 게다가 커뮤니티도 훨씬 크고 성숙합니다. 그렇지 않다고 주장하는 것은 어리석을 것입니다.

한 줄 버전

Paseo는 에이전트를 사용자의 장치에 배치합니다. TaskHandoff는 에이전트를 상자 안에 넣습니다.

둘 다 맞습니다. 코드를 얼마나 신뢰하느냐에 달려 있습니다.

빠른 시작

curl -fsSL https://github.com/edgestorage/task-handoff/releases/latest/download/install-server.sh | sudo sh

• 레포지토리: https://github.com/edgestorage/task-handoff
• 문서: https://docs.thandoff.com/

솔직한 주의사항

TaskHandoff는 별점이 한 자릿수이고 베타(Beta) 버전이며, README에는 릴리스 사이에 파괴적인 변경 사항이 있을 수 있다고 명확히 나와 있습니다. 제공자 지원 측면에서는 Paseo에 비할 바가 못 됩니다. 크기 면에서 더 큰 도구라기보다는 작고, 더 집중적이며, 더 신중한 도구입니다.

만약 두 가지 강력한 옵션 중에서 선택해야 한다면, 별점 개수가 아니라 위의 네 가지 경우를 사용하여 선택하십시오.