Skip to content

Conversation

@robzolkos
Copy link
Owner

Summary

  • Add breadcrumbs feature to CLI responses - contextual "what can I do next?" suggestions
  • Designed for AI agents to discover workflows without knowing the full CLI
  • Also helpful for human users to learn available commands contextually

Changes

  • Add Breadcrumb type with action, cmd, and description fields
  • Add breadcrumbs array to Response struct (omitted when empty)
  • Add helper functions: NewBreadcrumb(), SuccessWithBreadcrumbs(), SuccessWithPaginationAndBreadcrumbs()
  • Add breadcrumbs to all commands (card, board, column, comment, step, reaction, user, tag, notification, search, auth, identity)
  • Dynamic values (card numbers, board IDs, etc.) are interpolated into command suggestions
  • Add unit tests for breadcrumb functionality
  • Document breadcrumbs in README

Example

fizzy card show 42 | jq '.breadcrumbs'
[
  {"action": "comment", "cmd": "fizzy comment create --card 42 --body \"text\"", "description": "Add comment"},
  {"action": "triage", "cmd": "fizzy card column 42 --column <column_id>", "description": "Move to column"},
  {"action": "close", "cmd": "fizzy card close 42", "description": "Close card"},
  {"action": "assign", "cmd": "fizzy card assign 42 --user <user_id>", "description": "Assign user"}
]

Test plan

  • Unit tests pass (go test ./...)
  • E2E tested with live API - verified breadcrumbs present in responses
  • E2E validated that breadcrumb command suggestions actually work when executed
  • Tested card, board, column, comment, step, reaction, user, tag, notification, search, auth commands

Breadcrumbs are "what can I do next?" suggestions included in CLI
output, designed primarily for AI agents but also helpful for human
users to discover available commands contextually.

Changes:
- Add Breadcrumb type and breadcrumbs field to Response struct
- Add helper functions for creating responses with breadcrumbs
- Add breadcrumbs to all commands with contextual suggestions
- Add unit tests for breadcrumb functionality
- Document breadcrumbs feature in README
@robzolkos robzolkos merged commit 8b794d5 into master Jan 24, 2026
1 check passed
@robzolkos robzolkos deleted the add-breadcrumbs branch January 24, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant