Skill

omni-chats

Manages Omni chats via CLI: list/filter by unread/pending/attention/labels/channels/types/search, create/update/delete, archive/unarchive/read, view participants/history.

Bash

cli-tools

npx claudepluginhub automagik-dev/omni --plugin omni

Tool Access

This skill is limited to using the following tools:

Bash(omni *)Bash(jq *)

Preview

```bash

SKILL.md

Similar Skills

omni-instances

Manages Omni channel instances for WhatsApp, Discord, Telegram, Slack: lifecycle ops, QR pairing, sync jobs, auto-ack reactions, debounce, agent session strategies, and dispatch config.

2 tools

omni

agent-channeltalk

100

Interact with Channel Talk workspaces via CLI using auto-extracted desktop app or browser credentials: read/send messages in user chats and groups, list chats, manage multi-workspace support.

5 files1 tool

agent-messenger

gws-chat

16.9k

Manages Google Chat spaces, custom emojis, messages, and media via gws CLI commands including create, delete, list, upload, and download.

google-workspace

Stats

Parent Repo Stars14

Parent Repo Forks1

Last CommitMar 17, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Omni Chats

List and inspect

omni chats list --instance <id> --limit 50 --json
omni chats list --instance <id> --unread --sort activity --verbose --json
omni chats list --channel whatsapp-baileys --type group --json
omni chats list --instance <id> --search "client name" --json
omni chats list --instance <id> --all --json
omni chats get <chatId> --json

List flags reference

Flag	Description
`--instance <id>`	Filter by instance ID
`--channel <type>`	Filter by channel type (whatsapp-baileys, discord, etc.)
`--search <query>`	Search chats by name
`--type <type>`	Filter by chat type: `dm`, `group`, `channel`. When omitted, all types are shown (no filtering).
`--limit <n>`	Limit number of results
`--sort <field>`	Sort by: `activity` (default), `unread`, `name`
`--unread`	Only show chats with unread messages
`--archived`	Include archived chats
`--all`	Include newsletters and broadcasts
`--verbose`	Show full details (ID, channel, archived status)
`--pending`	Only show chats pending a reply (last message is not from me AND has unreads)
`--attention`	Show chats needing attention (combines: unread + pending reply + follow-up labeled)
`--label <name>`	Filter chats by label (e.g., `follow-up`, `todo`, `vip`)
`--hidden`	Include hidden chats in the listing (hidden chats are excluded by default)

Pagination

The list command displays pagination metadata after the table:

ℹ Showing 3 of 3 chats

When --limit truncates results, this shows how many were returned vs. total matching.

Attention and pending

# Chats needing attention (unread + pending reply + follow-up labeled)
omni chats list --instance <id> --attention --json

# Only chats where last message is not from me AND has unreads
omni chats list --instance <id> --pending --json

# Filter by label
omni chats list --instance <id> --label follow-up --json
omni chats list --instance <id> --label todo --json

# Include hidden chats in listing
omni chats list --instance <id> --hidden --json

Create and update

omni chats create --instance <id> --external-id "whatsapp:+5511999" --channel whatsapp-baileys --type private --name "Lead" --json
omni chats create --instance <id> --external-id "..." --channel whatsapp-baileys --type group --name "Team" --description "Team chat" --json
omni chats update <chatId> --name "New name" --description "Notes" --json
omni chats delete <chatId> --json

Chat state actions

omni chats read <chatId> --instance <id> --json
omni chats archive <chatId> --instance <id> --json
omni chats unarchive <chatId> --instance <id> --json
omni chats pin <chatId> --instance <id> --json
omni chats unpin <chatId> --instance <id> --json
omni chats mute <chatId> --instance <id> --duration 28800000 --json
omni chats unmute <chatId> --instance <id> --json
omni chats disappearing <chatId> --instance <id> --duration 24h --json

Visibility (privacy)

# Hide chat from agent view (agent won't see it in listings or know it exists)
omni chats hide <chatId> --json

# Unhide chat
omni chats unhide <chatId> --json

Labels

# Add a label to a chat
omni chats label <chatId> follow-up --json
omni chats label <chatId> todo --json
omni chats label <chatId> vip --json

# Remove a label
omni chats unlabel <chatId> follow-up --json

Messages in a chat

omni chats messages <chatId> --limit 100 --json
omni chats messages <chatId> --since 7d --search "invoice" --json
omni chats messages <chatId> --audio-only --compact --truncate 120 --json
omni chats messages <chatId> --images-only --before <cursor> --json
omni chats messages <chatId> --videos-only --json
omni chats messages <chatId> --docs-only --json
omni chats messages <chatId> --after <cursor> --json

Participants

omni chats participants <chatId> --json
omni chats participants <chatId> --add <userId> --name "Member" --role member --json
omni chats participants <chatId> --promote <userId> --json
omni chats participants <chatId> --demote <userId> --json
omni chats participants <chatId> --remove <userId> --json