Commands: lists of chats

The five lists: who is waiting, who has not answered, what is unread, what is archived and still active, and which chats are new.

Five lists of chats. Each prints the chats, newest first, and a line that counts them. The columns they print with --table, --csv and --json are the same for all five, except new-customers; they are listed at the end of this page.

waiting

Who is waiting for your answer, and for how long.

nj wp waiting [--at-least time] [--within time] [--limit n]

Lists one-to-one chats whose last message is theirs, sent at least --at-least ago (15 minutes when not given) and no longer ago than --within (7 days when not given). Groups are left out, and so is WhatsApp's own chat. Archived chats are included and marked. System notices (such as someone joining a group) never count as the last message. Chats WhatsApp marks removed are left out. Sorted by the last message, newest first. It takes no words.

OptionDefaultAccepted valuesWhat it does
--at-least time15mthe same lengths of time as --within; 0 for no minimumOnly people waiting at least this long. If everyone on your list has waited longer than that, the list does not change.
--within time7da number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limitHow far back the last message may be.
--limit n50a whole number, 1 or moreMost chats printed; the count line still counts all.
--text, --table, --csv, --json, --format namewhat nj set format saved, else texttext, table, csv, jsonThe same result in another format. See Formats and spreadsheets.

Mistakes. A mistake prints one line that says what was wrong, then See: nj help, to the error output, and exits with 2. A value it cannot use: nj wp waiting: --limit must be a whole number above 0, got "many"; nj wp waiting: --limit needs a value; nj wp waiting: --within must be a length of time such as 12h, 30d or 8w, or 0 for no limit, got "soon"; nj wp waiting: --at-least must be a length of time such as 2h or 3d, got "soon"; nj wp waiting: --format must be text, table, csv or json, got "xml". An option it does not take: nj wp waiting: --missed is not an option of this command; it takes --at-least, --csv, --format, --json, --limit, --table, --text, --within. Two different formats: nj wp waiting: choose one format, not both --csv and --json. A stray word: nj wp waiting: does not take words, got "stray".

As text, each chat takes two lines. The first: the time since the last message (52m, 3h 53m, 2d; from 14 days on, weeks such as 2w), the name (or the number when WhatsApp has no name), and the marks group, unread and archived when they apply. The second: who sent the last message, them: or you:, and its text, cut at 90 characters with …; a message with no text shows its kind in brackets, such as [audio]. The last line counts the result. When there are more than --limit, it ends with (showing 50; add --limit 60 for all), with the real numbers.

The count line names the window and the command for a wider one: 3 people waiting for your answer in the last 7d. For longer: nj wp waiting --within 30d. With 30 days or more it offers --within 0 instead; with --within 0 it names no window.

nj wp waiting
Terminal
     18m  Laura Kim · unread
          them: Hi, is the Tokyo tour in April still available?
     47m  Dana Levi · unread
          them: And can we get a late checkout?
  3h 10m  Sarah Cohen · unread
          them: Can you send the flight times for the 14th?
  5h 20m  ⁨יעל אברהם⁩‎ · unread
          them: ⁨שלום, יש מקום פנוי לטיסה לאילת ביום שלישי?⁩‎
      1d  James Carter · unread · archived
          them: Hi again, we want to book the same hotel for Easter
5 people waiting for your answer in the last 7d. For longer: nj wp waiting --within 30d
nj wp waiting --at-least 1d --within 30d
Terminal
      1d  James Carter · unread · archived
          them: Hi again, we want to book the same hotel for Easter
1 person waiting for your answer in the last 30d. For everything: nj wp waiting --within 0

unanswered

Who has not answered you.

nj wp unanswered [--at-least time] [--within time] [--limit n]

The same as waiting, turned around: one-to-one chats whose last message is yours, sent at least --at-least ago (24 hours when not given) and within --within (7 days). Groups and WhatsApp's own chat are left out. System notices (such as someone joining a group) never count as the last message. Chats WhatsApp marks removed are left out. Newest first. No words.

OptionDefaultAccepted valuesWhat it does
--at-least time24has for waitingOnly chats where your message is at least this old.
--within time7da number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limitHow far back your last message may be.
--limit n50a whole number, 1 or moreMost chats printed.
--text, --table, --csv, --json, --format namewhat nj set format saved, else texttext, table, csv, jsonThe same result in another format. See Formats and spreadsheets.

