Dudes

Release

License: MIT OR Apache-2.0

Dudes는 Rust로 작성된 코딩 에이전트 감독 시스템(supervisor)입니다. 사용자는 Claude Code, Codex 또는 Pi와 같은 에이전트를 고용하고 역할을 부여합니다. 그런 다음 사용자에게 말을 걸거나 완료 확인을 통해 **목표(goal)**를 제시할 수 있습니다. 백그라운드 데몬(daemon)은 해당 체크가 통과될 때까지 에이전트가 작동하도록 유지합니다. Floor는 브라우저 내의 3D 사무실입니다. 이곳에는 각 에이전트가 책상에 배치되어 있으며, 사용자가 보는 것은 데몬이 알고 있는 정보입니다.

상태(Status)

Dudes는 초기 미리 보기(pre-alpha) 버전이며, 명령어와 설정 키는 릴리스 간에 변경될 수 있습니다. macOS 및 Linux의 x86_64와 arm64용 사전 빌드 릴리스는 아래와 같이 한 명령어로 설치할 수 있습니다. Windows도 바이너리를 빌드할 수는 있지만, 사전 빌드 릴리스나 설치 프로그램은 없습니다. 전체 첫 실행 테스트는 Apple silicon 기반의 macOS에서만 진행되었습니다. 플랫폼 및 알려진 제한 사항(Platforms and known limits)를 참조하십시오.

설치(Install)

curl -fsSL https://raw.githubusercontent.com/ArcfluxResearch/dudes/main/install.sh | sh
~/.local/bin/dudes quickstart

이 스크립트는 사용자 기기의 최신 릴리스를 다운로드하고, 이를 릴리스의 SHA256SUMS와 비교한 후, 비로소 duded, dudes, dudes-hook을 ~/.local/bin에, 그리고 Floor 및 라이선스 공지사항을 ~/.local/share/dudes에 설치합니다. 이 과정에서 절대 sudo를 사용하지 않으며 셸 프로필을 수정하지 않습니다. 만약 ~/.local/bin이 사용자 PATH에 없다면, 셸 프로필에 추가해야 할 줄을 출력합니다. 릴리스는 x86_64 및 arm64용 macOS와 Linux를 지원합니다. Linux의 경우 스크립트는 모든 배포판에서 실행되는 정적 빌드를 설치합니다. ~/.local/bin/dudes --version으로 설치 여부를 확인할 수 있습니다. 특정 버전을 설치하려면, sh -s -- --version <버전> 명령어로 스크립트를 실행하십시오. 또한, claude, codex 또는 pi CLI 중 적어도 하나가 로그인되어 있어야 합니다.

업그레이드하려면 dudes upgrade를 실행하세요. 이 명령어는 GitHub에서 최신 릴리스를 요청하고, 해당 릴리스의 install.sh로 설치합니다(이 스크립트는 다운로드된 파일을 릴리스의 SHA256SUMS와 비교하여 확인합니다). 그런 다음 실행 중인 데몬을 중지하고 새 데몬을 시작합니다. 에이전트가 턴을 수행하거나 답변을 기다리거나 세션에 연결되어 있는 동안에는 거부하며, --now 플래그를 추가하지 않는 한 작동하지 않습니다. 이 경우 종료 시간(에이전트의 저장 시간을 최대 6분까지 허용)과 함께 재시작됩니다. 또한 이전 버전은 절대 설치하지 않습니다. dudes upgrade --check는 현재 버전과 최신 버전을 출력할 뿐 아무것도 변경하지 않습니다. 이는 install.sh가 설치한 복사본에 대해서만 작동합니다. 설치 명령을 다시 실행하고, 이어서 dudes stop 및 dudes start를 실행하는 것은 수동으로 동일한 작업을 수행하지만, 열려 있는 모든 Floor 탭의 로그아웃 처리는 해줍니다. dudes upgrade는 이러한 로그인 상태를 유지합니다: 열린 Floor 탭은 나중에 한 번 새로고침이 필요하며, 동일한 에이전트를 보여줍니다.

이전에 이 버전보다 오래된 버전에서 업그레이드하는 첫 경우에는 여전히 열려 있는 탭을 로그아웃 처리합니다. Dudes는 dudes upgrade를 실행할 때만 GitHub에 연결하며, 스스로 업데이트를 확인하지 않습니다.

소스 코드로부터 빌드하거나 Windows에서 사용하는 방법은 Build Dudes from source를 참조하세요.
데몬이 나중에 그룹 권한으로 Floor 디렉토리가 쓰기 가능한 상태여서 시작을 거부하는 경우, 오류 메시지에 명시된 chmod go-w 명령을 실행하세요(Get started).
Dudes를 제거하려면 dudes uninstall를 실행하세요. Where Dudes keeps its data, and how to uninstall에서는 무엇이 삭제되는지 설명하고 수동 단계를 제공합니다.

빠른 시작

에이전트가 작업할 저장소에서:

cd /absolute/path/to/repo
dudes quickstart
dudes floor open

