Skip to main content

FILE ISSUES FROM THE CLI

Prerequisites: Swamp installed, authenticated with swamp auth login.

Search existing issues

swamp issue search vault

Add filters to narrow results:

swamp issue search --type bug --status open
swamp issue search --type feature --limit 5

View an issue

swamp issue get 42

This displays the title, body, type, status, and comments.

File a bug report

swamp issue bug --title "Vault read fails on empty key" --body "Running swamp vault read-secret with an empty key crashes instead of returning an error."

Without --title and --body, an editor opens for interactive composition.

File a feature request

swamp issue feature --title "Add CSV export to data query" --body "It would be useful to export query results as CSV for spreadsheet analysis."

File a security report

Security reports are visible only to you and admins:

swamp issue security --title "Token stored in plaintext" --body "The server token is written to disk without encryption."

File against a specific extension

To route an issue against a specific extension:

swamp issue bug --title "Timeout on large payloads" --extension @myorg/http-client

Comment on an issue

swamp issue ripple 42 --body "Confirmed — I can reproduce this on the latest version."

Close an issue with a comment

swamp issue ripple 42 --body "Fixed in v2.1" --close

Reopen a closed issue

swamp issue ripple 42 --body "Reopening — the fix missed a case" --reopen

Edit an issue

swamp issue edit 42 --title "Updated title" --body "Updated description"

Without --body, only the title is changed. Without both flags, an editor opens.