관리형 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를 따릅니다.