컨텐츠로 건너뛰기
쇼케이스 생태계 소스 코드 문서

Background Agents

Background Agents

Background Agents는 OpenCode에 Claude Code 스타일의 비동기 위임을 제공합니다. 연구 작업을 백그라운드로 보내고, 브레인스토밍이나 코딩을 계속하며, 필요할 때 결과를 가져올 수 있습니다. 결과는 마크다운으로 디스크에 저장되어 컨텍스트 압축 후에도 유지됩니다.

주요 기능

기능설명
작업 계속백그라운드에서 연구가 실행되는 동안 코딩 계속
압축 후에도 유지결과가 마크다운 파일로 디스크에 저장
Fire and forget”웨이터 모델” — 결과가 준비되면 알림 도착
안정적인 위임 ID상태, 아티팩트 경로, 알림, 검색에서 재사용
종료 상태 보호늦은 진행 이벤트가 종료 상태를 되돌릴 수 없음

작동 방식

1. Delegate    →  "Research OAuth2 PKCE best practices"
2. Continue    →  Keep coding, brainstorming, reviewing
3. Notified    →  <task-notification> arrives on terminal state
4. Retrieve    →  AI calls delegation_read() to get the result

결과는 마크다운 파일로 ~/.local/share/opencode/delegations/에 저장됩니다.

설치

KDCO 레지스트리 통해 설치 (권장)

ocx add kdco/background-agents --from https://registry.kdco.dev

또는 전체 워크스페이스 번들 설치:

ocx add kdco/workspace --from https://registry.kdco.dev

수동 설치

src/의 소스 파일을 .opencode/plugin/background-agents.ts에 복사합니다. unique-names-generator 의존성을 수동으로 설치해야 합니다.

도구

도구용도
delegate(prompt, agent)백그라운드 작업 실행
delegation_read(id)특정 결과 가져오기
delegation_list()제목과 요약이 포함된 모든 위임 나열

제한 사항

  • 읽기 전용 서브 에이전트만 지원 (edit=deny, write=deny, bash deny) — 쓰기 가능한 서브 에이전트는 네이티브 task 도구를 사용해야 함
  • 15분 위임 타임아웃
  • 플러그인 호환 라이프사이클 패리티, 런타임 내부 패리티가 아님

링크