← 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 --describethat 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 describemanually: works, but the extra command hides important parameter semantics during discovery.
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse