Skip to main content
← Back to list
01Issue
FeatureOpenSwamp CLIPublic
AssigneesNone

Relationships

#1904 Make model argument descriptions discoverable from model search

Opened by dieter · 8/29/2026

Problem

swamp model search returns only model ID, name, and type. Argument descriptions added by extension authors through Zod .describe() are available only after a separate swamp model type describe <type> call. This makes it easy to miss behaviorally important options such as limits that truncate output.

Proposed solution

Add opt-in detail to model search without making its default output noisy:

  • CLI: add a flag such as swamp model search --describe that includes the selected model type’s methods, argument names, defaults, and schema descriptions.
  • Interactive UI: provide a keyboard action on a selected search result to expand or open the same detail view.

The detail view should distinguish global arguments from method arguments and preserve JSON Schema descriptions.

Alternatives considered

  • Always include argument schemas in default search output: rejected because a repository with many models would become difficult to scan.
  • Require users to run swamp model type describe manually: works, but the extra command hides important parameter semantics during discovery.
02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

8/29/2026, 7:29:30 PM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.