bat-cli 0.1.0__py3-none-any.whl

add/__init__.py

@@ -0,0 +1,3 @@
+from .client import add_clients_to_existing_agent
+
+__all__ = ["add_clients_to_existing_agent"]

add/client.py

@@ -0,0 +1,16 @@
+from pathlib import Path
+from create.agent import _write_llm_clients
+
+def add_clients_to_existing_agent(
+    agent_dir: Path,
+    *,
+    clients: list[str],
+    force: bool = False,
+) -> list[Path]:
+    llm_clients_dir = agent_dir / "src" / "llm_clients"
+    if not llm_clients_dir.is_dir():
+        raise FileNotFoundError(
+            f"Directory '{llm_clients_dir}' not found. Run this command from an agent root containing src/llm_clients."
+        )
+
+    return _write_llm_clients(llm_clients_dir, clients=clients, force=force)

bat_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: bat-cli
+Version: 0.1.0
+Summary: CLI tool to interact with BAT agents
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.3
+Requires-Dist: bat-adk>=2026.06rc1
+Requires-Dist: bat-adk[openai]
+Requires-Dist: a2a-sdk>=1.0.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: typing-extensions>=4.12.0
+Requires-Dist: matplotlib>=3.8
+
+# bat-cli
+
+A CLI tool for creating, building, and evaluating BAT agent projects.
+
+## Prerequisites
+
+- Python and [uv](https://docs.astral.sh/uv/) installed
+- Docker installed (required for `bat build` and `bat push`)
+- For evaluation commands: an existing BAT agent root containing `agent.json`, `config.yaml`, and `src/graph.py`
+
+---
+
+## Installation
+
+### Option A — build and install a standalone binary (Linux/macOS)
+
+Run the helper script from the repo root:
+
+```bash
+bash cli/build_and_install.sh
+```
+
+This will:
+
+1. Sync `dev` and `packaging` dependency groups via `uv`.
+2. Build a one-file executable with PyInstaller.
+3. Move it to `~/.local/bin/bat` (uses `sudo` only when necessary).
+
+Make sure `~/.local/bin` is in your `PATH`:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc
+source ~/.bashrc
+```
+
+Then verify:
+
+```bash
+bat --help
+```
+
+### Option B — build manually
+
+```bash
+uv sync --group dev --group packaging
+uv run pyinstaller --clean --noconfirm bat_cli.spec
+# binary is at dist/bat (Linux/macOS) or dist/bat.exe (Windows)
+```
+
+On **Windows**, copy `dist/bat.exe` to a folder on your `PATH` (e.g. `C:\tools\bat`) and open a new terminal.
+
+> PyInstaller builds are OS-specific — build on each target OS.
+
+### Option C — run without installing (development)
+
+```bash
+uv sync --group dev
+uv run bat --help
+```
+
+All examples below show `bat ...`; replace with `uv run bat ...` when using this option.
+
+---
+
+## Command Tree
+
+```
+bat
+├── init
+│   └── agent
+│       ├── [name=default]
+│       ├── --clients, -c
+│       ├── --output-dir, -o
+│       ├── --force, -f
+│       ├── --port
+│       ├── --model
+│       └── --model-provider
+├── add
+│   └── client
+│       ├── <clients>
+│       └── --force, -f
+├── set
+│   └── env
+│       ├── --port
+│       ├── --model
+│       ├── --model-provider
+│       ├── --docker-registry
+│       └── --repo
+├── eval
+│   ├── init
+│   │   └── --force, -f
+│   └── run
+├── build
+│   ├── --context, -C
+│   ├── --docker-registry
+│   ├── --repo
+│   ├── --tag
+│   ├── --version
+│   └── --no-cache
+└── push
+    ├── --context, -C
+    ├── --docker-registry
+    ├── --repo
+    └── --tag
+```
+
+Built-in help is available at every level:
+
+```bash
+bat --help
+bat init agent --help
+bat build --help
+```
+
+---
+
+## Workflows
+
+### 1. Create a new agent
+
+```bash
+# default name
+bat init agent
+
+# custom name
+bat init agent my_agent
+
+# specific output directory
+bat init agent my_agent --output-dir .
+
+# pre-generate LLM clients
+bat init agent my_agent --clients reformulator,planner,executor
+```
+
+### 2. Add clients to an existing agent
+
+Run from the agent root (must contain `src/llm_clients/`):
+
+```bash
+bat add client planner,executor
+
+# overwrite existing files
+bat add client planner,executor --force
+```
+
+### 3. Update agent environment variables
+
+Run from the agent root (updates or creates `.env`):
+
+```bash
+bat set env --port 8080 --model gpt-4.1-mini --model-provider openai
+
+# also set Docker defaults for build/push
+bat set env --docker-registry hub.bubbleran.com --repo orama/labs/my-agent
+```
+
+### 4. Build and push a Docker image
+
+```bash
+bat build --context ./my_agent --docker-registry hub.bubbleran.com --repo orama/labs/my-agent --tag latest
+
+# no-cache build with version build-arg
+bat build --context ./my_agent --repo orama/labs/my-agent --tag v1 --version 1.0.0 --no-cache
+
+bat push --context ./my_agent --docker-registry hub.bubbleran.com --repo orama/labs/my-agent --tag latest
+```
+
+If `BAT_DOCKER_REGISTRY` and `BAT_DOCKER_REPO` are already set in `.env` or the shell, `--docker-registry` and `--repo` can be omitted.
+
+**Precedence** (both `--docker-registry` / `--repo`):
+
+1. CLI flag
+2. Shell environment variable (`BAT_DOCKER_REGISTRY` / `BAT_DOCKER_REPO`)
+3. `.env` file in the current directory
+4. Hardcoded default (`default_registry` / `default-repository/<project-name>`)
+
+### 5. Run evaluation
+
+From an existing agent root:
+
+```bash
+# scaffold evaluation files
+bat eval init
+
+# run evaluation
+bat eval run
+```
+
+`eval init` creates:
+
+- `eval/eval.yaml`
+- `eval/input/tasks.json`
+- `eval/output/`
+
+Minimal `eval/eval.yaml`:
+
+```yaml
+evaluation:
+  dataset: eval/input/tasks.json
+  output_dir: eval/output
+  k: 1
+  qualitative: true
+  save_attempts: false
+
+judge:
+  provider: ollama
+  model: your-judge-model
+  base_url: http://localhost:11434
+
+models:
+  - provider: openai
+    model: your-model-name
+```
+
+`eval run` requires the agent virtual environment at `.venv/bin/python` (`.venv/Scripts/python.exe` on Windows).
+
+For model that requires API_KEYS set it into the agent `.env` under <PROVIDER>\_API_KEY.

bat_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+cli.py,sha256=ATKa5kPdme4zS4wiOGlwSd9qRInxb0qqF7fCzXar1sk,8145
+image_defaults.py,sha256=ItpLwN_gl7vVzM8Oyn_kxoAO-WtUFISBUYTHl2ZbheI,1807
+add/__init__.py,sha256=KSwafPATDdeoEYHARrXDC6c4NGVdqfGvuAbFg8RbqWQ,95
+add/client.py,sha256=dGEE7aw1FuALlLxOEGlIK4-EKAqMXYFNp_qtk60C09w,533
+build/__init__.py,sha256=FB47dgFX4B5bacfCeEKA_7b0Bhpe0bgbNd8Zu7572kA,58
+build/build.py,sha256=Zshd-Ymo8DjqnqvS8Fvbz3C4q28Mr0iePP4MdhxY2-U,2665
+create/__init__.py,sha256=KABTrX_9ly8gWVlaYU1m8PeLErUv0WDt5O1JB0Z4a40,78
+create/agent.py,sha256=IHpz8QL3iOBD_BOHBXT8rzC9U7BmfkbM5X9TGvnOlLw,9375
+create/templates/agent/.dockerignore,sha256=TK0TPU8KbPS7oV8bi7rkjWpV8guU91SHxRqTzGpa9Z8,26
+create/templates/agent/.env.template,sha256=7BKZIauBq77d5fMBoK1ePHqByipmk0RHl4D9utaNZTs,126
+create/templates/agent/.python-version,sha256=MzB9pWrxP3kVhFGP7y5JZBGAv78u97LSVsmrb61WT4A,4
+create/templates/agent/Dockerfile,sha256=rNbaEv6AG5UTFpZtmI4KDqYtV7Q_r3UM_zclnlmW3tk,716
+create/templates/agent/Makefile,sha256=CgAhJ2nbkPbjmUv4QIikjPsZDXUmVntIz-bKO_xBaBc,911
+create/templates/agent/README.md,sha256=I1MrCvRD2c7ER4PcoR5m11wNq6VL9CDYyhFgqSf0G44,20
+create/templates/agent/__main__.py,sha256=bXSrkOUtyAeb_mmaDAoFcc1iMOHbGy8CiUWttFu6cnQ,53
+create/templates/agent/agent.json.template,sha256=nprO37SgOJoyFVOZgxHDLPu43HlrI4pjxq6KNi2CqHw,236
+create/templates/agent/agent.spec,sha256=YQU-Qtv4I_1Knp7sZLVvdxy3O0PcxwOt4FtrRJ_CWYg,661
+create/templates/agent/config.yaml,sha256=5PnGziRDshBnIHPn5RiuvA1wa0SRgv1mAHwZpdEg_LQ,19
+create/templates/agent/llm_client.py.template,sha256=fAuIqVv5Fs8wlnyh0ZZsiiQgxsE859Kay82FHVXmiEw,974
+create/templates/agent/pyproject.toml.template,sha256=JUmq3CQhgEAcGv8GRokV5hPKNU2OP5KTLi2zKYyfiRc,196
+create/templates/agent/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+create/templates/agent/src/graph.py,sha256=CYHb2EIBRkT9QA7eV2HHSg3dHJWfBmx-DvR3IKyzJZg,1114
+create/templates/agent/src/llm_clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+create/templates/agent/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eval/__init__.py,sha256=Mx15-MKFaDtmsc9ubisr-wXH0Hs57YX0QTr7183xz0g,46
+eval/commands.py,sha256=FuVFrWC-rdU90Rame1MaQVXrgLOAr2nyplndeYuUB9U,18361
+eval/engine/__init__.py,sha256=8fEKHuy3Ud4ep4fw762uu51DV1SBj1xlonolmNcQbeY,56
+eval/engine/adapter.py,sha256=yynP98FRNx1LZgJme92cnCu6tE1sSBtd0mVgfoVRVIo,9303
+eval/engine/bench_runner.py,sha256=IhcB_cBTxEL0u05jFvcHB4P7Na_2lzU9lo3kJrX1Aoo,5130
+eval/engine/contracts.py,sha256=DAHpsD2x8x5_zuMQS9nKix8p4e9DltqMque26_7P9ug,3255
+eval/engine/eval_config.py,sha256=9S6LV_Wbk7Sry0nRXP9S8fs7yNMYkKNSoSamfDQM0Wc,9559
+eval/engine/evaluator.py,sha256=XZ2dmZS_VhjGTsISRf3twU3Iz9okDNU_PziCk1qqcE8,2877
+eval/engine/orchestrator.py,sha256=PrCDmEyngI0dciPXS9-qAUcPbqNgt3dTQ-I7CVJdweo,5330
+eval/engine/plotter.py,sha256=xdw1ppMOfI98yz5vEN4tZhQs8E-vnI7ORk-MKfjwiDU,15462
+eval/engine/metrics/__init__.py,sha256=JAVJTRLC2M2Hv41BcImXk_ZYgDb_z3JEHxkepXtce90,48
+eval/engine/metrics/llm_evaluators.py,sha256=Q9qy3usexnjzB8RZW-Mku63s_Ot7Jf1pZsmF_inGLNk,18080
+eval/engine/metrics/metrics.py,sha256=U3IAKQ2H_dvVGQArWS8OwuAcNBhcfVbjMXRydiz5VGc,4877
+eval/engine/metrics/qualitative_helpers.py,sha256=OYNehel5l8BAmbhXH4UxxQMdJC7cumK6kkFNG0HNIIA,2404
+push/__init__.py,sha256=2zzcgnvuK-xfH2ArR4jQHyIjIFUwvyNx2hEPD1zb4f0,55
+push/push.py,sha256=3cqwGL_JJc-cugM7QBTLr9Ud3-fen2TSJy4KHbG8CCs,1953
+set/__init__.py,sha256=e57CrZacOKMkzwII1VdYhxvBWF3Tt02_qw7c0BJ-Dt8,62
+set/env.py,sha256=mAuNfhXyji0ij0H2qdc-aIlPqYSE5lQlxpJ5IKF4UHc,1656
+bat_cli-0.1.0.dist-info/METADATA,sha256=JU4kguzwW8wiF3NAKz3FZIPQ_3WIfMIZzm9Za2CmI60,5266
+bat_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+bat_cli-0.1.0.dist-info/entry_points.txt,sha256=xsln8lLso51-g1XbUBxmAaFCNS1Hxlf611qrMLKYoxs,33
+bat_cli-0.1.0.dist-info/top_level.txt,sha256=JE51f0xnE-1CGdjBjVh7QrmCww9GcHSj7EjzzaoBi8E,50
+bat_cli-0.1.0.dist-info/RECORD,,

bat_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bat_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bat = cli:main

bat_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,8 @@
+add
+build
+cli
+create
+eval
+image_defaults
+push
+set

build/__init__.py

@@ -0,0 +1,3 @@
+from .build import build_image
+
+__all__ = ["build_image"]

build/build.py

@@ -0,0 +1,79 @@
+import subprocess
+from pathlib import Path
+
+import typer
+
+from image_defaults import resolve_registry, resolve_repo_name
+
+
+def build_image(
+    context: Path = typer.Option(
+        Path("."),
+        "--context",
+        "-C",
+        help="Directory used as docker build context and to infer the default repository name.",
+    ),
+    docker_registry: str | None = typer.Option(
+        None,
+        "--docker-registry",
+        help=(
+            "Docker registry hostname. Precedence: --docker-registry > "
+            "BAT_DOCKER_REGISTRY env var (or .env in current directory) > default_registry."
+        ),
+    ),
+    repo: str | None = typer.Option(
+        None,
+        "--repo",
+        help=(
+            "Image repository path. Precedence: --repo > BAT_DOCKER_REPO env var "
+            "(or .env in current directory) > default-repository/<project-name>."
+        ),
+    ),
+    tag: str = typer.Option(
+        "latest",
+        "--tag",
+        help="Image tag.",
+    ),
+    version: str | None = typer.Option(
+        None,
+        "--version",
+        help="Optional VERSION build arg passed to docker build.",
+    ),
+    no_cache: bool = typer.Option(
+        False,
+        "--no-cache",
+        help="Disable docker layer cache during build.",
+    ),
+) -> None:
+    context_dir = context.resolve()
+    if not context_dir.is_dir():
+        typer.secho(f"Context directory not found: {context_dir}", fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=1)
+
+    dockerfile_path = context_dir / "Dockerfile"
+    if not dockerfile_path.is_file():
+        typer.secho(f"Dockerfile not found in context: {dockerfile_path}", fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=1)
+
+    resolved_registry = resolve_registry(context_dir, docker_registry)
+    resolved_repo = resolve_repo_name(context_dir, repo)
+    image = f"{resolved_registry}/{resolved_repo}:{tag}"
+
+    command = ["docker", "build"]
+    if no_cache:
+        command.append("--no-cache")
+    if version:
+        command.extend(["--build-arg", f"VERSION={version}"])
+    command.extend(["--tag", image, "."])
+
+    typer.echo(f"Building Docker image: {image}")
+    try:
+        subprocess.run(command, check=True, cwd=context_dir)
+    except FileNotFoundError as exc:
+        typer.secho("Docker executable not found in PATH.", fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=1) from exc
+    except subprocess.CalledProcessError as exc:
+        typer.secho("Docker build failed.", fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=exc.returncode or 1) from exc
+
+    typer.secho(f"Docker image built successfully: {image}", fg=typer.colors.GREEN)

cli.py

@@ -0,0 +1,260 @@
+import shutil
+import subprocess
+from pathlib import Path
+
+import click
+import typer
+from typer.core import TyperGroup
+
+from add.client import add_clients_to_existing_agent
+from build.build import build_image
+from create.agent import create_agent_scaffold
+from eval.commands import eval_init, eval_plot, eval_run, eval_show
+from push.push import push_image
+from set.env import set_env_values
+
+
+_BANNER_COLORS = (51, 45, 39, 63, 99, 135)
+
+_FALLBACK_BANNER = r"""
+ ____    _  _____    ____ _     ___
+| __ )  / \|_   _|  / ___| |   |_ _|
+|  _ \ / _ \ | |   | |   | |    | |
+| |_) / ___ \| |   | |___| |___ | |
+|____/_/   \_\_|    \____|_____|___|
+"""
+
+_BANNER_MOTD = """
+Welcome to BubbleRAN Agentic Toolkit CLI tool.
+
+Scaffold, build, push, and evaluate BAT agents from one place.
+
+"""
+
+
+def _figlet_banner(text: str) -> str | None:
+    if shutil.which("figlet") is None:
+        return None
+    try:
+        return subprocess.check_output(
+            ["figlet", "-f", "standard", text],
+            text=True,
+            stderr=subprocess.DEVNULL,
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+
+
+def _colorize_line(line: str) -> str:
+    n = len(line)
+    if n == 0:
+        return ""
+    palette = _BANNER_COLORS
+    pieces = []
+    for i, ch in enumerate(line):
+        idx = min(int(i * len(palette) / n), len(palette) - 1)
+        pieces.append(f"\033[38;5;{palette[idx]}m{ch}")
+    pieces.append("\033[0m")
+    return "".join(pieces)
+
+
+def _render_banner() -> str:
+    art = _figlet_banner("BAT-CLI") or _FALLBACK_BANNER
+    colored = "\n".join(_colorize_line(line) for line in art.splitlines())
+    return f"{colored}\n{_BANNER_MOTD}"
+
+
+class BannerGroup(TyperGroup):
+    def format_help(self, ctx, formatter):
+        click.echo(_render_banner().rstrip("\n") + "\n", nl=False)
+        super().format_help(ctx, formatter)
+
+
+app = typer.Typer(
+    cls=BannerGroup
+)
+init_app = typer.Typer(help="Create new BAT resources.")
+add_app = typer.Typer(help="Add new components to existing BAT agents.")
+set_app = typer.Typer(help="Set configuration values for existing BAT agents.")
+eval_app = typer.Typer(help="Run local evaluation workflows for existing BAT agents.")
+
+app.add_typer(init_app, name="init")
+app.add_typer(add_app, name="add")
+app.add_typer(set_app, name="set")
+app.add_typer(eval_app, name="eval")
+app.command("build", help="Build the Docker image for the agent.")(build_image)
+app.command("push", help="Push the Docker image to a registry.")(push_image)
+eval_app.command("init", help="Initialize local evaluation scaffold.")(eval_init)
+eval_app.command("run", help="Run evaluation using eval/eval.yaml.")(eval_run)
+eval_app.command("show", help="Show the resolved evaluation configuration.")(eval_show)
+eval_app.command("plot", help="Generate metric charts from an evaluation output folder.")(eval_plot)
+
+
+def _parse_clients_option(raw_clients: str | None) -> list[str] | None:
+    if raw_clients is None:
+        return None
+    parsed_clients = [client.strip() for client in raw_clients.split(",") if client.strip()]
+    if not parsed_clients:
+        raise typer.BadParameter("Provide at least one client name, for example: reformulator,planner,executor")
+    return parsed_clients
+
+
+@init_app.command("agent")
+def create_new_agent(
+    name: str = typer.Argument("default", help="Name of the agent directory to create."),
+    clients: str | None = typer.Option(
+        None,
+        "--clients",
+        "-c",
+        help="Optional comma-separated LLM client names to generate, for example: reformulator,planner,executor",
+    ),
+    output_dir: Path = typer.Option(
+        Path("."),
+        "--output-dir",
+        "-o",
+        help="Directory where the agent folder will be created.",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing files when the target directory exists. Use with caution as this will delete existing files in the target directory.",
+    ),
+    port: int = typer.Option(
+        9900,
+        "--port",
+        help="Port value written to .env.",
+    ),
+    model: str = typer.Option(
+        "gpt-4o-mini",
+        "--model",
+        help="Model value written to .env.",
+    ),
+    model_provider: str = typer.Option(
+        "openai",
+        "--model-provider",
+        "--model_provider",
+        help="Model provider value written to .env.",
+    ),
+) -> None:
+    target_dir = output_dir / name
+    parsed_clients = _parse_clients_option(clients)
+
+    try:
+        created_files = create_agent_scaffold(
+            target_dir,
+            force=force,
+            clients=parsed_clients,
+            port=port,
+            model=model,
+            model_provider=model_provider,
+        )
+    except FileExistsError as exc:
+        typer.secho(str(exc), fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=1) from exc
+
+    typer.secho(f"Created BAT agent skeleton in: {target_dir.resolve()}", fg=typer.colors.GREEN)
+    typer.echo(f"Files written: {len(created_files)}")
+
+@add_app.command("client")
+def add_new_client(
+    clients: str = typer.Argument(
+        ...,
+        help="Comma-separated LLM client names to generate, for example: reformulator,planner,executor",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing client files if they already exist. Use with caution as this will delete existing client files with the same name.",
+    ),
+) -> None:
+    current_dir = Path.cwd()
+    llm_clients_dir = current_dir / "src" / "llm_clients"
+    if not llm_clients_dir.is_dir():
+        typer.secho(
+            "Current directory must contain src/llm_clients. Run this command from the root of an existing agent.",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    parsed_clients = _parse_clients_option(clients) or []
+    
+    try:
+        created_files = add_clients_to_existing_agent(current_dir, clients=parsed_clients, force=force)
+    except FileNotFoundError as exc:
+        typer.secho(str(exc), fg=typer.colors.RED, err=True)
+        raise typer.Exit(code=1) from exc
+
+    typer.secho(f"Updated LLM clients in: {llm_clients_dir.resolve()}", fg=typer.colors.GREEN)
+    typer.echo(f"Files written: {len(created_files)}")
+
+
+@set_app.command("env")
+def set_agent_env(
+    port: int | None = typer.Option(
+        None,
+        "--port",
+        help="Set PORT in .env.",
+    ),
+    model: str | None = typer.Option(
+        None,
+        "--model",
+        help="Set MODEL in .env.",
+    ),
+    model_provider: str | None = typer.Option(
+        None,
+        "--model-provider",
+        "--model_provider",
+        help="Set MODEL_PROVIDER in .env.",
+    ),
+    docker_registry: str | None = typer.Option(
+        None,
+        "--docker-registry",
+        help="Set BAT_DOCKER_REGISTRY in .env for build/push defaults.",
+    ),
+    repo: str | None = typer.Option(
+        None,
+        "--repo",
+        help="Set BAT_DOCKER_REPO in .env for build/push defaults.",
+    ),
+) -> None:
+    current_dir = Path.cwd()
+    env = current_dir / ".env"
+    if not env.is_file():
+        typer.secho(
+            "Current directory must contain .env. Run this command from the root of an existing agent.",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    if all(value is None for value in [port, model, model_provider, docker_registry, repo]):
+        typer.secho(
+            "Provide at least one option to set: --port, --model, --model-provider, --docker-registry, --repo",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    env_path, updated_keys = set_env_values(
+        current_dir,
+        port=port,
+        model=model,
+        model_provider=model_provider,
+        docker_registry=docker_registry,
+        repo=repo,
+    )
+
+    typer.secho(f"Updated env file: {env_path.resolve()}", fg=typer.colors.GREEN)
+    typer.echo(f"Keys updated: {', '.join(updated_keys)}")
+
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

create/__init__.py

@@ -0,0 +1,3 @@
+from .agent import create_agent_scaffold
+
+__all__ = ["create_agent_scaffold"]