Function run_peer

core/peer_shell.py:86–162

Open a peer CLI inside Codey's terminal, auto-type the prompt, capture output. Args: cli_name: Short display name (e.g. "copilot") cmd: Shell command (e.g. "copilot") prompt_text: Task to type automatically once the CLI is ready. Returns:

(cli_name: str, cmd: str, prompt_text: str = "")

def run_peer(cli_name: str, cmd: str, prompt_text: str = "") -> str:
    """
    Open a peer CLI inside Codey's terminal, auto-type the prompt, capture output.

    Args:
        cli_name:    Short display name  (e.g. "copilot")
        cmd:         Shell command       (e.g. "copilot")
        prompt_text: Task to type automatically once the CLI is ready.

    Returns:
        Full captured output string (everything that appeared in the peer session).
    """
    if not _check_pexpect():
        warning("pexpect not installed — run: pip install pexpect")
        warning("Falling back to basic shell (no auto-typing).")
        return _run_basic_fallback(cli_name, cmd, prompt_text)

    import pexpect

    width   = _terminal_width()
    border  = "─" * width
    capture = _LiveCapture()

    # ── Draw opening border ────────────────────────────────────────────────
    print(f"\n{_CYAN}{_header(cli_name.upper() + ' CLI', width)}{_RESET}")
    info(f"Opening {cli_name} — task will be typed automatically.")
    if prompt_text:
        print(f"{_DIM}Task: {prompt_text[:120]}{'…' if len(prompt_text) > 120 else ''}{_RESET}")
    print(f"{_DIM}Ctrl+B → take over input | close {cli_name} normally when done{_RESET}")
    print(f"{_DIM}{border}{_RESET}\n")

    try:
        child = pexpect.spawn(
            cmd,
            encoding="utf-8",
            timeout=300,
            dimensions=(40, min(width, 220)),
        )
        child.logfile_read = capture   # everything child prints → stdout + buffer

        # ── Wait for CLI to initialise ────────────────────────────────────
        _wait_for_ready(child, cli_name, pexpect)

        # ── Auto-type the prompt ──────────────────────────────────────────
        if prompt_text:
            time.sleep(0.2)
            child.sendline(prompt_text)

        # ── Hand control to user (Ctrl+B = escape back to Codey) ─────────
        # interact() returns when:
        #   a) user presses the escape character (Ctrl+B → \x02), OR
        #   b) the child process exits (EOF)
        child.interact(escape_character="\x02")

        # ── Drain any last output, then close ────────────────────────────
        try:
            child.expect(pexpect.EOF, timeout=8)
        except (pexpect.EOF, pexpect.TIMEOUT):