lemming-cli 0.3.2__tar.gz → 0.3.4__tar.gz

{lemming_cli-0.3.2 → lemming_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lemming-cli
-Version: 0.3.2
+Version: 0.3.4
 Summary: An autonomous, iterative task runner for AI coding agents.
 Project-URL: Homepage, https://github.com/owahltinez/lemming
 Project-URL: Repository, https://github.com/owahltinez/lemming
@@ -247,13 +247,22 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 ### Roadmap Management
 
 - **`status [<id>]`**: Queue/history overview or deep-dive into a specific
-  task, including supersession lineage and runner/orchestrator-hook execution
-  times. Superseded and failed history stays visible in the default overview;
-  `--verbose` also shows routine completed/cancelled history.
+  task, including supersession lineage, the last resolved runner command, and
+  runner/orchestrator-hook execution times. Superseded and failed history
+  stays visible in the default overview; `--verbose` also shows routine
+  completed/cancelled history.
+  - `--json`: Emit machine-readable JSON instead of formatted text, so
+    scripts never have to parse the internal state file.
+  - `--brief`: Omit task descriptions, which otherwise dominate the output.
 - **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
   Supports `-f/--file`.
-- **`add <desc>`**: Append a new task. Supports `--index` and `--runner`.
-- **`edit <id>`**: Modify a task's description, runner, or position.
+- **`add <desc>`**: Append a new task. Supports `--index`, `--runner`, and
+  `--model`.
+- **`edit <id>`**: Modify a task's description, runner, model, or position.
+- **`brief <id> [text]`**: View or set a task's long-form brief. Unlike the
+  description it has no length cap, and it is appended to the runner prompt
+  automatically — the right home for measured timings, exact failing
+  selectors, or why a previous attempt was wrong. Supports `-f/--file`.
 - **`delete <id>`**: Remove an unstarted task while retaining its runner log.
   Tasks with execution history require `--force`; autonomous restructuring
   should use `supersede`. Supports `--all` and `--completed` for bulk cleanup,
@@ -265,9 +274,11 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
   - `add <id> <finding>`: Record a new technical detail.
   - `edit <id> <index> <text>`: Modify an existing progress entry.
   - `delete <id> <index>`: Remove a progress entry.
-- **`config`**: Manage project configuration (runner, retries).
+- **`config`**: Manage project configuration (runner, model, retries,
+  time limit).
   - `list`: View current configuration.
-  - `set <key> <value>`: Update a setting.
+  - `set <key> <value>`: Update a setting. `set model default` clears a
+    pinned model without touching the runner.
 - **`hooks`**: Manage orchestrator hooks.
   - `list`: View available and active hooks.
   - `install`: Install built-in hooks to the global directory.
@@ -295,6 +306,7 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 - **`logs [<id>]`**: Print a task's execution log to stdout, including retained
   logs for removed tasks. If no ID is provided, it defaults to the active or
   most recent task. Orchestrator hook output is automatically appended.
+  Supports `--json` to wrap the log with its task ID and path.
 
 ### Execution
 
@@ -303,7 +315,12 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
   - `--yolo`: Run the runner in auto-approve mode (default: True).
   - `--env`: Set environment variables for the runner (e.g., `--env KEY=VALUE`).
   - `--no-defaults`: Skip default flag injection for known runners.
-  - `--`: Use `--` to pass any flag directly to the underlying runner.
+  - `--`: Use `--` to pass any flag directly to the underlying runner. A
+    per-task `--runner`/`--model` overrides anything passed here.
+- **`stop`**: Stop the running loop and its runner.
+  - `--after-current-task`: Drain instead — let the running task finish, then
+    stop before claiming another. This is the safe way to change the runner
+    or model without stranding work in flight.
 - **`serve`**: Launch the interactive Web UI.
   - `--port`: The port to bind the server to (default: 8999).
   - `--host`: The host address to bind the server to (default: 127.0.0.1).
@@ -319,23 +336,60 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 Lemming uses **fuzzy matching** to automatically inject the correct "YOLO"
 (auto-approve) and "Quiet" flags for popular tools:
 
-- **Antigravity (`agy`)**: Adds `--dangerously-skip-permissions`
+- **Antigravity (`agy`)**: Adds `--dangerously-skip-permissions` and exposes
+  the project workspace with `--add-dir`
 - **Aider**: Adds `--yes --quiet`
 - **Claude**: Adds `--dangerously-skip-permissions`
 - **Codex**: Runs non-interactively via `codex exec`, adds `--json`, and, in
   YOLO mode, adds `--dangerously-bypass-approvals-and-sandbox`
 
+### Choosing a model
+
+The model is a first-class setting, separate from the runner, so switching
+provider does not silently discard it:
+
+```bash
+lemming config set model gemini-3.6-flash-high   # project default
+lemming add "Fix the flaky test" --model fast    # just this task
+lemming config set model default                 # let the runner decide
+```
+
+Precedence, highest first: an explicit `--model` inside a runner string, the
+task's `--model`, the project's `config model`, then anything passed after
+`lemming run --`. A per-task setting always wins over the loop-wide
+passthrough — the conflicting global flag is dropped rather than duplicated
+on the command line.
+
+### Runner strings
+
+A runner is not limited to a binary name: any extra arguments in the string
+are appended to the command, which is another way to pin per-task behaviour.
+
+```bash
+lemming add "Try the fast model" --runner "agy --model fast"
+```
+
 You can disable default flag injection with `--no-defaults` (`codex exec`
 remains the Codex execution interface), or use a **template** to fully control
 the command layout:
 
 ```bash
-lemming run --runner "my-tool --input={{prompt}} --json"
+lemming config set runner "my-tool --input={{prompt}} --json"
 ```
 
 When `{{prompt}}` is present in the runner string, Lemming replaces it with the
 prompt text and skips all default flag injection.
 
+### Knowing what actually ran
+
+Each attempt records the command it launched, with the prompt elided, so the
+runner and model behind a finished task stay recoverable:
+
+```bash
+lemming status <id>          # includes "Last Command:"
+lemming status --json        # same data, machine-readable
+```
+
 ---
 
 ## Releasing

{lemming_cli-0.3.2 → lemming_cli-0.3.4}/README.md

@@ -225,13 +225,22 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 ### Roadmap Management
 
 - **`status [<id>]`**: Queue/history overview or deep-dive into a specific
-  task, including supersession lineage and runner/orchestrator-hook execution
-  times. Superseded and failed history stays visible in the default overview;
-  `--verbose` also shows routine completed/cancelled history.
+  task, including supersession lineage, the last resolved runner command, and
+  runner/orchestrator-hook execution times. Superseded and failed history
+  stays visible in the default overview; `--verbose` also shows routine
+  completed/cancelled history.
+  - `--json`: Emit machine-readable JSON instead of formatted text, so
+    scripts never have to parse the internal state file.
+  - `--brief`: Omit task descriptions, which otherwise dominate the output.
 - **`goal [<text>]`**: Set or view the long-term goal shared by all tasks.
   Supports `-f/--file`.
-- **`add <desc>`**: Append a new task. Supports `--index` and `--runner`.
-- **`edit <id>`**: Modify a task's description, runner, or position.
+- **`add <desc>`**: Append a new task. Supports `--index`, `--runner`, and
+  `--model`.
+- **`edit <id>`**: Modify a task's description, runner, model, or position.
+- **`brief <id> [text]`**: View or set a task's long-form brief. Unlike the
+  description it has no length cap, and it is appended to the runner prompt
+  automatically — the right home for measured timings, exact failing
+  selectors, or why a previous attempt was wrong. Supports `-f/--file`.
 - **`delete <id>`**: Remove an unstarted task while retaining its runner log.
   Tasks with execution history require `--force`; autonomous restructuring
   should use `supersede`. Supports `--all` and `--completed` for bulk cleanup,
@@ -243,9 +252,11 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
   - `add <id> <finding>`: Record a new technical detail.
   - `edit <id> <index> <text>`: Modify an existing progress entry.
   - `delete <id> <index>`: Remove a progress entry.
-- **`config`**: Manage project configuration (runner, retries).
+- **`config`**: Manage project configuration (runner, model, retries,
+  time limit).
   - `list`: View current configuration.
-  - `set <key> <value>`: Update a setting.
+  - `set <key> <value>`: Update a setting. `set model default` clears a
+    pinned model without touching the runner.
 - **`hooks`**: Manage orchestrator hooks.
   - `list`: View available and active hooks.
   - `install`: Install built-in hooks to the global directory.
@@ -273,6 +284,7 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 - **`logs [<id>]`**: Print a task's execution log to stdout, including retained
   logs for removed tasks. If no ID is provided, it defaults to the active or
   most recent task. Orchestrator hook output is automatically appended.
+  Supports `--json` to wrap the log with its task ID and path.
 
 ### Execution
 
@@ -281,7 +293,12 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
   - `--yolo`: Run the runner in auto-approve mode (default: True).
   - `--env`: Set environment variables for the runner (e.g., `--env KEY=VALUE`).
   - `--no-defaults`: Skip default flag injection for known runners.
-  - `--`: Use `--` to pass any flag directly to the underlying runner.
+  - `--`: Use `--` to pass any flag directly to the underlying runner. A
+    per-task `--runner`/`--model` overrides anything passed here.
+- **`stop`**: Stop the running loop and its runner.
+  - `--after-current-task`: Drain instead — let the running task finish, then
+    stop before claiming another. This is the safe way to change the runner
+    or model without stranding work in flight.
 - **`serve`**: Launch the interactive Web UI.
   - `--port`: The port to bind the server to (default: 8999).
   - `--host`: The host address to bind the server to (default: 127.0.0.1).
@@ -297,23 +314,60 @@ See [docs/EVALS.md](docs/EVALS.md) for details.
 Lemming uses **fuzzy matching** to automatically inject the correct "YOLO"
 (auto-approve) and "Quiet" flags for popular tools:
 
-- **Antigravity (`agy`)**: Adds `--dangerously-skip-permissions`
+- **Antigravity (`agy`)**: Adds `--dangerously-skip-permissions` and exposes
+  the project workspace with `--add-dir`
 - **Aider**: Adds `--yes --quiet`
 - **Claude**: Adds `--dangerously-skip-permissions`
 - **Codex**: Runs non-interactively via `codex exec`, adds `--json`, and, in
   YOLO mode, adds `--dangerously-bypass-approvals-and-sandbox`
 
+### Choosing a model
+
+The model is a first-class setting, separate from the runner, so switching
+provider does not silently discard it:
+
+```bash
+lemming config set model gemini-3.6-flash-high   # project default
+lemming add "Fix the flaky test" --model fast    # just this task
+lemming config set model default                 # let the runner decide
+```
+
+Precedence, highest first: an explicit `--model` inside a runner string, the
+task's `--model`, the project's `config model`, then anything passed after
+`lemming run --`. A per-task setting always wins over the loop-wide
+passthrough — the conflicting global flag is dropped rather than duplicated
+on the command line.
+
+### Runner strings
+
+A runner is not limited to a binary name: any extra arguments in the string
+are appended to the command, which is another way to pin per-task behaviour.
+
+```bash
+lemming add "Try the fast model" --runner "agy --model fast"
+```
+
 You can disable default flag injection with `--no-defaults` (`codex exec`
 remains the Codex execution interface), or use a **template** to fully control
 the command layout:
 
 ```bash
-lemming run --runner "my-tool --input={{prompt}} --json"
+lemming config set runner "my-tool --input={{prompt}} --json"
 ```
 
 When `{{prompt}}` is present in the runner string, Lemming replaces it with the
 prompt text and skips all default flag injection.
 
+### Knowing what actually ran
+
+Each attempt records the command it launched, with the prompt elided, so the
+runner and model behind a finished task stay recoverable:
+
+```bash
+lemming status <id>          # includes "Last Command:"
+lemming status --json        # same data, machine-readable
+```
+
 ---
 
 ## Releasing

{lemming_cli-0.3.2 → lemming_cli-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lemming-cli"
-version = "0.3.2"
+version = "0.3.4"
 description = "An autonomous, iterative task runner for AI coding agents."
 readme = "README.md"
 authors = [

lemming_cli-0.3.4/src/lemming/brief_test.py

@@ -0,0 +1,106 @@
+"""Tests for the long-form task brief delivered alongside the description."""
+
+import pathlib
+import shutil
+import tempfile
+import unittest
+
+import click.testing
+
+from lemming import cli, models, paths, prompts, tasks
+
+EVIDENCE = "Measured: first paint 2.4s. The failing selector is [data-x=1]."
+
+
+class TestTaskBrief(unittest.TestCase):
+    def setUp(self):
+        self.cli_runner = click.testing.CliRunner()
+        self.test_dir = tempfile.mkdtemp()
+        self.tasks_file = pathlib.Path(self.test_dir) / "tasks.yml"
+        self.base_args = ["--tasks-file", str(self.tasks_file)]
+        self.data = models.Roadmap(
+            goal="Ship it",
+            tasks=[models.Task(id="task1", description="Fix the thing")],
+        )
+        tasks.save_tasks(self.tasks_file, self.data)
+
+    def tearDown(self):
+        shutil.rmtree(self.test_dir)
+
+    def test_brief_file_path_is_per_task(self):
+        path = paths.get_brief_file(self.tasks_file, "task1")
+
+        self.assertTrue(str(path).endswith("task1-brief.md"))
+
+    def test_prompt_includes_brief_when_present(self):
+        """The runner must receive the evidence without being told to look."""
+        paths.get_brief_file(self.tasks_file, "task1").write_text(EVIDENCE)
+
+        prompt = prompts.prepare_prompt(
+            self.data, self.data.tasks[0], self.tasks_file
+        )
+
+        self.assertIn(EVIDENCE, prompt)
+
+    def test_prompt_omits_brief_section_when_absent(self):
+        """No brief means no empty scaffolding in the prompt."""
+        prompt = prompts.prepare_prompt(
+            self.data, self.data.tasks[0], self.tasks_file
+        )
+
+        self.assertNotIn("Task Brief", prompt)
+
+    def test_brief_command_writes_and_reads_back(self):
+        write = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["brief", "task1", EVIDENCE]
+        )
+        self.assertEqual(write.exit_code, 0, write.output)
+
+        read = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["brief", "task1"]
+        )
+
+        self.assertEqual(read.exit_code, 0, read.output)
+        self.assertIn(EVIDENCE, read.output)
+
+    def test_brief_command_reads_from_stdin(self):
+        result = self.cli_runner.invoke(
+            cli.cli,
+            self.base_args + ["brief", "task1", "--file", "-"],
+            input=EVIDENCE,
+        )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        stored = paths.get_brief_file(self.tasks_file, "task1").read_text()
+        self.assertIn(EVIDENCE, stored)
+
+    def test_brief_reports_when_missing(self):
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["brief", "task1"]
+        )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        self.assertIn("No brief", result.output)
+
+    def test_brief_has_no_length_cap(self):
+        """The brief is where evidence too large for a description belongs."""
+        long_evidence = "y" * (tasks.MAX_TASK_DESCRIPTION_CHARS * 3)
+
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["brief", "task1", long_evidence]
+        )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        stored = paths.get_brief_file(self.tasks_file, "task1").read_text()
+        self.assertEqual(len(stored.strip()), len(long_evidence))
+
+    def test_description_cap_error_points_at_the_brief(self):
+        """Hitting the cap must name the supported way to attach evidence."""
+        with self.assertRaises(ValueError) as caught:
+            tasks.add_task(self.tasks_file, "z" * 5000)
+
+        self.assertIn("lemming brief", str(caught.exception))
+
+
+if __name__ == "__main__":
+    unittest.main()