Mistakes. A mistake prints one line that says what was wrong, then See: nj help, to the error output, and exits with 2. A value it cannot use: nj wp unanswered: --limit must be a whole number above 0, got "many"; nj wp unanswered: --within must be a length of time such as 12h, 30d or 8w, or 0 for no limit, got "soon". An option it does not take: nj wp unanswered: --chat is not an option of this command; it takes --at-least, --csv, --format, --json, --limit, --table, --text, --within. Two different formats: nj wp unanswered: choose one format, not both --csv and --json. A stray word: nj wp unanswered: does not take words, got "stray".

nj wp unanswered --at-least 3d --within 0
Terminal
      2w  Daniel Reed
          you: Following up on the Rome quote. Shall I hold the rooms?
1 person has not answered you

new

Chats with unread messages.

nj wp new [--limit n]

Lists every chat, groups included, whose unread count is not zero, which includes chats you marked unread. Newest last message first. It has no time window, so it does not take --within or --at-least. No words.

OptionDefaultAccepted valuesWhat it does
--limit n50a whole number, 1 or moreMost chats printed.
--text, --table, --csv, --json, --format namewhat nj set format saved, else texttext, table, csv, jsonThe same result in another format. See Formats and spreadsheets.

Mistakes. A mistake prints one line that says what was wrong, then See: nj help, to the error output, and exits with 2. A value it cannot use: nj wp new: --limit must be a whole number above 0, got "many". An option it does not take: nj wp new: --within is not an option of this command; it takes --csv, --format, --json, --limit, --table, --text. Two different formats: nj wp new: choose one format, not both --csv and --json. A stray word: nj wp new: does not take words, got "stray".

nj wp new --limit 2
Terminal
     18m  Laura Kim · unread
          them: Hi, is the Tokyo tour in April still available?
     26m  Phuket trip, March · group · unread
          them: Which day is the boat trip?
6 chats (showing 2; add --limit 6 for all)

archived

Archived chats that are still active.

nj wp archived [--within time] [--limit n]

Lists archived chats, groups included, whose last message is within --within (7 days when not given). System notices (such as someone joining a group) never count as the last message. Chats WhatsApp marks removed are left out. Newest first. No words.

OptionDefaultAccepted valuesWhat it does
--within time7da number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limitHow far back the last message may be.
--limit n50a whole number, 1 or moreMost chats printed.
--text, --table, --csv, --json, --format namewhat nj set format saved, else texttext, table, csv, jsonThe same result in another format. See Formats and spreadsheets.

Mistakes. A mistake prints one line that says what was wrong, then See: nj help, to the error output, and exits with 2. A value it cannot use: nj wp archived: --limit must be a whole number above 0, got "many"; nj wp archived: --within must be a length of time such as 12h, 30d or 8w, or 0 for no limit, got "soon". An option it does not take: nj wp archived: --at-least is not an option of this command; it takes --csv, --format, --json, --limit, --table, --text, --within. Two different formats: nj wp archived: choose one format, not both --csv and --json. A stray word: nj wp archived: does not take words, got "stray".

nj wp archived --within 0
Terminal
      1d  James Carter · unread · archived
          them: Hi again, we want to book the same hotel for Easter
1 chat archived and still active

new-customers

Chats that started recently, by default in the last 7 days. This is not the same as new, which lists unread chats.

nj wp new-customers [--within time] [--limit n]

Lists one-to-one chats whose first message on this Mac is within --within (7 days). Groups and WhatsApp's own chat are left out, and system notices do not count. Newest first message first. No words. Namjai only sees what WhatsApp copied to this Mac, so a chat that started before WhatsApp was linked counts from the first message the Mac holds.

OptionDefaultAccepted valuesWhat it does
--within time7da number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limitHow far back the first message may be.
--limit n50a whole number, 1 or moreMost chats printed.
--text, --table, --csv, --json, --format namewhat nj set format saved, else texttext, table, csv, jsonThe same result in another format. See Formats and spreadsheets.

Mistakes. A mistake prints one line that says what was wrong, then See: nj help, to the error output, and exits with 2. A value it cannot use: nj wp new-customers: --limit must be a whole number above 0, got "many"; nj wp new-customers: --within must be a length of time such as 12h, 30d or 8w, or 0 for no limit, got "soon". An option it does not take: nj wp new-customers: --at-least is not an option of this command; it takes --csv, --format, --json, --limit, --table, --text, --within. Two different formats: nj wp new-customers: choose one format, not both --csv and --json. A stray word: nj wp new-customers: does not take words, got "stray".

