Manage Ticket Attachments
List, upload, download, or delete attachments on a Jira ticket.
When to Use
- User wants to see what files are attached to a ticket
- User wants to upload a screenshot, log, or document
- User needs to download an attachment for review
- User wants to remove outdated attachments
How to Execute
Run:
aide jira attach TICKET-KEY --<operation> [options]
Operations (one at a time)
| Flag | Short | Description |
|--------------|-------|--------------------------------------------|
| --list | -l | List all attachments on the ticket |
| --upload | -u | Upload file(s) to ticket (can be repeated) |
| --download | -d | Download attachment by ID or filename |
| --delete | | Delete attachment by ID or filename |
Additional Flags
| Flag | Short | Description |
|------------|-------|---------------------------------------|
| --output | -o | Output directory for downloads |
| --format | | Output format: text, json, markdown |
Output
List mode: Shows attachment details including:
- Filename
- Size
- MIME type
- Author
- Upload date
Upload mode: Confirmation with uploaded file details
Download mode: File saved to current directory or specified output path
Delete mode: Confirmation of deletion
Common Patterns
# List all attachments
aide jira attach PROJ-123 --list
# Upload a single file
aide jira attach PROJ-123 --upload ./screenshot.png
# Upload multiple files
aide jira attach PROJ-123 --upload ./doc1.pdf --upload ./doc2.pdf
# Download by filename
aide jira attach PROJ-123 --download "requirements.docx"
# Download to specific directory
aide jira attach PROJ-123 --download "report.pdf" --output ./downloads
# Delete an attachment
aide jira attach PROJ-123 --delete "old-screenshot.png"
# Get attachment list as JSON
aide jira attach PROJ-123 --list --format json
Workflow
- List first: Always list attachments to see what's available
- Upload supporting files: Add screenshots, logs, or documents
- Download for analysis: Get files locally when needed
- Clean up: Delete outdated or incorrect attachments
Use Cases
| Goal | Command |
|-------------------------|------------------------------------------------------|
| See attached files | aide jira attach PROJ-123 --list |
| Add bug screenshot | aide jira attach PROJ-123 --upload ./bug.png |
| Get attached log | aide jira attach PROJ-123 --download "error.log" |
| Remove old file | aide jira attach PROJ-123 --delete "draft.pdf" |
Best Practices
- List attachments before uploading to avoid duplicates
- Use descriptive filenames when uploading
- Download attachments to review requirements or reproduce issues
- Clean up outdated attachments to keep tickets organized
Next Steps
After managing attachments:
- Use ticket skill to view full ticket details
- Use ticket-comment skill to note attachment changes