Skip to content

feat(models): spotlight a new local model and run it after pull - #1100

Closed
sosidudku1 wants to merge 3 commits into
mainfrom
feat/model-spotlight-terminal
Closed

sosidudku1 wants to merge 3 commits into
mainfrom
feat/model-spotlight-terminal

Conversation

@sosidudku1

@sosidudku1 sosidudku1 commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

What

Prepares the terminal for a new local model launch, ahead of the model itself.

  • Catalog entries get an optional spotlight flag. No entry sets it, so nothing changes for users until a launch adds one.
  • When a flagged model fits this machine's memory and none of the flagged models is on disk, the TUI prints one startup line. It appears at most once per model id, never during first-run setup, and the seen list lives in the state dir, so there is no config migration.
  • atomic-agent models pull <id> --run downloads the model, makes it active and starts it. On a vision model it also fetches the projector, as the TUI does by default. --run with --background is refused.

Why

Today models pull, use and start are three commands, and nothing tells a terminal user that a new model exists. A launch should only need catalog rows.

Notes for review

How it was verified

  • Second Mac: build and lint clean; vitest for src/cli/models-command, src/cli/models-pull-run, src/local-llm/catalog and src/tui/local-models: 45 files, 440 tests green.
  • Not yet exercised live with a flagged model or a real download.

Add an optional `spotlight` flag on catalog entries for a model launch.
When a flagged model fits the machine and is not on disk yet, the TUI
shows one startup hint, at most once per model id.

Add `models pull <id> --run`, which downloads the model, makes it active
and starts it, including the vision projector the TUI fetches by default.

No catalog entry sets the flag, so nothing changes for users until a
launch adds one.
@sosidudku1

Copy link
Copy Markdown
Collaborator Author

Merged as part of #1106.

@sosidudku1 sosidudku1 closed this Nov 9, 2026
praxstack pushed a commit to praxstack/AtomicBot-ai-atomic-agent that referenced this pull request Nov 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant