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.
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.
| Option | Default | Accepted values | What it does |
|---|---|---|---|
--at-least time | 15m | the same lengths of time as --within; 0 for no minimum | Only people waiting at least this long. If everyone on your list has waited longer than that, the list does not change. |
--within time | 7d | a number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limit | How far back the last message may be. |
--limit n | 50 | a whole number, 1 or more | Most chats printed; the count line still counts all. |
--text, --table, --csv, --json, --format name | what nj set format saved, else text | text, table, csv, json | The 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 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 30dnj wp waiting --at-least 1d --within 30d 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 0unanswered
Who has not answered you.
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.
| Option | Default | Accepted values | What it does |
|---|---|---|---|
--at-least time | 24h | as for waiting | Only chats where your message is at least this old. |
--within time | 7d | a number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limit | How far back your last message may be. |
--limit n | 50 | a whole number, 1 or more | Most chats printed. |
--text, --table, --csv, --json, --format name | what nj set format saved, else text | text, table, csv, json | The 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 2w Daniel Reed
you: Following up on the Rome quote. Shall I hold the rooms?
1 person has not answered younew
Chats with unread messages.
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.
| Option | Default | Accepted values | What it does |
|---|---|---|---|
--limit n | 50 | a whole number, 1 or more | Most chats printed. |
--text, --table, --csv, --json, --format name | what nj set format saved, else text | text, table, csv, json | The 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 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.
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.
| Option | Default | Accepted values | What it does |
|---|---|---|---|
--within time | 7d | a number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limit | How far back the last message may be. |
--limit n | 50 | a whole number, 1 or more | Most chats printed. |
--text, --table, --csv, --json, --format name | what nj set format saved, else text | text, table, csv, json | The 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 1d James Carter · unread · archived
them: Hi again, we want to book the same hotel for Easter
1 chat archived and still activenew-customers
Chats that started recently, by default in the last 7 days. This is not the same as new, which lists unread chats.
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.
| Option | Default | Accepted values | What it does |
|---|---|---|---|
--within time | 7d | a number followed by m (minutes), h (hours), d (days) or w (weeks), such as 12h, 30d, 8w; 0 for no limit | How far back the first message may be. |
--limit n | 50 | a whole number, 1 or more | Most chats printed. |
--text, --table, --csv, --json, --format name | what nj set format saved, else text | text, table, csv, json | The 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 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 0Its columns:
| Column | Meaning | Values |
|---|---|---|
chat_id | WhatsApp's ID of the chat | a number and @s.whatsapp.net |
name | The name WhatsApp shows | text, or empty |
first_at | When the first message was sent, in your time zone | a date and time such as 2026-11-17T08:59:10+07:00 |
messages | How many messages the chat holds, not counting system notices | a number |
nj wp new-customers --json[
{
"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.
| Column | Meaning | Values |
|---|---|---|
chat_id | WhatsApp's ID of the chat | a number and @s.whatsapp.net for a person, @g.us for a group, @lid for some contacts |
name | The name WhatsApp shows for the chat | text; empty when WhatsApp has none |
kind | Person or group | direct or group |
unread | WhatsApp's unread count | 0 or more; below 0 means you marked the chat unread |
archived | Whether the chat is archived | true or false |
last_at | When the last message was sent, in your time zone | a date and time such as 2026-11-17T08:59:10+07:00; empty when the chat has no message |
last_from | Who sent the last message | them, me, or empty |
minutes_since_last | Whole minutes since the last message | a number, or empty |
last_kind | The kind of the last message | text, picture, video, audio, link, document, sticker, gif, call, or kind_ and a number for a kind Namjai has no name for |
last_text | The last message's text, whole, on one line or several | text; empty for most pictures, files and voice notes |
nj wp waiting --csvchat_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.