nj wp new-customers --within 30d
Terminal
     18m  Laura Kim · first message Nov 18 · 1 message
  5h 20m  ⁨יעל אברהם⁩‎ · first message Nov 17 · 1 message
      1d  Sarah Cohen · first message Nov 17 · 3 messages
      2d  Emily Turner · first message Nov 15 · 4 messages
      4d  Michael Brooks · first message Nov 14 · 2 messages
      5d  ⁨אורי מזרחי⁩‎ · first message Nov 13 · 2 messages
      6d  Dana Levi · first message Nov 12 · 6 messages
      2w  James Carter · first message Nov 3 · 2 messages
      2w  Daniel Reed · first message Oct 29 · 1 message
9 chats started in the last 30d. For everything: nj wp new-customers --within 0

Its columns:

ColumnMeaningValues
chat_idWhatsApp's ID of the chata number and @s.whatsapp.net
nameThe name WhatsApp showstext, or empty
first_atWhen the first message was sent, in your time zonea date and time such as 2026-11-17T08:59:10+07:00
messagesHow many messages the chat holds, not counting system noticesa number
nj wp new-customers --json
Terminal
[
  {
    "chat_id": "99900000419@s.whatsapp.net",
    "first_at": "2026-11-18T01:07:00+07:00",
    "messages": "1",
    "name": "Laura Kim"
  },
  {
    "chat_id": "99900000414@s.whatsapp.net",
    "first_at": "2026-11-17T20:05:00+07:00",
    "messages": "1",
    "name": "יעל אברהם"
  },
  {
    "chat_id": "99900000413@s.whatsapp.net",
    "first_at": "2026-11-17T01:25:00+07:00",
    "messages": "3",
    "name": "Sarah Cohen"
  },
  {
    "chat_id": "99900000417@s.whatsapp.net",
    "first_at": "2026-11-15T20:25:00+07:00",
    "messages": "4",
    "name": "Emily Turner"
  },
  {
    "chat_id": "99900000412@s.whatsapp.net",
    "first_at": "2026-11-14T01:25:00+07:00",
    "messages": "2",
    "name": "Michael Brooks"
  },
  {
    "chat_id": "99900000415@s.whatsapp.net",
    "first_at": "2026-11-13T01:25:00+07:00",
    "messages": "2",
    "name": "אורי מזרחי"
  },
  {
    "chat_id": "99900000411@s.whatsapp.net",
    "first_at": "2026-11-12T01:25:00+07:00",
    "messages": "6",
    "name": "Dana Levi"
  }
]

Columns of waiting, unanswered, new and archived

With --table, --csv or --json, these four commands (and find and labelled) print one row per chat with these columns, in this order. In JSON every value is text in quotes.

ColumnMeaningValues
chat_idWhatsApp's ID of the chata number and @s.whatsapp.net for a person, @g.us for a group, @lid for some contacts
nameThe name WhatsApp shows for the chattext; empty when WhatsApp has none
kindPerson or groupdirect or group
unreadWhatsApp's unread count0 or more; below 0 means you marked the chat unread
archivedWhether the chat is archivedtrue or false
last_atWhen the last message was sent, in your time zonea date and time such as 2026-11-17T08:59:10+07:00; empty when the chat has no message
last_fromWho sent the last messagethem, me, or empty
minutes_since_lastWhole minutes since the last messagea number, or empty
last_kindThe kind of the last messagetext, picture, video, audio, link, document, sticker, gif, call, or kind_ and a number for a kind Namjai has no name for
last_textThe last message's text, whole, on one line or severaltext; empty for most pictures, files and voice notes
nj wp waiting --csv
Terminal
chat_id,name,kind,unread,archived,last_at,last_from,minutes_since_last,last_kind,last_text
99900000419@s.whatsapp.net,Laura Kim,direct,1,false,2026-11-18T01:07:00+07:00,them,18,text,"Hi, is the Tokyo tour in April still available?"
99900000411@s.whatsapp.net,Dana Levi,direct,2,false,2026-11-18T00:38:00+07:00,them,47,text,And can we get a late checkout?
99900000413@s.whatsapp.net,Sarah Cohen,direct,2,false,2026-11-17T22:15:00+07:00,them,190,text,Can you send the flight times for the 14th?
99900000414@s.whatsapp.net,יעל אברהם,direct,1,false,2026-11-17T20:05:00+07:00,them,320,text,"שלום, יש מקום פנוי לטיסה לאילת ביום שלישי?"
99900000416@s.whatsapp.net,James Carter,direct,1,true,2026-11-16T21:25:00+07:00,them,1680,text,"Hi again, we want to book the same hotel for Easter"

An error in any of these lists, such as WhatsApp's files missing, prints nj: whatsapp store: and the reason, and exits with 1. A missing setting prints nj: configuration:, the setting, and If you have not yet, run: nj setup, and exits with 2; see Settings.