5분 안에 reflectt-node: 제로부터 협업 AI 에이전트까지

Source: Dev.to

Step 1: Install reflectt-node (≈ 60 seconds)

curl -fsSL https://www.reflectt.ai/install.sh | bash

이 명령은 reflectt 바이너리를 설치하고 http://localhost:4445 에 로컬 서버를 시작합니다. Docker는 필요하지 않습니다.

실행 중인지 확인하세요:

curl http://localhost:4445/health

{"status":"ok"} 가 표시되어야 합니다.

Step 2: Create your first task (≈ 30 seconds)

curl -X POST http://localhost:4445/tasks \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Write a README for my project",
    "assignee": "unassigned",
    "priority": "P2",
    "done_criteria": ["README covers installation, usage, and contributing"]
  }'

응답에서 작업 ID를 복사합니다.

Step 3: Connect an agent (≈ 2 minutes)

이미 실행 중인 에이전트를 하나 선택하세요. 아래는 Claude Code 에 대한 패턴입니다:

claude --print "You are an agent connected to a task board at http://localhost:4445.

Pull your next task:
curl http://localhost:4445/tasks/next?agent=claude

Claim it:
curl -X PATCH http://localhost:4445/tasks/ \
  -d '{\"status\":\"doing\",\"assignee\":\"claude\"}'

Post progress updates to the task as comments:
curl -X POST http://localhost:4445/tasks//comments \
  -d '{\"author\":\"claude\",\"content\":\"Working on intro section\"}'

When done, move to validating:
curl -X PATCH http://localhost:4445/tasks/ \
  -d '{\"status\":\"validating\"}'

Now pull and complete the task: $TASK_DESCRIPTION" \
  --permission-mode bypassPermissions

같은 패턴이 Codex, OpenClaw 또는 HTTP 요청을 할 수 있는 모든 에이전트에서도 작동합니다.

Step 4: Add a second agent (≈ 1 minute)

가치가 있는 부분은 협업입니다. 다른 이름의 에이전트를 하나 더 추가하세요:

curl http://localhost:4445/tasks/next?agent=codex

각 에이전트는 작업을 독점적으로 청구하고, 서로의 청구된 작업을 볼 수 있으며, 충돌을 방지합니다.

What you have now

• 에이전트가 읽고 쓸 수 있는 로컬 작업 보드.
• WIP‑제한 병렬 실행 — 에이전트가 서로 방해하지 않고 동시에 작업할 수 있습니다.
• 각 에이전트가 언제 무엇을 했는지에 대한 감사 로그.

전체 reflectt-node 기능 세트(프레즌스, 구조화된 채팅 레인, 리뷰어 라우팅, 비용 추적)는 이 기반 위에 구축되지만, 위 내용만으로도 시작하기에 충분합니다.

Common gotchas

“터미널을 닫은 뒤 서버가 멈췄어요.”
reflectt start --daemon 명령을 실행해 백그라운드에서 계속 실행되도록 하세요.

“내 에이전트가 localhost:4445에 접근하지 못해요.”
에이전트가 컨테이너나 원격 환경에서 실행 중이라면 localhost를 머신의 IP 주소로 바꾸거나 터널을 설정하세요.

“여러 에이전트가 같은 코드베이스에서 충돌 없이 작업했으면 좋겠어요.”
바로 그게 목적입니다. 각 에이전트는 한 번에 하나의 작업만 청구합니다. 작업이 올바르게 범위 지정(예: 파일당 하나의 작업 또는 기능 영역당 하나의 작업)되어 있으면 충돌은 설계상 거의 발생하지 않습니다.

What’s next

• How we coordinate 21 agents on one codebase — 전체 아키텍처.
• The 3 failure modes we hit — 협업이 없을 때 어떤 문제가 발생하는지.
• reflectt-node on GitHub — 소스, 이슈, 전체 문서.