{lemming_cli-0.3.2 → lemming_cli-0.3.4}/src/lemming/cli/__init__.py

@@ -1,5 +1,6 @@
 """Lemming CLI package; importing the submodules registers all commands."""
 
+from . import brief as _brief_cmds  # noqa: F401
 from . import config as _config_cmds  # noqa: F401
 from . import goal as _goal_cmds  # noqa: F401
 from . import hooks as _hooks_cmds  # noqa: F401

lemming_cli-0.3.4/src/lemming/cli/brief.py

@@ -0,0 +1,70 @@
+"""CLI command for the long-form task brief."""
+
+import typing
+
+import click
+
+from .. import paths, tasks
+from .main import cli
+
+
+@cli.command(short_help="<taskid> [text] View or set a task's long-form brief")
+@click.argument("task_id")
+@click.argument("text", required=False)
+@click.option(
+    "--file",
+    "-f",
+    type=click.File("r"),
+    help="Read the brief from a file (or - for stdin).",
+)
+@click.pass_context
+def brief(
+    ctx: click.Context,
+    task_id: str,
+    text: typing.Optional[str],
+    file: typing.Optional[typing.TextIO],
+):
+    """Views or sets the long-form brief delivered with a task.
+
+    The brief holds evidence that does not belong in the description: measured
+    timings, exact failing selectors, why a previous attempt was wrong. It has
+    no length cap and is appended to the runner prompt automatically, so the
+    description never has to point at it.
+
+    Examples:
+      lemming brief a1b2c3d4
+      lemming brief a1b2c3d4 "Timings: first paint 2.4s"
+      lemming brief a1b2c3d4 --file notes.md
+    """
+    tasks_file = ctx.obj["TASKS_FILE"]
+
+    data = tasks.load_tasks(tasks_file)
+    try:
+        target = tasks.resolve_task(data.tasks, task_id)
+    except (tasks.TaskNotFoundError, tasks.AmbiguousTaskIdError) as e:
+        click.echo(f"Error: {e}")
+        ctx.exit(1)
+
+    if file and text:
+        click.echo("Error: Cannot provide both brief text and --file.")
+        ctx.exit(1)
+
+    brief_file = paths.get_brief_file(tasks_file, target.id)
+
+    # With no new content, the command reads the brief back.
+    if not file and not text:
+        if not brief_file.exists() or not brief_file.read_text().strip():
+            click.echo(f"No brief for task {target.id}.")
+            return
+        click.echo(brief_file.read_text(encoding="utf-8"))
+        return
+
+    content = (file.read() if file else text or "").strip()
+    if not content:
+        click.echo("Error: Must provide either brief text or --file.")
+        ctx.exit(1)
+
+    brief_file.write_text(content + "\n", encoding="utf-8")
+    click.echo(
+        f"Brief for task {target.id} saved ({len(content):,} characters)."
+    )

