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.

Check what was redacted

Every submission — bug, feature, security, edit and ripple, including --email — redacts secrets, credentials, email addresses, IP addresses, internal hostnames, home directory usernames and personal identifiers before it is sent. When anything is redacted, the command prints each changed line:

Redacted 1 secret, 1 IP address from issue content.
body line 1: Ran with API_TOKEN=abc123def456 -> Ran with API_TOKEN=[REDACTED-SECRET-1]
body line 2: host 10.20.30.40 unreachable -> host [IP-1] unreachable

Read these lines before relying on the report. Redaction is a best-effort safety net, so remove anything sensitive it missed from what you paste, and check that the evidence you need survived.

If you have already sanitized the content and redaction removes diagnostic detail, submit it as written with --no-redact:

swamp issue bug --title "..." --body "..." --no-redact

See Redaction for the full list of what is matched.

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.

Change an issue's type

swamp issue edit 42 --type security

Valid types are bug, feature, and security. Changing to security is a one-way door — only admins can change the type back from security.