Skip to content

Feature request: notification commands (list, view, and mark notifications read/unread) #235

Description

@chenghung

Summary

Add a notification command group so Trello notifications can be managed from the CLI.

Why this is needed

trello-cli currently has no way to interact with Trello notifications. Notifications are a core part of Trello (mentions, due-date reminders, being added to cards/boards, comments, and so on). Users who work primarily from the terminal have to switch to the web or mobile app just to see whether they have unread notifications, read them, or clear them. Surfacing notifications in the CLI closes that gap and makes it possible to triage notifications — and script around them — without leaving the terminal.

Current state of the repo

  • There is no notification topic under src/commands/. None of list/show/read/unread/read-all exist, and there is currently no way to reach the notifications API through the CLI.
  • The API client the CLI already depends on, trello.js, already fully supports the relevant endpoints:
    • members.getMemberNotifications — list a member's notifications (supports readFilter, limit, etc.)
    • notifications.getNotification — fetch a single notification
    • notifications.updateNotification — mark a single notification read/unread
    • notifications.markAllNotificationsAsRead — mark all notifications as read
  • Because the client support is already in place, adding the CLI layer is small and low-risk: each command is a thin BaseCommand subclass that wires an existing client method to an oclif command, following the same patterns as existing commands (for example card/label.ts and board/members.ts). oclif auto-discovers commands, so no package.json changes are required.

Proposed commands

  • notification:list — list your notifications (--filter all|read|unread, --limit)
  • notification:show — show a single notification (--id)
  • notification:read and notification:unread — mark a single notification read/unread (--id)
  • notification:read-all — mark all notifications as read

An implementation is ready and a PR will reference this issue.

🤖 Generated with Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions