콘텐츠로 이동

obs-agent-connector 명령어 참조

이 문서는 obs-agent-connector가 지원하는 Agent, 일반적인 명령어 및 CLI 매개변수를 요약하여 빠르게 참조할 수 있도록 제공합니다.

지원되는 Agent

Agent 식별자 제품명 통합 방식 macOS Linux Windows 설명
claude Claude Code obs-agent-connector 내장 ✅ ✅ ✅ Stop / SessionEnd Hook 어댑터 사용
codebuddy CodeBuddy obs-agent-connector 내장 ✅ ✅ ✅ Stop / SessionEnd Hook 및 네이티브 index.json 리플레이 지원; Linux x64에서 제품 검증 완료
codex Codex obs-agent-connector 내장 ✅ ✅ ✅ Stop Hook 어댑터 사용, Codex 신뢰 및 설정 처리 기능 내장
cursor Cursor obs-agent-connector 내장 ✅ ✅ ✅ ~/.cursor 감지, cursor-agent 우선 사용, 사용자 수준 Cursor Hook 관리
dsh DeepSeek Harness dsh-otel-plugin ✅ ✅ ✅ DeepSeek Harness 설정 패키지 사용
hermes Hermes hermes-otel-plugin ✅ ✅ ❌ Hermes 플러그인 사용
opencode OpenCode opencode-otel-plugin ✅ ✅ ✅ ~/.config/opencode 아래 OpenCode 설정 디렉터리 사용
openclaw OpenClaw openclaw-otel-plugin ✅ ✅ ✅ OpenClaw 플러그인 사용
qoder Qoder qoder-otel-plugin ✅ ✅ ✅ 중국판 또는 국제판 디렉터리 자동 인식 후 해당 --variant 매개변수 전달
workbuddy WorkBuddy workbuddy-otel-plugin ✅ ❌ ✅ 감지된 WorkBuddy 설정 디렉터리 사용, 내부에 gtrace.json 기록

Agent 설명

Agent 식별자 설명
claude 내장 어댑터 사용, 관리형 런타임 설정을 ~/.obs-agent-connector/claude/에 기록합니다.
codebuddy 내장 어댑터 사용. 커넥터가 ~/.codebuddy/settings.json의 Hook 설정을 관리합니다.
cursor 내장 어댑터 사용, 로컬 Cursor CLI를 감지하고 사용 가능한 경우 cursor-agent를 우선 사용합니다.
dsh PATH에 dsh 실행 파일이 있거나 ~/.dsh 디렉터리가 존재하는 경우 발견 가능합니다. 기본 설정은 web이며, 런타임 설정은 dsh-otel-plugin이 생성합니다.
qoder 국제판 또는 중국판 디렉터리를 자동 감지하고 해당 변형을 사용합니다.
qoder-cn 이전 버전과의 호환성을 위한 Agent 식별자로, 항상 중국판 디렉터리를 사용합니다.
hermes Hermes는 YAML 설정을 사용하며 현재 지원되는 JSON 설정 구조에 해당하지 않으므로 CLI가 런타임 활성화 또는 비활성화 상태를 관리하지 않습니다.
openclaw ~/.openclaw/openclaw.json을 통해 런타임 활성화 또는 비활성화 지원; 플러그인이 자체적으로 비공개 설정 구조를 관리하므로 config <agent>는 현재 지원되지 않습니다.
workbuddy macOS 및 Windows 지원, Linux는 현재 지원되지 않습니다.

일반적인 명령어

obs-agent-connector list
obs-agent-connector status <agent>
obs-agent-connector discover
obs-agent-connector discover -u
obs-agent-connector install <agent>
obs-agent-connector config <agent> list
obs-agent-connector config <agent> edit --enabled=false --endpoint=<Endpoint>
obs-agent-connector update <agent>
obs-agent-connector enable <agent>
obs-agent-connector disable <agent>
obs-agent-connector remove <agent>
obs-agent-connector uninstall
obs-agent-connector version
obs-agent-connector version -u

일반적인 매개변수

일반 설치 매개변수

install <agent> 실행 시 일반적으로 사용되는 매개변수는 다음과 같습니다.

매개변수 설명
--endpoint OBS / GTrace 데이터 수신 주소 (예: <Endpoint>)
--x-token 데이터 보고 시 사용되는 인증 토큰
--agent-id 자동 생성된 agent_id를 덮어씁니다
--agent-name 자동 생성된 agent_name을 덮어씁니다
--static-base 이번 설치 시 사용할 기본 주소를 덮어씁니다. 외부 오픈소스 플러그인은 <static-base>/agent_plugins에서 가져옵니다
--yes 확인 단계를 건너뜁니다
--dry-run 실행 계획 및 명령어 미리보기만 출력하고 실제 변경은 수행하지 않습니다

기본 신원 정보 생성 규칙:

  • --agent-id가 지정되지 않은 경우 CLI가 자동으로 agid_<하이픈이 없는 uuidv4>를 생성합니다.
  • --agent-name이 지정되지 않은 경우 CLI가 자동으로 <hostname>_<agent>_<YYYYMMDD>를 생성합니다.