‘dudes quickstart’는 작동할 수 없는 것만 질문하고, 데몬을 시작하며, Floor로 연결되는 링크를 출력하고, 첫 번째 에이전트를 고용할 수 있게 합니다. 이 링크를 아무 브라우저에 붙여넣으세요. ‘dudes floor open’은 나중에 새로운 것을 출력합니다. 원격 머신에서는 링크의 포트를 SSH를 통해 먼저 포워딩해야 하는데, 이는 해당 링크가 루프백 주소이기 때문입니다. 직접 에이전트를 고용하고 목표를 부여하려면, ‘dudes hire’가 출력하는 ID를 사용하세요:

dudes hire --name Cody --role "docs writer" --department docs --provider claude \
  --cwd /absolute/path/to/repo
dudes goal --agent <에이전트 id> --text "hello라는 단어를 포함하는 hello.txt를 생성하세요." 
...

에이전트는 /bin/test -f hello.txt가 통과할 때까지 차례로 작업을 수행합니다. ‘dudes agents’는 모든 에이전트와 그 상태를 나열하고, ‘dudes stop’은 데몬을 중지하며, ‘dudes start’는 다시 시작합니다. 시작하기에서 전체 과정을 확인할 수 있습니다.

quickstart에서 프로젝트를 건너뛰었다면, 해당 git 저장소에서 한 단계로 추가할 수 있습니다:

cd /absolute/path/to/repo
dudes workspace add

Dudes는 저장소 파일에서 완료 검사(completion check)를 제안하고 프로젝트 ID를 출력합니다. 만약 검사를 찾지 못하면, ‘dudes workspace add -- <프로그램> [인수...]’로 직접 전달하세요. 티켓 및 Floor 고용에는 등록된 프로젝트가 필요합니다.

만약 dudes가 다른 것을 실행한다면, 별칭(alias)이나 셸 함수를 확인하려면 ‘type dudes’를 확인하고, ‘command dudes’를 사용하세요. 셸 프로필에서 오래된 정의를 제거한 후에는 새 터미널을 여세요.

작동 방식

• 데몬 및 CLI. duded 데몬은 백그라운드에서 실행되며 모든 상태를 소유합니다. dudes 명령어는 이 데몬과 통신합니다. Floor는 데몬이 알고 있는 내용을 보여주는 뷰입니다. 이는 사용자가 활성화하는 액션을 통해서만 상태가 변경됩니다.

• 에이전트 및 역할. 에이전트는 데몬이 특정 디렉토리에서 작업하도록 고용한 코딩 에이전트 CLI 하나입니다. 에이전트는 이름, 역할(role), 그리고 부서(department)를 가집니다. 역할은 Floor, dudes agents, dudes team에서 표시되는 레이블입니다. 이는 에이전트의 작업 자체에 속하는 것이 아니므로, 작업 내용은 목표(goal)나 채팅 메시지에 설명해야 합니다.

• 목표 및 완료 확인. 목표는 작업 내용과 명령어인 완료 확인(completion check)으로 구성됩니다. 에이전트가 첫 번째 턴을 하기 전에 데몬은 이 확인 절차를 한 번 실행하며, 이미 확인 절차가 통과된 경우 해당 목표를 거부합니다. 매 턴마다 데몬은 다시 확인 절차를 실행합니다. 목표는 오직 데몬 자체의 실행에서 확인 절차가 통과될 때만 완료(Done)됩니다. 에이전트가 자신의 작업에 대해 보고하는 내용은 결코 목표를 완료 상태로 만들지 않습니다.

• 제한. 지출 상한액은 선택 사항이며 기본적으로 비활성화되어 있습니다. 목표는 또한 자체 호프 제한(hop cap)에서 멈추며, 실행 실패는 에이전트를 보류(Hold) 상태로 만듭니다. 목표, 완료 확인 및 중지를 참조하십시오.

• 티켓. 티켓은 제목, 메모, 그리고 '완료 조건(Done when)' 확인 절차를 가진 작업 내용입니다. dudes ticket을 사용하거나 Floor의 Board에서 에이전트의 큐에 티켓을 생성, 수정, 목록화, 제거하고, 검토, 승인, 반송 또는 에이전트의 작업을 중지할 수 있으며, 이때 배너가 해당 티켓이 준비되었음을 알려줍니다. 티켓을 참조하십시오.

• 메일. 에이전트는 dudes mail로 서로 메시지를 보내고, dudes team으로 동료를 찾습니다.

• 작업 트리(Worktrees). dudes hire --worktree는 --trusted로 표시한 저장소에 Claude Code 에이전트의 자체 git 작업 트리를 생성하고 dudes/<id>라는 브랜치를 만듭니다. Dudes는 이 브랜치들을 절대 병합하거나 푸시하지 않습니다.

• The Floor. 에이전트가 턴(turn) 동안 책상에서 타이핑하고, 데몬(daemon)이 검사를 실행하는 동안 목표 보드(goal board)에 서 있고, 답변이 필요할 때 라운지(lounge)에서 기다리며, 목표가 완료(Done)되면 벨을 울립니다. The Floor에서 나머지를 설명하며, Chat에서는 이 기능을 통해 에이전트에게 메시지를 보낼 수 있습니다.

