Commands

matter account              # JSON
matter account --plain      # Human-readable

matter items list [options]

matter items list --status queue --plain
matter items list --content-type article --favorite --limit 10
matter items list --status archive --all

matter items get <id>
matter items get itm_r9f3a --plain

matter items save --url <url> [--status queue|archive]

matter items save --url "https://example.com/article"
matter items save --url "https://example.com/article" --status queue

matter items update <id> [options]

matter items update itm_r9f3a --status archive
matter items update itm_r9f3a --favorite true

matter items delete <id>

matter search <query> --type <type> [options]

matter search "machine learning" --type items --plain
matter search "by:graham" --type items --status queue
matter search "\"deep work\"" --type items --all
matter search "site:nytimes climate" --type items --limit 10

matter annotations list --item <item_id> [options]

matter annotations list --item itm_r9f3a --plain
matter annotations list --item itm_r9f3a --all

matter annotations get <id>
matter annotations get ann_k3m9p

matter annotations update <id> --note "Updated note"

matter annotations delete <id>

matter tags list
matter tags list --plain

matter tags rename <id> --name "new name"

matter tags delete <id>

matter tags add --item <item_id> --name "tag name"

matter tags remove --item <item_id> --tag <tag_id>

matter login                # Opens browser to get token
matter login <token>        # Pass token directly

matter tui                  # Launch the interactive terminal UI

matter update               # Update now (instead of waiting for next run)
matter version              # Show current version

# Toggle in TUI settings, or edit ~/.config/matter/config.json