Holmes LabAgentic Software Engineering Architect

관리형 AGY를 Bridge에 연결하기

기존 대화형 AGY를 연결하는 절차가 아닙니다. 명시한 runtime·workspace·private credential과 사람이 정한 시간·wake 한도로 관리형 프로세스를 준비합니다.

문서 검토 2026-11-05 · Alpha · macOS · UNLICENSED

이 안내 전에 BRIDGE_CLI·private RUNTIME·broker·등록된 peer를 먼저 준비하세요: Codex↔Claude 첫 사용 안내. 새 터미널마다 같은 변수들을 정의한 뒤 진행합니다.

대상은 관리형 AGY 프로세스

기존 대화형 AGY 세션은 지원하지 않습니다. install-agy는 설정만 쓰며 연결을 증명하지 않습니다. broker와 양방향 route가 준비된 동일 private runtime을 사용해야 합니다. Kit은 필수가 아닙니다.

선택한 실습 폴더의 터미널. 모든 placeholder를 실제 값으로 바꾸고 결과를 읽은 뒤 진행하세요.

AGY_WS="<CANONICAL_ABSOLUTE_AGY_WORKSPACE>"
AGY_CREDENTIAL="<NEW_PRIVATE_ABSOLUTE_AGY_CREDENTIAL_FILE>"
PEER_WS="<EXISTING_CANONICAL_ABSOLUTE_PEER_WORKSPACE>"
node "$BRIDGE_CLI" allow-workspace --path "$AGY_WS" --runtime-dir "$RUNTIME"
node "$BRIDGE_CLI" allow-route --from "$PEER_WS" --to "$AGY_WS" --runtime-dir "$RUNTIME"
node "$BRIDGE_CLI" allow-route --from "$AGY_WS" --to "$PEER_WS" --runtime-dir "$RUNTIME"
node "$BRIDGE_CLI" install-agy --workspace "$AGY_WS" --credential-file "$AGY_CREDENTIAL" --dry-run --runtime-dir "$RUNTIME"
# After review, apply by removing --dry-run.

사람이 정한 예산으로 시작

MAX_WAKES와 MAX_ELAPSED_MS는 사람에게 받은 실제 한도입니다. 기본값을 대신 정하지 않습니다. 설치 경로의 dist/agy-host.js로 실행하고 시간 예산은 시작 즉시 소모됩니다. 첫 출력 conversationId를 읽어, 다른 터미널에 같은 변수들을 정의한 뒤 해당 실제 ID를 제한 시간 안에 등록합니다. 호스트와 CLI의 runtime은 같아야 합니다.

선택한 실습 폴더의 터미널. 모든 placeholder를 실제 값으로 바꾸고 결과를 읽은 뒤 진행하세요.

AGY_HOST="<SELECTED_PACKAGE_DIRECTORY>/dist/agy-host.js"
AGY_WS="<CANONICAL_ABSOLUTE_AGY_WORKSPACE>"
AGY_CREDENTIAL="<NEW_PRIVATE_ABSOLUTE_AGY_CREDENTIAL_FILE>"
MAX_WAKES="<HUMAN_APPROVED_WAKE_COUNT>"
MAX_ELAPSED_MS="<HUMAN_APPROVED_MILLISECONDS>"
node "$AGY_HOST" --runtime-dir "$RUNTIME" --workspace "$AGY_WS" --credential-file "$AGY_CREDENTIAL" --max-wakes "$MAX_WAKES" --max-elapsed-ms "$MAX_ELAPSED_MS"
# Another terminal, using the actual first-output ID:
CONVERSATION_ID="<ACTUAL_FIRST_OUTPUT_CONVERSATION_ID>"
node "$BRIDGE_CLI" enroll --engine agy --native-session "$CONVERSATION_ID" --workspace "$AGY_WS" --display-name agy-a --transport agy-stream --credential-out "$AGY_CREDENTIAL" --runtime-dir "$RUNTIME"

halt와 종료를 구분

종료는 실제 host PID에 TERM을 보냅니다. halt marker가 있으면 child 종료를 확인한 뒤 공식 clear-halt를 검토합니다. child_alive·child_unknown을 무시하지 않습니다. 새 host에는 새 conversation ID와 credential 경로를 사용합니다. 자세한 복구 계약은 공개 README를 따릅니다.

다음으로 이어가기