외부 플러그인 호출 규칙:

  • 커넥터는 플러그인에 공용 버전, --type gtrace, Endpoint, Token, 태그 및 설정 또는 변형 매개변수만 전달합니다.
  • 플러그인 설치 프로그램이 압축 파일 다운로드, 체크섬 및 검증, 플러그인 등록 및 비공개 런타임 설정을 직접 처리합니다.
  • 커넥터는 --source를 전달하지 않으며 외부 플러그인의 비공개 gtrace.json을 읽거나 쓰지 않습니다.

내장 어댑터 설치 매개변수

다음 매개변수는 내장된 claude, codebuddy, codex 및 cursor 어댑터에 적용됩니다.

매개변수 설명
--trace-path Trace 데이터 보고 경로를 덮어씁니다
--metrics-path Metrics 데이터 보고 경로를 덮어씁니다
--header HTTP 요청 헤더를 추가합니다. 반복 사용 가능
--tag 리소스 속성을 추가합니다. 반복 사용 가능
--capture-content 콘텐츠 수집 모드.可选 값: none, preview 또는 full
--max-chars 수집 콘텐츠의 최대 문자 수
--enable 런타임 설정을 enabled=true로 설정합니다
--disable 런타임 설정을 enabled=false로 설정합니다

CodeBuddy의 설정은 기존 ~/.codebuddy/gtrace.json에 병합되어 기록되며, 인식할 수 없는 필드는 삭제되지 않습니다.

discover 매개변수

매개변수 설명
-u 설치된 플러그인을 업데이트하고, 발견되었으나 아직 설치되지 않은 플러그인을 설치합니다
--endpoint 이번 실행에 사용할 저장된 Endpoint를 덮어씁니다
--x-token 이번 실행에 사용할 저장된 Token을 덮어씁니다
--yes 확인 단계를 건너뜁니다
--dry-run 발견, 설치 및 업데이트 계획만 출력합니다

update 매개변수

매개변수 설명
--static-base 플러그인 다운로드 기본 주소를 덮어씁니다
--yes 확인 단계를 건너뜁니다
--dry-run 업데이트 계획만 출력합니다

사용 설명:

  • update는 한 번에 하나의 Agent만 허용합니다.
  • update claude, update codebuddy, update codex 및 update cursor는 내장 Hook을 재조정합니다.
  • 외부 플러그인 업데이트 시 현재 런타임 설정이 유지됩니다.

enable 및 disable 매개변수

매개변수 설명
--dry-run 설정 변경 사항만 출력하고 설정 파일에 기록하지 않습니다

현재 JSON 설정을 통해 런타임 활성화 또는 비활성화를 지원하는 Agent:

  • claude
  • codebuddy
  • codex
  • cursor
  • dsh
  • opencode
  • openclaw
  • qoder
  • workbuddy

remove 매개변수

매개변수 설명
--yes 확인 단계를 건너뜁니다
--dry-run 제거 계획만 출력합니다
--purge-config 런타임 설정도 함께 삭제합니다. CodeBuddy의 경우 데이터 보고 상태도 삭제됩니다

version 매개변수

매개변수 설명
-u 커넥터를 최신 버전으로 업데이트합니다
--offline 로컬 버전만 표시하고 원격 버전은 확인하지 않습니다

설치 스크립트 매개변수

install.sh

매개변수 설명
--version 지정된 버전의 커넥터를 설치합니다. 기본값은 latest입니다
--install-dir 커넥터 바이너리 파일의 설치 디렉터리
--config-dir 커넥터 설정 디렉터리
--download-base-url 커넥터 설치 패키지 및 메타데이터의 다운로드 기본 주소
--endpoint OBS / GTrace 데이터 수신 주소
--x-token 인증 토큰
--plugin-source 플러그인 출처. 현재 oss 또는 github 지원
--plugin-base-url 외부 플러그인 다운로드 기본 주소
--binary-only 커넥터 바이너리 파일만 업데이트하고 config.json은 기록하지 않습니다

install.ps1

매개변수 설명
-Version 지정된 버전의 커넥터를 설치합니다. 기본값은 latest입니다
-InstallDir 커넥터 바이너리 파일의 설치 디렉터리
-ConfigDir 커넥터 설정 디렉터리
-DownloadBaseUrl 커넥터 설치 패키지 및 메타데이터의 다운로드 기본 주소
-Endpoint OBS / GTrace 데이터 수신 주소
-XToken 인증 토큰
-PluginSource 플러그인 출처. 현재 oss 또는 github 지원
-PluginBaseUrl 외부 플러그인 다운로드 기본 주소
-BinaryOnly 커넥터 바이너리 파일만 업데이트하고 config.json은 기록하지 않습니다
-NoPathUpdate 사용자의 PATH 환경 변수를 업데이트하지 않습니다

사용 예제

내장된 CodeBuddy 어댑터 설치:

obs-agent-connector install codebuddy --yes

지정된 Endpoint와 Token을 사용하여 외부 플러그인 설치:

obs-agent-connector install dsh \
  --endpoint <Endpoint> \
  --x-token <X-Token> \
  --yes

모든 Agent를 발견하고 설치된 플러그인을 동기화:

obs-agent-connector discover -u --yes

설정은 유지하고 플러그인만 제거:

obs-agent-connector remove codex --yes

커넥터 업데이트:

obs-agent-connector version -u

문서 평가

이 페이지가 도움이 되었나요?