보드에 있는 예시 티켓들. 카드를 열어 에이전트의 요약과 데몬의 검사 결과를 검토하세요.

에이전트가 사용자의 기기에서 할 수 있는 일

Dudes는 기본적으로 로컬 연결(local connections)을 사용합니다. 사용량 및 오류 정보는 이들을 통해 전달될 수 있습니다. 공개된 0.86.0 릴리스에서는 Windows DUDES_SOCK 오버라이드(override)를 사용하여 원격 파이프 서버(remote pipe server)를 선택할 수 있습니다. 현재 소스 코드는 로컬 파이프 경로(local pipe path)가 필요합니다. Dudes가 실행하는 엔진 및 기타 프로그램들은 자체적인 네트워크 연결을 할 수 있습니다. Dudes와 그 엔진들이 보내는 정보에서 경계, 엔진 텔레메트리 제어, 그리고 설치 프로그램 다운로드에 대해 설명합니다.

Dudes는 모든 에이전트와 모든 완료 검사(completion check)를 사용자 계정으로 실행합니다. 자체적인 샌드박스(sandbox)를 추가하지 않습니다. 에이전트를 고용하기 전에 각 엔진이 무엇에 접근할 수 있는지 아는 것이 중요합니다:

• Claude Code는 권한 프롬프트가 건너뛰어진(--dangerously-skip-permissions) 상태로 실행되며, Dudes 설정 중 어떤 것도 이를 다시 켜지 않습니다. 이 코드는 모든 명령을 실행하고 사용자 계정이 접근할 수 있는 모든 파일을 읽고 변경할 수 있습니다.
• Codex는 자체 workspace-write 샌드박스 내부에서 실행됩니다. 그 명령어들은 사용자 계정이 접근할 수 있는 모든 파일을 읽을 수 있지만, 전체 텍스트 목록에 명시된 몇몇 장소에만 쓰기 작업을 수행합니다.
• Pi는 샌드박스가 없습니다. 이 코드는 모든 명령을 실행하고 사용자 계정이 접근할 수 있는 모든 파일을 읽고 변경할 수 있습니다.
• 완료 검사는 샌드박스 없이 에이전트의 작업 디렉토리(working directory)에서 실행됩니다. 완료(Done)에 의존하기 전에 에이전트가 무엇을 변경했는지, 테스트를 포함하여 검토하세요.

사용자 계정 자체가 보안 경계는 아닙니다. 에이전트가 접근할 수 있는 범위를 제한하려면 Dudes를 가상 머신(virtual machine)이나 에이전트들이 변경하기를 원하는 저장소(repository)만 보유한 별도의 사용자 계정에서 실행하세요. 전체 텍스트에 자세한 내용이 있습니다.

문서화

• 시작하기: dudes quickstart부터 목표 달성까지의 전체 첫 실행 과정.
• The Floor: 사무실 뷰, 열리는 방법 및 제공하는 방법, 그리고 보드(Board)의 티켓에 대한 내용.
• Chat: The Floor에서 에이전트에게 메시지를 보내고 Codex 스트리밍을 사용하는 방법.
• 목표, 완료 확인 및 중지: 목표를 교체하거나 일시 정지(pause), 중단(halt), 은퇴시키거나(retire) 완전히 멈추는 방법.
• 티켓: 명령줄 또는 The Floor에서 티켓을 생성하고 에이전트에게 할당하는 방법.
• 에이전트에게 MCP 서버 제공하기: 서버를 선언하고 옵트인(opt in)할 에이전트를 지정하는 방법.
• 설정: 운영자 파일, 설정, 예산 및 환경 변수.
• 에이전트가 사용자의 기기에서 할 수 있는 일: 전체 안전 관련 텍스트.
• Dudes의 데이터 저장 위치 및 제거 방법
• 소스에서 Dudes 빌드하기
• 플랫폼 및 알려진 제한 사항

도움말, 기여 및 보안

질문하거나 아이디어를 Discussions에서 제안하세요;
SUPPORT.md에는 각 유형의 요청이 어디로 가는지 나와 있습니다.
CONTRIBUTING.md에는 푸시하기 전에 실행해야 할 검사 목록이 있으며,
CODE_OF_CONDUCT.md는 기본 규칙을 설정합니다. 보안 문제는 SECURITY.md에 설명된 대로 공개 이슈가 아닌 곳에 보고하세요.

라이선스

다음 중 하나로 라이선스가 부여됩니다:

• Apache License, Version 2.0 (LICENSE-APACHE 또는 https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT 또는 https://opensource.org/licenses/MIT)

선택에 따라.

기여

별도로 명시하지 않는 한, Apache-2.0 라이선스에 정의된 방식으로 귀하가 의도적으로 작업물에 제출하는 모든 기여는 추가적인 약관이나 조건 없이 위와 같이 이중 라이선스(dual licensed)됩니다.