Function main

src/cli.py:35–165

CLI main entry point.

()

def main():
    """CLI main entry point."""
    # WI-0.1 (ch17 Phase 0): instrument cold-start phases. Env-gated by
    # ``CLAUDE_CODE_PROFILE_STARTUP``; a no-op import + no-op call when
    # disabled (~ns overhead). On exit the profiler writes a Markdown
    # report to ``$CLAUDE_CONFIG_DIR/startup-perf/{session_id}.txt``.
    from src.utils.startup_profiler import profile_checkpoint
    profile_checkpoint("cli_main_entry")

    import os
    if os.environ.get("CLAWCODEX_DEBUG", "").lower() in ("1", "true", "yes"):
        import logging
        logging.basicConfig(
            level=logging.WARNING,
            format="%(asctime)s %(name)s %(message)s",
            stream=sys.stderr,
        )

    if len(sys.argv) == 2 and sys.argv[1] in ['--version', '-v', '-V']:
        from src import __version__
        print(f"claw-codex version {__version__} (Python)")
        return 0

    # Subcommands are matched BEFORE the main parser to avoid argparse treating
    # a free-form prompt (e.g. ``clawcodex -p "hello"``) as an unknown
    # subcommand.
    #
    # WI-4.3: ``mcp``, ``daemon``, and ``doctor`` are fast-path subcommands
    # — they get a thin handler that imports only what it needs, skipping
    # the TUI/REPL/full-tool-registry load. Mirrors TS ``main.tsx``'s
    # specialized-subcommand early-returns.
    #
    # Sieve looks at ``argv[0]`` ONLY so flag values that happen to equal a
    # subcommand name don't mis-route (e.g. ``clawcodex --model mcp`` or
    # ``clawcodex -p "doctor"``). The TS reference also positions
    # specialized subcommands at argv[0]; global flags don't precede them.
    argv = sys.argv[1:]
    if argv and not argv[0].startswith('-'):
        token = argv[0]
        rest = argv[1:]
        if token == 'login':
            return handle_login()
        if token == 'config':
            return show_config()
        if token == 'mcp':
            from src.entrypoints.mcp import run_mcp_subcommand
            return run_mcp_subcommand(rest)
        if token == 'daemon':
            from src.entrypoints.daemon import run_daemon_subcommand
            return run_daemon_subcommand(rest)
        if token == 'doctor':
            from src.entrypoints.doctor import run_doctor
            return run_doctor()
        if token == 'agent-server':
            from src.entrypoints.agent_server_cli import run_agent_server_subcommand
            return run_agent_server_subcommand(rest)
        if token == 'tui':
            return _run_tui_subcommand(rest)