Skip to content

Agents

Jump to bottom Edit New page
Ari Mayer edited this page Mar 31, 2026 · 6 revisions

Agents

Track AI coding assistants with version detection, GitHub integration, styled changelogs, and live service health. The Agents tab shows a curated catalog; the CLI provides status tables, release browsers, and changelog viewers.

Agents tab

Agent catalog

The built-in catalog tracks 11 AI coding assistants:

Agent Type Repo
Claude Code CLI anthropics/claude-code
Cursor IDE getcursor/cursor
Goose CLI block/goose
Zed IDE zed-industries/zed
Gemini CLI CLI google-gemini/gemini-cli
OpenCode CLI opencode-ai/opencode
Codex CLI openai/codex
Cline IDE cline/cline
Qwen Code CLI QwenLM/Qwen-Code
Kimi CLI CLI MoonshotAI/kimi-cli
OpenClaw CLI AbanteAI/openclaw

You can customize which agents are tracked and add your own custom agents. See Configuration for details.

By default, new installations track four agents: Claude Code, Codex, Gemini CLI, and OpenCode.

TUI

Layout

The Agents tab uses a two-column layout:

Column Content
Left Agent list with status indicators
Right Detail panel (release metadata, service health, changelog)

Agent list

Each agent in the list shows:

  • Name and agent type (CLI/IDE)
  • Installed version (detected automatically) vs latest version
  • Update indicator -- blue dot when an update is available
  • 24h release indicator -- marks agents with releases in the last 24 hours

Detail panel

The detail panel shows:

  • Release metadata -- latest version, release date, relative time, release frequency
  • GitHub data -- stars, open issues, license
  • Service health -- live operational status from the agent's backing provider (e.g., Claude Code shows Anthropic's status)
  • Changelog -- styled markdown rendering of the latest release notes

Filters and sort

Key Action
s Cycle sort (name, updated, stars, status)
1 Toggle installed filter
2 Toggle CLI tools filter
3 Toggle open source filter

Changelog search

Key Action
/ Search agents and changelogs
n Jump to next match
N Jump to previous match

Search matches are highlighted in the changelog with yellow background. Use n/N to jump between matches -- the detail panel scrolls automatically to each match.

Actions

Key Action
a Open tracked agents picker
o Open agent docs in browser
r Open GitHub repo in browser
c Copy agent name to clipboard

Tracked agents picker

Press a to open the tracked agents picker. Use Space to toggle agents on/off, Enter to save, Esc to cancel. Your preferences are saved to ~/.config/models/config.toml.

Service health

Agents with a known backing provider show live service health in the detail panel. For example, Claude Code shows Anthropic's operational status, and Cursor shows its own status page data. Health indicators use the same icons as the Status tab:

  • ● Operational (green)
  • ◐ Degraded (yellow)
  • ✗ Outage (red)
  • ◆ Maintenance (blue)

CLI

CLI agents status

The agents CLI can be invoked as models agents <command> or as a standalone agents <command> via a symlink (see Installation#setting-up-command-aliases).

Status table

agents status

Shows a table of tracked agents with columns for:

  • Tool -- agent name
  • 24h -- checkmark if released in the last 24 hours
  • Installed -- detected local version (or em-dash if not found)
  • Latest -- latest GitHub release version
  • Updated -- relative time since last release
  • Freq. -- estimated release frequency (e.g., "~1d", "~1w")
  • Status -- live service health icon

Sorted by most recently updated.

Release browser

CLI agents browser

agents claude              # By CLI binary name
agents claude-code         # By agent ID
agents claude --latest     # Jump to latest release
agents claude --version 1.0.170  # Specific version
agents claude --list       # List all versions

Opens an inline terminal picker with release list and changelog preview. Navigate with arrow keys. Press Enter to print the full changelog for the selected release.

Other commands

agents latest              # Picker for releases from the last 24 hours
agents list-sources        # Interactive tracked-agent manager
agents claude --web        # Open GitHub releases in browser

Version detection

models automatically detects installed agents by running version commands. Each agent in the catalog specifies:

  • cli_binary -- the binary name to look for (e.g., claude, cursor)
  • version_command -- command-line arguments to get the version (e.g., ["--version"])
  • version_regex -- optional regex to extract the version string from output

Detection runs in the background at startup and doesn't block the UI.

Update availability is determined by semver comparison when possible, falling back to string equality.

Repository · Issues · Releases · brew install models · MIT License

models wiki

Features

Reference

Development

Clone this wiki locally