alloy-runtime-cli 0.1.0__py3-none-any.whl

cli/main.py

@@ -0,0 +1,759 @@
+"""Alloy Runtime CLI main entry point.
+
+This module defines the root Typer application and registers all command groups.
+Running `alloy` with no arguments launches the unified TUI application.
+"""
+
+import os
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from cli.commands.admin.credentials.create.command import (
+    admin_credentials_create_command,
+)
+from cli.commands.admin.credentials.grant.command import (
+    admin_credentials_grant_command,
+)
+from cli.commands.agents.create.command import agents_create_command
+from cli.commands.agents.delete.command import agents_delete_command
+from cli.commands.agents.list.command import agents_list_command
+from cli.commands.agents.update.command import agents_update_command
+from cli.commands.auth.login.command import login_command
+from cli.commands.auth.signup.command import signup_command
+from cli.commands.whoami.command import whoami_command
+from cli.commands.agents.get.command import agents_get_command
+from cli.commands.audio.transcribe.command import audio_transcribe_command
+from cli.commands.billing.costs.by_agent.command import billing_costs_by_agent_command
+from cli.commands.billing.costs.by_model.command import billing_costs_by_model_command
+from cli.commands.billing.costs.daily.command import billing_costs_daily_command
+from cli.commands.billing.costs.summary.command import billing_costs_summary_command
+from cli.commands.billing.projects.create.command import billing_projects_create_command
+from cli.commands.billing.projects.get.command import billing_projects_get_command
+from cli.commands.billing.projects.list.command import billing_projects_list_command
+from cli.commands.generate.cancel.command import generate_cancel_command
+from cli.commands.generate.status.command import generate_status_command
+from cli.commands.knowledge.collections.cluster.command import (
+    knowledge_collections_cluster_command,
+)
+from cli.commands.knowledge.collections.cluster_status.command import (
+    knowledge_collections_cluster_status_command,
+)
+from cli.commands.knowledge.documents.bulk_metadata.command import (
+    knowledge_documents_bulk_metadata_command,
+)
+from cli.commands.knowledge.documents.reingest.command import (
+    knowledge_documents_reingest_command,
+)
+from cli.commands.knowledge.documents.update.command import (
+    knowledge_documents_update_command,
+)
+from cli.commands.knowledge.synthesis.update.command import (
+    knowledge_synthesis_update_command,
+)
+from cli.commands.organizations.create.command import organizations_create_command
+from cli.commands.pipelines.create.command import pipelines_create_command
+from cli.commands.pipelines.env_vars.command import pipelines_env_vars_command
+from cli.commands.pipelines.executions.costs.command import (
+    pipeline_execution_costs_command,
+)
+from cli.commands.pipelines.executions.costs_by_model.command import (
+    pipeline_execution_costs_by_model_command,
+)
+from cli.commands.pipelines.executions.costs_by_step.command import (
+    pipeline_execution_costs_by_step_command,
+)
+from cli.commands.pipelines.executions.update.command import (
+    pipeline_execution_update_command,
+)
+
+from cli.commands.pipelines.schedules.env_vars_command import (
+    pipelines_schedules_env_vars_command,
+)
+from cli.commands.pipelines.schedules.create_command import (
+    pipelines_schedules_create_command,
+)
+from cli.commands.pipelines.schedules.update_command import (
+    pipelines_schedules_update_command,
+)
+from cli.commands.pipelines.schedules.once_command import (
+    pipelines_schedules_once_command,
+)
+from cli.commands.schemas.delete.command import schemas_delete_command
+from cli.commands.tags.get.command import tags_get_command
+from cli.commands.tags.update.command import tags_update_command
+from cli.commands.templates.get_by_version.command import (
+    templates_get_by_version_command,
+)
+from cli.commands.tools.get.command import tools_get_command
+from cli.commands.tools.list.command import tools_list_command
+from cli.commands.users.create.command import users_create_command
+
+from cli.commands.content.edit.command import content_edit_command
+from cli.commands.content.get.command import content_get_command
+from cli.commands.content.list.command import content_list_command
+from cli.commands.credentials.create.command import credentials_create_command
+from cli.commands.credentials.update.command import credentials_update_command
+from cli.commands.generate.text.command import generate_text_command
+from cli.commands.models.list.command import models_list_command
+from cli.commands.schemas.create.command import schemas_create_command
+from cli.commands.schemas.get.command import schemas_get_command
+from cli.commands.schemas.list.command import schemas_list_command
+from cli.commands.sync.command import sync_command
+from cli.commands.admin.bootstrap_command import bootstrap_admin_command
+from cli.commands.templates.create.command import templates_create_command
+from cli.commands.templates.delete.command import templates_delete_command
+from cli.commands.templates.get.command import templates_get_command
+from cli.commands.templates.list.command import templates_list_command
+from cli.commands.templates.render.command import templates_render_command
+from cli.commands.templates.update.command import templates_update_command
+from cli.commands.templates.version.command import templates_version_command
+from cli.commands.content.delete.command import content_delete_command
+from cli.commands.schemas.update.command import schemas_update_command
+from cli.commands.render.html_to_image.command import render_html_to_image_command
+from cli.commands.knowledge.collections.create.command import (
+    knowledge_collections_create_command,
+)
+from cli.commands.knowledge.collections.delete.command import (
+    knowledge_collections_delete_command,
+)
+from cli.commands.knowledge.collections.get.command import (
+    knowledge_collections_get_command,
+)
+from cli.commands.knowledge.collections.list.command import (
+    knowledge_collections_list_command,
+)
+from cli.commands.knowledge.collections.update.command import (
+    knowledge_collections_update_command,
+)
+from cli.commands.knowledge.documents.delete.command import (
+    knowledge_documents_delete_command,
+)
+from cli.commands.knowledge.documents.get.command import (
+    knowledge_documents_get_command,
+)
+from cli.commands.knowledge.documents.ingest.command import (
+    knowledge_documents_ingest_command,
+)
+from cli.commands.knowledge.documents.list.command import (
+    knowledge_documents_list_command,
+)
+from cli.commands.knowledge.recover.command import knowledge_recover_command
+from cli.commands.knowledge.search.command import knowledge_search_command
+from cli.commands.knowledge.synthesis.create.command import (
+    knowledge_synthesis_create_command,
+)
+from cli.commands.knowledge.synthesis.delete.command import (
+    knowledge_synthesis_delete_command,
+)
+from cli.commands.knowledge.synthesis.get.command import (
+    knowledge_synthesis_get_command,
+)
+from cli.commands.knowledge.synthesis.list.command import (
+    knowledge_synthesis_list_command,
+)
+from cli.commands.knowledge.synthesis.refresh.command import (
+    knowledge_synthesis_refresh_command,
+)
+from cli.commands.tool_configs.create.command import tool_configs_create_command
+from cli.commands.tool_configs.delete.command import tool_configs_delete_command
+from cli.commands.tool_configs.get.command import tool_configs_get_command
+from cli.commands.tool_configs.list.command import tool_configs_list_command
+from cli.commands.tool_configs.update.command import tool_configs_update_command
+from cli.commands.pipelines.list.command import pipelines_list_command
+from cli.commands.pipelines.get.command import pipelines_get_command
+from cli.commands.pipelines.execute.command import pipelines_execute_command
+from cli.commands.pipelines.executions.list_command import (
+    pipelines_executions_list_command,
+)
+from cli.commands.pipelines.executions.get_command import (
+    pipelines_executions_get_command,
+)
+from cli.commands.pipelines.schedules.list_command import (
+    pipelines_schedules_list_command,
+)
+from cli.commands.pipelines.schedules.get_command import pipelines_schedules_get_command
+from cli.commands.pipelines.schedules.delete_command import (
+    pipelines_schedules_delete_command,
+)
+from cli.commands.pipelines.costs.command import pipelines_costs_command
+from cli.commands.pipelines.approvals.get_command import (
+    pipelines_approvals_get_command,
+)
+from cli.commands.pipelines.approvals.decide_command import (
+    pipelines_approvals_decide_command,
+)
+from cli.commands.pipelines.executions.rerun_command import (
+    pipelines_executions_rerun_command,
+)
+from cli.commands.pipelines.costs.daily_command import pipeline_costs_daily_command
+from cli.commands.sessions.list.command import sessions_list_command
+from cli.commands.sessions.get.command import sessions_get_command
+from cli.commands.sessions.delete.command import sessions_delete_command
+from cli.commands.sessions.messages.command import sessions_messages_command
+from cli.commands.tags.list.command import tags_list_command
+from cli.commands.tags.create.command import tags_create_command
+from cli.commands.tags.delete.command import tags_delete_command
+from cli.infrastructure.config import load_config, set_global_overrides
+from cli.infrastructure.output import OutputFormat, OutputService
+from alloy_runtime_sdk.logging.config import LogConfig, LogFormat, LogLevel, configure
+from trogon.typer import init_tui
+
+console = Console()
+
+# Root CLI application
+# Note: no_args_is_help=False and invoke_without_command=True allows
+app = typer.Typer(
+    name="alloy",
+    help="Alloy Runtime CLI - Unified interface for AI orchestration. Run without arguments to launch TUI.",
+    no_args_is_help=False,
+    invoke_without_command=True,
+)
+
+
+@app.callback(invoke_without_command=True)
+def global_options(
+    ctx: typer.Context,
+    api_url: Optional[str] = typer.Option(
+        None,
+        "--api-url",
+        help="Override API URL",
+        envvar="ALLOY_RUNTIME_API_URL",
+    ),
+    api_key: Optional[str] = typer.Option(
+        None,
+        "--api-key",
+        help="Override API key",
+        envvar="ALLOY_RUNTIME_API_KEY",
+    ),
+    output_format: str = typer.Option(
+        "compact",
+        "--format",
+        help="Output format: compact, json, lines",
+    ),
+    no_tui: bool = typer.Option(
+        False,
+        "--no-tui",
+        help="Show CLI help instead of TUI",
+    ),
+) -> None:
+    """Global options for all commands.
+
+    Run with no arguments to launch TUI, or use --no-tui for CLI help.
+    """
+    # Store global overrides for load_config to use
+    set_global_overrides(api_url=api_url, api_key=api_key)
+
+    # Configure output format globally
+    format_lower = output_format.lower()
+    if format_lower == "json":
+        OutputService.configure(OutputFormat.JSON)
+    elif format_lower == "lines":
+        OutputService.configure(OutputFormat.LINES)
+    else:
+        # Default: compact (copy-friendly 2-line blocks)
+        OutputService.configure(OutputFormat.COMPACT)
+
+    # If no subcommand is invoked, launch TUI or show help
+    if ctx.invoked_subcommand is None:
+        if no_tui:
+            # Show help instead of launching TUI
+            console.print(ctx.get_help())
+            raise typer.Exit()
+
+        # Launch the unified TUI application
+        _launch_tui()
+        raise typer.Exit()
+
+
+def _launch_tui() -> None:
+    """Launch the unified Terminal UI application."""
+    from cli.tui.app import run_app
+
+    try:
+        config = load_config()
+    except Exception as e:
+        console.print(f"[red]Configuration error:[/] {e}")
+        console.print("\n[dim]Run 'ai2 login' to authenticate first.[/]")
+        raise typer.Exit(code=1)
+
+    if not config.api_key:
+        console.print("[red]Not authenticated.[/]")
+        console.print("\n[dim]Run 'ai2 login' to authenticate first.[/]")
+        raise typer.Exit(code=1)
+
+    run_app(api_url=config.api_url, api_key=config.api_key)
+
+
+# Register top-level auth commands for convenience
+app.command("login")(login_command)
+app.command("signup")(signup_command)
+app.command("whoami")(whoami_command)
+
+# Credentials command group
+credentials_app = typer.Typer(
+    help="Manage AI provider credentials",
+    no_args_is_help=True,
+)
+
+# Register credentials group with main app
+app.add_typer(credentials_app, name="credentials")
+app.add_typer(credentials_app, name="creds")  # Alias
+
+# Register credential commands
+credentials_app.command("create")(credentials_create_command)
+credentials_app.command("update")(credentials_update_command)
+
+# Sync command group
+sync_app = typer.Typer(
+    help="Sync data from external sources",
+    no_args_is_help=True,
+)
+
+# Register sync group with main app
+app.add_typer(sync_app, name="sync")
+
+# Register sync commands
+sync_app.command("models")(sync_command)
+
+# Models command group
+models_app = typer.Typer(
+    help="List and query AI models",
+    no_args_is_help=True,
+)
+
+# Register models group with main app
+app.add_typer(models_app, name="models")
+
+# Register model commands
+models_app.command("list")(models_list_command)
+
+# ========================================
+# Admin group (system administration)
+# ========================================
+admin_app = typer.Typer(
+    name="admin",
+    help="System administration commands (requires system admin privileges)",
+    no_args_is_help=True,
+)
+
+# Register admin group with main app
+app.add_typer(admin_app, name="admin")
+
+# Register admin commands
+admin_app.command("bootstrap")(bootstrap_admin_command)
+
+# Admin credentials subgroup
+admin_credentials_app = typer.Typer(
+    help="Manage system credentials",
+    no_args_is_help=True,
+)
+
+# Register admin credentials subgroup
+admin_app.add_typer(admin_credentials_app, name="credentials")
+admin_app.add_typer(admin_credentials_app, name="creds")  # Alias
+
+# Register admin credentials commands
+admin_credentials_app.command("create")(admin_credentials_create_command)
+admin_credentials_app.command("grant")(admin_credentials_grant_command)
+
+# Agents command group
+agents_app = typer.Typer(
+    help="Manage AI agents",
+    no_args_is_help=True,
+)
+
+# Register agents group with main app
+app.add_typer(agents_app, name="agents")
+
+# Register agent commands
+agents_app.command("create")(agents_create_command)
+agents_app.command("delete")(agents_delete_command)
+agents_app.command("list")(agents_list_command)
+agents_app.command("update")(agents_update_command)
+agents_app.command("get")(agents_get_command)
+
+# Templates command group
+templates_app = typer.Typer(
+    help="Manage templates (system instructions, user messages, fragments)",
+    no_args_is_help=True,
+)
+
+# Register templates group with main app
+app.add_typer(templates_app, name="templates")
+app.add_typer(templates_app, name="tpl")  # Alias
+
+# Register template commands
+templates_app.command("create")(templates_create_command)
+templates_app.command("delete")(templates_delete_command)
+templates_app.command("get")(templates_get_command)
+templates_app.command("list")(templates_list_command)
+templates_app.command("render")(templates_render_command)
+templates_app.command("update")(templates_update_command)
+templates_app.command("version")(templates_version_command)
+templates_app.command("get-by-version")(templates_get_by_version_command)
+
+# Generate command group
+generate_app = typer.Typer(
+    help="Generate AI content (text, images, etc.)",
+    no_args_is_help=True,
+)
+
+# Register generate group with main app
+app.add_typer(generate_app, name="generate")
+app.add_typer(generate_app, name="gen")  # Alias
+
+# Register generate commands
+generate_app.command("text")(generate_text_command)
+generate_app.command("status")(generate_status_command)
+generate_app.command("cancel")(generate_cancel_command)
+
+# Content command group
+content_app = typer.Typer(
+    help="Query and manage AI-generated content parts",
+    no_args_is_help=True,
+)
+
+# Register content group with main app
+app.add_typer(content_app, name="content")
+
+# Register content commands
+content_app.command("list")(content_list_command)
+content_app.command("get")(content_get_command)
+content_app.command("edit")(content_edit_command)
+content_app.command("delete")(content_delete_command)
+
+# Schemas command group
+schemas_app = typer.Typer(
+    help="Manage input/output validation schemas",
+    no_args_is_help=True,
+)
+
+# Register schemas group with main app
+app.add_typer(schemas_app, name="schemas")
+
+# Register schema commands
+schemas_app.command("create")(schemas_create_command)
+schemas_app.command("get")(schemas_get_command)
+schemas_app.command("list")(schemas_list_command)
+schemas_app.command("update")(schemas_update_command)
+schemas_app.command("delete")(schemas_delete_command)
+
+# Render command group
+render_app = typer.Typer(
+    help="Render content to various formats (HTML to image, etc.)",
+    no_args_is_help=True,
+)
+
+# Register render group with main app
+app.add_typer(render_app, name="render")
+
+# Register render commands
+render_app.command("image")(render_html_to_image_command)
+
+# Knowledge command group
+knowledge_app = typer.Typer(
+    help="Manage knowledge collections and documents",
+    no_args_is_help=True,
+)
+
+# Register knowledge group with main app
+app.add_typer(knowledge_app, name="knowledge")
+app.add_typer(knowledge_app, name="kb")  # Alias
+
+# Knowledge collections subgroup
+knowledge_collections_app = typer.Typer(
+    help="Manage document collections",
+    no_args_is_help=True,
+)
+
+# Register collections subgroup with knowledge app
+knowledge_app.add_typer(knowledge_collections_app, name="collections")
+
+# Register knowledge collection commands
+knowledge_collections_app.command("create")(knowledge_collections_create_command)
+knowledge_collections_app.command("delete")(knowledge_collections_delete_command)
+knowledge_collections_app.command("get")(knowledge_collections_get_command)
+knowledge_collections_app.command("list")(knowledge_collections_list_command)
+knowledge_collections_app.command("update")(knowledge_collections_update_command)
+knowledge_collections_app.command("cluster")(knowledge_collections_cluster_command)
+knowledge_collections_app.command("cluster-status")(
+    knowledge_collections_cluster_status_command
+)
+
+# Knowledge documents subgroup
+knowledge_documents_app = typer.Typer(
+    help="Manage documents in collections",
+    no_args_is_help=True,
+)
+
+# Register documents subgroup with knowledge app
+knowledge_app.add_typer(knowledge_documents_app, name="documents")
+
+# Register knowledge document commands
+knowledge_documents_app.command("delete")(knowledge_documents_delete_command)
+knowledge_documents_app.command("get")(knowledge_documents_get_command)
+knowledge_documents_app.command("ingest")(knowledge_documents_ingest_command)
+knowledge_documents_app.command("list")(knowledge_documents_list_command)
+knowledge_documents_app.command("update")(knowledge_documents_update_command)
+knowledge_documents_app.command("reingest")(knowledge_documents_reingest_command)
+knowledge_documents_app.command("bulk-metadata")(
+    knowledge_documents_bulk_metadata_command
+)
+
+# Knowledge synthesis subgroup
+knowledge_synthesis_app = typer.Typer(
+    help="Manage corpus-level syntheses",
+    no_args_is_help=True,
+)
+
+# Register synthesis subgroup with knowledge app
+knowledge_app.add_typer(knowledge_synthesis_app, name="synthesis")
+
+# Register knowledge synthesis commands
+knowledge_synthesis_app.command("create")(knowledge_synthesis_create_command)
+knowledge_synthesis_app.command("delete")(knowledge_synthesis_delete_command)
+knowledge_synthesis_app.command("get")(knowledge_synthesis_get_command)
+knowledge_synthesis_app.command("list")(knowledge_synthesis_list_command)
+knowledge_synthesis_app.command("refresh")(knowledge_synthesis_refresh_command)
+knowledge_synthesis_app.command("update")(knowledge_synthesis_update_command)
+
+# Register top-level knowledge commands
+knowledge_app.command("recover")(knowledge_recover_command)
+knowledge_app.command("search")(knowledge_search_command)
+
+# Tool configs command group
+tool_configs_app = typer.Typer(
+    help="Manage reusable tool configurations",
+    no_args_is_help=True,
+)
+
+# Register tool-configs group with main app
+app.add_typer(tool_configs_app, name="tool-configs")
+app.add_typer(tool_configs_app, name="tc")  # Alias
+
+# Register tool-configs commands
+tool_configs_app.command("create")(tool_configs_create_command)
+tool_configs_app.command("delete")(tool_configs_delete_command)
+tool_configs_app.command("get")(tool_configs_get_command)
+tool_configs_app.command("list")(tool_configs_list_command)
+tool_configs_app.command("update")(tool_configs_update_command)
+
+# Pipelines command group
+pipelines_app = typer.Typer(
+    help="Manage and execute pipelines",
+    no_args_is_help=True,
+)
+
+# Register pipelines group with main app
+app.add_typer(pipelines_app, name="pipelines")
+app.add_typer(pipelines_app, name="pipe")  # Alias
+
+# Register pipeline commands
+pipelines_app.command("list")(pipelines_list_command)
+pipelines_app.command("get")(pipelines_get_command)
+pipelines_app.command("execute")(pipelines_execute_command)
+pipelines_app.command("costs")(pipelines_costs_command)
+pipelines_app.command("costs-daily")(pipeline_costs_daily_command)
+pipelines_app.command("create")(pipelines_create_command)
+pipelines_app.command("env")(pipelines_env_vars_command)
+
+# Pipelines executions subgroup
+pipelines_executions_app = typer.Typer(
+    help="Manage pipeline executions",
+    no_args_is_help=True,
+)
+
+# Register executions subgroup with pipelines app
+pipelines_app.add_typer(pipelines_executions_app, name="executions")
+pipelines_app.add_typer(pipelines_executions_app, name="exec")  # Alias
+
+# Register pipeline execution commands
+pipelines_executions_app.command("list")(pipelines_executions_list_command)
+pipelines_executions_app.command("get")(pipelines_executions_get_command)
+pipelines_executions_app.command("rerun")(pipelines_executions_rerun_command)
+pipelines_executions_app.command("update")(pipeline_execution_update_command)
+pipelines_executions_app.command("costs")(pipeline_execution_costs_command)
+pipelines_executions_app.command("costs-by-model")(
+    pipeline_execution_costs_by_model_command
+)
+pipelines_executions_app.command("costs-by-step")(
+    pipeline_execution_costs_by_step_command
+)
+
+# Pipelines schedules subgroup
+pipelines_schedules_app = typer.Typer(
+    help="Manage pipeline schedules",
+    no_args_is_help=True,
+)
+
+# Register schedules subgroup with pipelines app
+pipelines_app.add_typer(pipelines_schedules_app, name="schedules")
+pipelines_app.add_typer(pipelines_schedules_app, name="sched")  # Alias
+
+# Register pipeline schedule commands
+pipelines_schedules_app.command("list")(pipelines_schedules_list_command)
+pipelines_schedules_app.command("get")(pipelines_schedules_get_command)
+pipelines_schedules_app.command("delete")(pipelines_schedules_delete_command)
+pipelines_schedules_app.command("env")(pipelines_schedules_env_vars_command)
+pipelines_schedules_app.command("create")(pipelines_schedules_create_command)
+pipelines_schedules_app.command("update")(pipelines_schedules_update_command)
+pipelines_schedules_app.command("once")(pipelines_schedules_once_command)
+
+
+# Pipelines approvals subgroup
+pipelines_approvals_app = typer.Typer(
+    help="Manage approval checkpoints for human-in-the-loop pipelines",
+    no_args_is_help=True,
+)
+
+# Register approvals subgroup with pipelines app
+pipelines_app.add_typer(pipelines_approvals_app, name="approvals")
+
+# Register pipeline approval commands
+pipelines_approvals_app.command("get")(pipelines_approvals_get_command)
+pipelines_approvals_app.command("decide")(pipelines_approvals_decide_command)
+
+# Sessions command group
+sessions_app = typer.Typer(
+    help="Manage chat sessions",
+    no_args_is_help=True,
+)
+
+# Register sessions group with main app
+app.add_typer(sessions_app, name="sessions")
+
+# Register session commands
+sessions_app.command("list")(sessions_list_command)
+sessions_app.command("get")(sessions_get_command)
+sessions_app.command("delete")(sessions_delete_command)
+sessions_app.command("messages")(sessions_messages_command)
+
+# Tags command group
+tags_app = typer.Typer(
+    help="Manage tags for organizing content",
+    no_args_is_help=True,
+)
+
+# Register tags group with main app
+app.add_typer(tags_app, name="tags")
+
+# Register tag commands
+tags_app.command("list")(tags_list_command)
+tags_app.command("create")(tags_create_command)
+tags_app.command("delete")(tags_delete_command)
+tags_app.command("get")(tags_get_command)
+tags_app.command("update")(tags_update_command)
+
+# Billing command group
+billing_app = typer.Typer(
+    help="Manage billing projects and costs",
+    no_args_is_help=True,
+)
+
+app.add_typer(billing_app, name="billing")
+app.add_typer(billing_app, name="bill")  # Alias
+
+# Billing projects subgroup
+billing_projects_app = typer.Typer(
+    help="Manage billing projects",
+    no_args_is_help=True,
+)
+
+billing_app.add_typer(billing_projects_app, name="projects")
+
+billing_projects_app.command("create")(billing_projects_create_command)
+billing_projects_app.command("list")(billing_projects_list_command)
+billing_projects_app.command("get")(billing_projects_get_command)
+
+# Billing costs subgroup
+billing_costs_app = typer.Typer(
+    help="View billing costs",
+    no_args_is_help=True,
+)
+
+billing_app.add_typer(billing_costs_app, name="costs")
+
+billing_costs_app.command("summary")(billing_costs_summary_command)
+billing_costs_app.command("daily")(billing_costs_daily_command)
+billing_costs_app.command("by-agent")(billing_costs_by_agent_command)
+billing_costs_app.command("by-model")(billing_costs_by_model_command)
+
+# Tools command group
+tools_app = typer.Typer(
+    help="List and inspect available tools",
+    no_args_is_help=True,
+)
+
+app.add_typer(tools_app, name="tools")
+app.add_typer(tools_app, name="tool")  # Alias
+
+tools_app.command("list")(tools_list_command)
+tools_app.command("get")(tools_get_command)
+
+# Audio command group
+audio_app = typer.Typer(
+    help="Audio processing commands",
+    no_args_is_help=True,
+)
+
+app.add_typer(audio_app, name="audio")
+app.add_typer(audio_app, name="aud")  # Alias
+
+audio_app.command("transcribe")(audio_transcribe_command)
+
+# Organizations command group
+organizations_app = typer.Typer(
+    help="Manage organizations",
+    no_args_is_help=True,
+)
+
+app.add_typer(organizations_app, name="organizations")
+app.add_typer(organizations_app, name="org")  # Alias
+
+organizations_app.command("create")(organizations_create_command)
+
+# Users command group
+users_app = typer.Typer(
+    help="Manage users",
+    no_args_is_help=True,
+)
+
+app.add_typer(users_app, name="users")
+app.add_typer(users_app, name="user")  # Alias
+
+users_app.command("create")(users_create_command)
+
+
+init_tui(app)
+
+
+def main() -> None:
+    """CLI entry point."""
+    # Configure logging for CLI (logs to file, Rich console for user output)
+    log_level_str = os.environ.get("LOG_LEVEL", "warning").lower()
+    log_level = LogLevel(log_level_str)
+
+    # Determine log file path - use root logs directory
+    # From cli/main.py -> cli -> packages -> core-service
+    project_root = Path(__file__).parent.parent.parent.parent
+    log_dir = project_root / "logs"
+    log_file = log_dir / "cli.log"
+
+    configure(
+        LogConfig(
+            level=log_level,
+            format=LogFormat.JSON,  # Always JSON for parsability
+            service_name="alloy-runtime-cli",
+            output_file=str(log_file),
+            capture_stdlib_logging=True,
+        )
+    )
+
+    app()
+
+
+if __name__ == "__main__":
+    main()