Function _build_parser

src/cli.py:256–392

()

def _build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(
        prog="clawcodex",
        description="ClawCodex - Claude Code Python Implementation",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""\
Examples:
  clawcodex --version                   Show version
  clawcodex login                       Configure API keys
  clawcodex config                      Show current configuration
  clawcodex                             Start the interactive Ink TUI
  clawcodex tui                         Start the interactive Ink TUI (explicit)
  clawcodex -p "hello"                  Non-interactive mode (text output)
  clawcodex -p "hi" --output-format json
  clawcodex -p --output-format stream-json --input-format stream-json < input.ndjson
""",
    )

    parser.add_argument('prompt', nargs='?', help='Prompt to send in non-interactive mode')
    parser.add_argument('--version', action='store_true', help='Show version information')
    parser.add_argument('--config', action='store_true', help='Show current configuration')

    # ---- Interactive UI ----
    #
    # The sole interactive UI is the TypeScript Ink TUI — ``clawcodex`` with no
    # mode flags, or the explicit ``clawcodex tui`` subcommand. It spawns + owns
    # a Python agent-server child (see :mod:`src.entrypoints.tui_launcher`). The
    # former in-process Textual TUI (``--tui``) and Rich REPL (``--legacy-repl`` /
    # ``--no-tui`` / ``--stream``) were removed in favor of this single client.

    # ---- Non-interactive / print mode (Phase 1 parity) ----
    noninteractive = parser.add_argument_group("non-interactive mode")
    noninteractive.add_argument(
        '-p', '--print',
        action='store_true',
        help='Print response and exit (useful for pipes)',
    )
    noninteractive.add_argument(
        '--output-format',
        choices=('text', 'json', 'stream-json'),
        default='text',
        help='Output format for --print mode (default: text)',
    )
    noninteractive.add_argument(
        '--input-format',
        choices=('text', 'stream-json'),
        default='text',
        help='Input format for --print mode (default: text)',
    )
    noninteractive.add_argument(
        '--include-partial-messages',
        action='store_true',
        help='Include incremental assistant text chunks in stream-json output',
    )
    noninteractive.add_argument(
        '--max-turns',
        type=int,
        default=20,