{lemming_cli-0.3.2 → lemming_cli-0.3.4}/src/lemming/cli/config.py

@@ -23,6 +23,7 @@ def config_list(ctx: click.Context):
 
     click.secho(f"Configuration for {tasks_file}:", bold=True)
     click.echo(f"  Runner:        {c.runner}")
+    click.echo(f"  Model:         {c.model or '(runner default)'}")
     click.echo(f"  Retries:       {c.retries}")
     click.echo(f"  Time limit:    {format_duration(c.time_limit)}")
 
@@ -37,15 +38,21 @@ def config_list(ctx: click.Context):
 @config_group.command(name="set")
 @click.argument(
     "key",
-    type=click.Choice(["runner", "retries", "time_limit"]),
+    type=click.Choice(["runner", "model", "retries", "time_limit"]),
 )
 @click.argument("value")
 @click.pass_context
 def config_set(ctx: click.Context, key: str, value: str):
     """Sets a configuration value.
 
+    The runner is the CLI to invoke; the model is a separate field so that
+    switching runners (for example from a quota hook) does not silently
+    discard the pinned model.
+
     Examples:
       lemming config set runner aider
+      lemming config set model gemini-3.6-flash-high
+      lemming config set model default
       lemming config set retries 5
       lemming config set time_limit 30m
     """
@@ -54,6 +61,9 @@ def config_set(ctx: click.Context, key: str, value: str):
 
     if key == "runner":
         data.config.runner = value
+    elif key == "model":
+        # "default" clears the pin and lets the runner choose.
+        data.config.model = None if value.lower() == "default" else value
     elif key == "retries":
         try:
             data.config.retries = int(value)

lemming_cli-0.3.4/src/lemming/cli/config_test.py

@@ -0,0 +1,114 @@
+import pathlib
+import shutil
+import tempfile
+import unittest
+
+import click.testing
+
+from lemming import cli, tasks
+
+
+class TestCLIConfig(unittest.TestCase):
+    def setUp(self):
+        self.cli_runner = click.testing.CliRunner()
+        self.test_dir = tempfile.mkdtemp()
+        self.test_tasks_file = pathlib.Path(self.test_dir) / "tasks_test.yml"
+        self.base_args = [
+            "--verbose",
+            "--tasks-file",
+            str(self.test_tasks_file),
+        ]
+
+        # Scaffold a valid file
+        data = tasks.Roadmap(
+            goal="Initial goal",
+            tasks=[],
+        )
+        tasks.save_tasks(self.test_tasks_file, data)
+
+    def tearDown(self):
+        shutil.rmtree(self.test_dir)
+
+    def test_config_list(self):
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "list"]
+        )
+        self.assertEqual(result.exit_code, 0)
+        self.assertIn("Runner:", result.output)
+        # Active hooks are discovered from the filesystem and displayed
+        self.assertIn("Hooks:", result.output)
+        self.assertIn("roadmap", result.output)
+
+    def test_config_set(self):
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "runner", "new-runner"]
+        )
+        self.assertEqual(result.exit_code, 0)
+        self.assertIn("Updated runner to new-runner", result.output)
+        data = tasks.load_tasks(self.test_tasks_file)
+        self.assertEqual(data.config.runner, "new-runner")
+
+
+if __name__ == "__main__":
+    unittest.main()
+
+
+class TestCLIConfigModel(unittest.TestCase):
+    def setUp(self):
+        self.cli_runner = click.testing.CliRunner()
+        self.test_dir = tempfile.mkdtemp()
+        self.test_tasks_file = pathlib.Path(self.test_dir) / "tasks_test.yml"
+        self.base_args = ["--tasks-file", str(self.test_tasks_file)]
+        tasks.save_tasks(self.test_tasks_file, tasks.Roadmap(goal="g"))
+
+    def tearDown(self):
+        shutil.rmtree(self.test_dir)
+
+    def test_config_set_model_persists(self):
+        """The model is a first-class field, not part of the runner string."""
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "model", "fast-model"]
+        )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        data = tasks.load_tasks(self.test_tasks_file)
+        self.assertEqual(data.config.model, "fast-model")
+
+    def test_switching_runner_preserves_model(self):
+        """A quota hook switching runners must not discard the model."""
+        self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "model", "fast-model"]
+        )
+
+        self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "runner", "codex"]
+        )
+
+        data = tasks.load_tasks(self.test_tasks_file)
+        self.assertEqual(data.config.runner, "codex")
+        self.assertEqual(data.config.model, "fast-model")
+
+    def test_config_set_model_default_clears_pin(self):
+        """ "default" hands model choice back to the runner."""
+        self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "model", "fast-model"]
+        )
+
+        self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "model", "default"]
+        )
+
+        data = tasks.load_tasks(self.test_tasks_file)
+        self.assertIsNone(data.config.model)
+
+    def test_config_list_shows_model(self):
+        """The model is discoverable without reading the source."""
+        self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "set", "model", "fast-model"]
+        )
+
+        result = self.cli_runner.invoke(
+            cli.cli, self.base_args + ["config", "list"]
+        )
+
+        self.assertIn("fast-model", result.output)