23/Documentation
용어집
Collie의 용어를 다른 도구에서 사용하는 이름과 비교하여 명확하게 설명합니다: session, space, tab, pane, terminal, durable agent, harness, crew, lead 등
Collie에서 사용하는 용어를 알기 쉽게 정리했습니다. 각 항목은 간결하게 설명되어 있으며 관련 페이지로 연결됩니다. 다른 도구에서 동일한 대상을 다른 용어로 부르는 경우 해당 내용도 함께 명시합니다.
Collie(인스턴스)
실행 중인 하나의 bridge 프로세스입니다. 하나의 휴대폰 URL을 제공하고 하나의 터미널을 감시하며, 그 옆에 durable agent를 함께 표시할 수 있습니다. 한 호스트에서 여러 인스턴스를 실행할 수 있으며, 각각 고유한 포트와 상태 폴더(단일 호스트에서의 다중 Collie 인스턴스)를 가집니다.
Session
하나의 에이전트 대화입니다. pane에 표시되며, Chat이 harness(세션)에서 이를 읽어옵니다. tmux와 zellij 역시 자체 최상위 그룹을 session이라고 부릅니다. Collie는 해당 그룹을 space(으)로 표시합니다.
Space
폴더를 포함하는 탭 그룹입니다. 휴대폰 화면의 최상위 레벨입니다. Herdr 워크스페이스, tmux 세션, zellij 세션, 그리고 durable agent 모두 space에 해당합니다.
Tab
pane 그룹입니다. Herdr 탭은 tab이며, tmux 윈도우 역시 tab(터미널)입니다.
Pane
휴대폰에서 열 수 있는 개별 화면 단위입니다. 터미널에서는 화면이 있는 pane 형태입니다. durable agent에서는 하나의 대화이며, Chat에서만 열립니다.
Terminal(mux)
쉘과 에이전트를 실행하는 프로그램인 Herdr, tmux, zellij, tuios 또는 Tern을 의미합니다. 다른 도구에서는 이를 multiplexer 또는 mux라고 부릅니다. COLLIE_MUX(터미널) 옵션으로 선택합니다.
Durable agent
자체 저장소를 가지고 독립된 프로세스로 실행되는 에이전트입니다. durable wire를 통해 Collie에 연결됩니다. Durable SDK를 사용하거나 wire 프로토콜을 제공하는 모든 프로그램으로 구축할 수 있습니다. 자체적인 space, tab, pane을 구성합니다. 실험적 기능이며, collie durable attach(Durable agent) 옵션으로 연결합니다. 세션은 터미널 세션이거나 durable 세션입니다. API와 코드에서는 여전히 이 채널을 program(이)라고 부릅니다.
Harness
pane에서 실행되는 에이전트: Claude Code, Codex, pi, OmO 또는 durable agent(휴대폰에서 Claude Code 사용하기).
Crew
lead와 그 member들로 구성됩니다. 여러 머신을 하나의 휴대폰 URL(crew)로 통합해 줍니다. 단일 머신에서 터미널과 durable agent를 함께 표시할 때는 crew가 필요하지 않습니다.
Lead
휴대폰과 직접 통신하는 Collie입니다. member들의 목록을 병합하고 이들의 pane을 중계합니다(crew).
Member(peer)
crew에 참여한 하나의 Collie입니다. 두 단어는 같은 의미입니다. "Member"는 crew 기준의 표현이며, "peer"는 다른 인스턴스와 함께 실행되는 Collie를 가리키는 표현입니다(crew).
Question card(ask)
durable agent가 제시하는 질문입니다. 휴대폰에 카드 형태로 표시되며, 탭 한 번으로 바로 응답할 수 있습니다. Collie가 임의로 대신 답변하지 않습니다(Durable agent).
Belt
작성기 상단의 작업 행입니다. harness 섹션에는 harness 자체의 버튼들이 위치합니다(설정).
Starter
New 페이지에서 durable agent에 새 창을 생성하는 행입니다 (durable agent의 starter 목록).
Source
sources.json에서 durable agent 항목 하나를 가리킬 때 사용하는 단어입니다. 해당 파일 이름 및 필드에서만 볼 수 있습니다. 휴대폰 화면에는 "source"라는 단어가 표시되지 않으며, durable agent로 표시됩니다 (durable agent 연결).
제한 기준
durable agent가 수행할 수 있다고 밝힌 작업 중 하나입니다: asks, starters, send, steer, abort, rename, close, actions, history 또는 reopen. 휴대폰 화면에는 durable agent가 지정한 cap의 제어 항목만 표시됩니다. 푸시 한도 역시 cap이라고 부르지만, 서로 다른 개념입니다 (durable agent의 푸시).
Hello
durable agent가 Collie에 처음 전달하는 정보입니다. 지원하는 wire 버전, cap 목록, 이름이 포함됩니다. Collie는 버전이 일치하지 않는 durable agent로부터는 추가 데이터를 읽지 않습니다 (버전). crew 링크에는 lead와 member 간에 자체 hello가 존재합니다 (crew).
Epoch
durable agent가 시작될 때마다 생성하는 레이블입니다. 대화 내 위치는 단일 epoch 내에서만 유효합니다. epoch가 변경되면 Collie는 대화를 처음부터 다시 읽습니다 (Durable agent).
Receipt
휴대폰이 durable agent에 요청한 단일 작업의 기록입니다: 응답, 전송, 중지, starter 탭. 요청 ID와 결과를 담고 있어 재시도 시 다시 실행되지 않고 재생되도록 합니다. Collie는 receipt를 상태 폴더에 보관합니다 (Collie가 durable agent의 데이터를 보관하는 위치).
Conversation
휴대폰의 Durable agents 페이지에서 durable 세션을(를) 부르는 명칭입니다. 대화 목록에는 사용자의 응답을 기다리는 항목이 먼저 표시되고, 그 뒤로 열려 있는 다른 항목, 닫힌 항목 순으로 표시됩니다 (스마트폰 표시 내용).
Durable agents 섹션
대시보드에서 모든 durable agent를 한 행씩 나열하는 그룹입니다. 대기 중인 질문이 있으면 공간 목록 위로 이동하며, 연결된 durable agent가 없으면 아무것도 표시하지 않습니다 (스마트폰 표시 내용).
Wire
Collie와 durable agent 간 통신에 사용하는 규칙입니다: hello를 거쳐 스냅샷, 이벤트, 응답 순으로 전달됩니다. 현재 버전 1 하나만 지원합니다. 프라이빗 소켓 또는 토큰을 사용한 https를 통해 실행됩니다 (버전).