Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneesstack72

Relationships

#1904 Make model argument descriptions discoverable from model search

Opened by dieter · 8/29/2026· Shipped 9/4/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+ 1 MOREASSIGNED+ 4 MOREREVIEW+ 9 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/4/2026, 6:23:00 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/4/2026, 5:34:49 PM
Editable. Press Enter to edit.

stack72 commented 9/4/2026, 6:23:09 PM

Thanks @dieter for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.