Holmes LabAgentic Software Engineering Architect

Connect managed AGY to Bridge

This does not attach an existing interactive AGY session. Prepare a managed process with explicit runtime/workspace/private credentials and human-selected elapsed/wake limits.

Documentation reviewed 2026-11-05 · Alpha · macOS · UNLICENSED

Before this guide, prepare BRIDGE_CLI, the private RUNTIME, broker and enrolled peer in the Codex↔Claude first-use guide. Then define the same variables in each new terminal.

Managed AGY processes only

Existing interactive AGY sessions are unsupported. install-agy writes settings; it does not establish binding. Use the same private runtime with broker and both required routes ready. Kit is not required.

Terminal in your selected practice workspace. Replace every placeholder; inspect results before continuing.

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.

Start only with human-selected budgets

MAX_WAKES and MAX_ELAPSED_MS are actual human-approved bounds, never agent-selected defaults. Run the installed dist/agy-host.js, The elapsed budget starts immediately. Read its first conversationId output, define the same variables in another terminal, then enroll that actual ID from another terminal within the enrollment timeout. Host and CLI runtimes must match.

Terminal in your selected practice workspace. Replace every placeholder; inspect results before continuing.

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"

Inspect halt before recovery

Stop with TERM to the actual host PID. If a halt marker exists, inspect child termination before official clear-halt. Do not bypass child_alive/child_unknown. A new host needs a new conversation ID and credential path; follow the published recovery contract.

Continue from here