{
  "name": "wisp",
  "kind": "registry",
  "title": "Wisp",
  "description": "Every inbox you keep in Wisp (github.com/zcag/wisp), WhatsApp, Gmail, Slack, Telegram, SMS and the rest, in one place: read and answer a conversation with Wisp's summary and suggested reply, write to anyone, make it a To do or mark it done, search every account at once, and see what is unread per network on the bar.",
  "version": "0.1.0",
  "icon": {
    "tile": {
      "glyph": "󰚇",
      "bg": "#1d6a73"
    }
  },
  "author": "pal",
  "spec": "github:zcag/pal/extensions/wisp@v0.18.11",
  "source": "https://github.com/zcag/pal-extensions/tree/HEAD/wisp",
  "commit": "c620762accb2fe7be5224dd1f2912f930b9cfb48",
  "manifest": {
    "name": "wisp",
    "title": "Wisp",
    "description": "Every inbox you keep in Wisp (github.com/zcag/wisp), WhatsApp, Gmail, Slack, Telegram, SMS and the rest, in one place: read and answer a conversation with Wisp's summary and suggested reply, write to anyone, make it a To do or mark it done, search every account at once, and see what is unread per network on the bar.",
    "keywords": [
      "inbox",
      "messages",
      "chat",
      "mail"
    ],
    "version": "0.1.0",
    "icon": {
      "tile": {
        "glyph": "󰚇",
        "bg": "#1d6a73"
      }
    },
    "author": "pal",
    "repo": "bundled",
    "license": "MIT",
    "settings": [
      {
        "kind": "text",
        "id": "url",
        "label": "Wisp server",
        "required": true,
        "description": "The address of your Wisp server, as you open it in a browser.",
        "placeholder": "https://wisp.example.internal",
        "default": ""
      },
      {
        "kind": "secret",
        "id": "token",
        "label": "Token",
        "required": true,
        "description": "A token from Wisp's Accounts › Agent tokens with the scope App of yours, so what you do here acts as you, like Wisp's own page. A Read + send token works too, but acts as an agent: it sends and marks read only on accounts that let agents act. Kept in the OS keychain.",
        "placeholder": "inbx_...",
        "default": ""
      },
      {
        "kind": "boolean",
        "id": "read_on_open",
        "label": "Opening reads",
        "text": "Opening a conversation marks it read, here and on its network",
        "description": "As in Wisp: read means handled. Off, a conversation stays unread until cmd+u or m.",
        "default": true
      }
    ],
    "palettes": {
      "inbox": {
        "title": "Inbox",
        "description": "Every account's conversations in one list, as Wisp sorts them: the Inbox (unread and To dos that are due) under Wisp's sections, or Now, To do, the Screener and All; each row with its picture, last line, unread count or To do, and the latest messages in the pane.",
        "kind": "live",
        "lazy": true,
        "remember": false,
        "keys": [
          {
            "keys": "enter",
            "title": "Open the conversation"
          },
          {
            "keys": "cmd+enter",
            "title": "Mark read (unread on a read one)"
          },
          {
            "keys": "cmd+shift+r",
            "title": "Send the message typed after Tab"
          },
          {
            "keys": "cmd+t",
            "title": "To do (clear it on a To do)"
          },
          {
            "keys": "cmd+shift+t",
            "title": "To do tomorrow morning"
          },
          {
            "keys": "cmd+shift+w",
            "title": "Waiting on them"
          },
          {
            "keys": "cmd+e",
            "title": "Done (archive)"
          },
          {
            "keys": "cmd+o",
            "title": "Open in Wisp"
          },
          {
            "keys": "cmd+c",
            "title": "Copy the last message"
          }
        ]
      },
      "conversations": {
        "title": "Conversations",
        "description": "Every recent conversation on every account, newest first, so a name typed at pal's root reaches the chat: the picture, the last line, the unread count or the To do, the latest messages and Wisp's summary in the pane.",
        "kind": "live",
        "lazy": true,
        "tier": "primary",
        "keys": [
          {
            "keys": "enter",
            "title": "Open the conversation"
          },
          {
            "keys": "cmd+enter",
            "title": "Mark read (unread on a read one)"
          },
          {
            "keys": "cmd+shift+r",
            "title": "Send the message typed after Tab"
          },
          {
            "keys": "cmd+t",
            "title": "To do (clear it on a To do)"
          },
          {
            "keys": "cmd+e",
            "title": "Done (archive)"
          },
          {
            "keys": "cmd+o",
            "title": "Open in Wisp"
          }
        ]
      },
      "new": {
        "title": "New Message",
        "description": "Write to anyone in Wisp's people, everyone you have talked with on every network: pick the person, then the account to write from (the conversation you already have with them first) and the message.",
        "kind": "input",
        "keys": [
          {
            "keys": "enter",
            "title": "Write to them (their conversation, or a new one)"
          },
          {
            "keys": "cmd+o",
            "title": "Open the person in Wisp"
          }
        ]
      },
      "conversation": {
        "title": "Conversation",
        "description": "One conversation to read and answer: Wisp's summary on top, the messages by day, theirs and yours, photos inline, a voice message's words, reactions, a mail's subject; a message field that sends on Enter, filled with Wisp's suggested reply on cmd+shift+d; a cursor over the messages to reply to one or react; follows new messages live. Opened bare, the newest in the Inbox.",
        "kind": "view",
        "keys": [
          {
            "keys": "enter",
            "title": "Send the message"
          },
          {
            "keys": "cmd+shift+s",
            "title": "Summarize it (Wisp's model)"
          },
          {
            "keys": "cmd+shift+d",
            "title": "Suggest a reply into the field"
          },
          {
            "keys": "cmd+up",
            "title": "The cursor to the previous message (cmd+down the next)"
          },
          {
            "keys": "cmd+r",
            "title": "Reply to the message under the cursor (cmd+backspace stops)"
          },
          {
            "keys": "cmd+shift+e",
            "title": "React to it"
          },
          {
            "keys": "cmd+t",
            "title": "To do (clear it on a To do)"
          },
          {
            "keys": "cmd+shift+t",
            "title": "To do tomorrow morning"
          },
          {
            "keys": "cmd+shift+w",
            "title": "Waiting on them"
          },
          {
            "keys": "cmd+e",
            "title": "Done (archive)"
          },
          {
            "keys": "cmd+u",
            "title": "Mark read or unread"
          },
          {
            "keys": "cmd+o",
            "title": "Open in Wisp"
          },
          {
            "keys": "cmd+shift+c",
            "title": "Copy the last message"
          },
          {
            "keys": "cmd+[",
            "title": "Older messages"
          }
        ]
      },
      "search": {
        "title": "Search Wisp",
        "description": "Every message on every account, in Wisp's search language: words as prefixes, \"phrases\", -exclusions, from:, in:whatsapp, is:unread, has:attachment, before: and after:.",
        "kind": "input",
        "keys": [
          {
            "keys": "enter",
            "title": "Open the conversation"
          },
          {
            "keys": "cmd+o",
            "title": "Open in Wisp at this message"
          },
          {
            "keys": "cmd+c",
            "title": "Copy the message"
          }
        ]
      },
      "accounts": {
        "title": "Wisp Accounts",
        "description": "Each account Wisp connects with its state (connected, degraded, needs setup) and unread count, the ones that need attention first.",
        "kind": "list",
        "lazy": true,
        "keys": [
          {
            "keys": "enter",
            "title": "Open the account in Wisp"
          },
          {
            "keys": "cmd+o",
            "title": "Its inbox in Wisp"
          }
        ]
      }
    },
    "states": {
      "unread": {
        "description": "Unread conversations, the number on Wisp's badge",
        "kind": "number"
      },
      "for_me": {
        "description": "Unread conversations with something meant for you: a mention, a reply in a thread you follow",
        "kind": "number"
      },
      "todo": {
        "description": "To dos that are due",
        "kind": "number"
      },
      "now": {
        "description": "Conversations waiting on your reply",
        "kind": "number"
      },
      "badged": {
        "description": "Unread from the people you gave a badge in Wisp, counted even where the account or the conversation does not count unread",
        "kind": "number"
      },
      "trouble": {
        "description": "Accounts that need attention: degraded, disconnected, waiting on setup",
        "kind": "number"
      }
    },
    "bar": {
      "inbox": {
        "title": "Inbox",
        "description": "Unread per network as each network's mark and count in the bar's own ink (or on a faint capsule, in their colours, or the font's glyphs; per network, per account, or one count after Wisp's glyph), a red @ count while something is meant for you, To dos that are due; a click on a network opens the popover on its tab, which is every account's inbox, unread first, with a chip per network: open a conversation, reply, mark read, To do or done without leaving it.",
        "refresh": {
          "every": 120,
          "on": [
            "show",
            "wake",
            "network"
          ]
        },
        "mocks": {
          "busy": {
            "title": "Unread on three networks",
            "item": {
              "segments": [
                {
                  "id": "whatsapp",
                  "icon": {
                    "image": "data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22%23000000%22%20stroke-width%3D%221.6%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M12%203.5a8.5%208.5%200%200%200-7.3%2012.8L3.5%2020.5l4.3-1.1A8.5%208.5%200%201%200%2012%203.5z%22%2F%3E%3C%2Fsvg%3E",
                    "template": true
                  },
                  "text": "2",
                  "tooltip": "WhatsApp: 2 unread"
                },
                {
                  "id": "gmail",
                  "icon": {
                    "image": "data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22%23000000%22%20stroke-width%3D%221.6%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M3.5%206h17v12h-17zM3.5%206.5L12%2013l8.5-6.5%22%2F%3E%3C%2Fsvg%3E",
                    "template": true
                  },
                  "text": "1",
                  "tooltip": "Gmail: 1 unread"
                },
                {
                  "id": "sms",
                  "icon": {
                    "image": "data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22%23000000%22%20stroke-width%3D%221.6%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22M4%204.5h16v11.5H9.5L4%2020zM8%209h8M8%2012h5%22%2F%3E%3C%2Fsvg%3E",
                    "template": true
                  },
                  "text": "1",
                  "tooltip": "SMS: 1 unread"
                },
                {
                  "id": "todo",
                  "icon": "󰅎",
                  "text": "1",
                  "tooltip": "1 To do due"
                }
              ],
              "tooltip": "WhatsApp 2, Gmail 1, SMS 1 · 1 To do due"
            }
          },
          "mention": {
            "title": "A mention waits",
            "item": {
              "segments": [
                {
                  "id": "for_me",
                  "icon": "󰁥",
                  "text": "1",
                  "color": "red",
                  "tooltip": "1 conversation with something meant for you"
                },
                {
                  "id": "slack",
                  "icon": "󰒱",
                  "text": "3",
                  "color": "violet",
                  "tooltip": "Slack: 3 unread"
                }
              ],
              "tooltip": "Slack 3\n#releases: Grace: @ana can you sign off 2.4?"
            }
          },
          "quiet": {
            "title": "Nothing unread",
            "item": {
              "hidden": true,
              "empty": {
                "icon": "󰚇",
                "tooltip": "Nothing unread"
              }
            }
          }
        },
        "settings": [
          {
            "kind": "select",
            "id": "split",
            "label": "Count",
            "description": "What the strip counts by: a glyph and count per network (two Gmail accounts are one Gmail), per account, or one count for everything.",
            "options": [
              {
                "id": "network",
                "title": "Per network"
              },
              {
                "id": "account",
                "title": "Per account"
              },
              {
                "id": "total",
                "title": "One count"
              }
            ],
            "default": "network"
          },
          {
            "kind": "boolean",
            "id": "uncounted",
            "label": "Every account",
            "text": "Count accounts that do not count toward Wisp's total too",
            "description": "Wisp lets an account stay out of the total (its Counts toward the unread total switch); on, the strip counts it anyway, as its own glyph.",
            "default": false
          },
          {
            "kind": "select",
            "id": "look",
            "label": "Look",
            "description": "Mono: each network's mark and count in the bar's own ink, the @ in red. Capsule: the same on a faint capsule that groups Wisp. Colour: each mark and count in its network's colours. Glyphs: the font's marks in the networks' colours. The marks are Wisp's own (each connector's brand logo where it has one), so a network Wisp gains shows up with its mark; in Mono and Capsule one without a filled logo takes the font's solid glyph, so every mark is the same kind. On the macOS menu bar the logos make each network a status item of its own; a click on a network opens the popover on its tab either way.",
            "options": [
              {
                "id": "mono",
                "title": "Mono"
              },
              {
                "id": "capsule",
                "title": "Capsule"
              },
              {
                "id": "colour",
                "title": "Colour"
              },
              {
                "id": "glyphs",
                "title": "Glyphs"
              }
            ],
            "default": "mono"
          }
        ],
        "rules": [
          {
            "id": "quiet",
            "when": "wisp.unread == 0 and wisp.todo == 0 and wisp.badged == 0",
            "description": "Nothing unread, nothing from a badged person and no To do due.",
            "hidden": true
          }
        ],
        "keys": [
          {
            "keys": "enter",
            "title": "Open the conversation (in the popover)"
          },
          {
            "keys": "space",
            "title": "Preview it"
          },
          {
            "keys": "r",
            "title": "Reply in a field"
          },
          {
            "keys": "m",
            "title": "Mark read (unread on a read one)"
          },
          {
            "keys": "t",
            "title": "To do (clear it on a To do)"
          },
          {
            "keys": "l",
            "title": "To do tomorrow morning"
          },
          {
            "keys": "e",
            "title": "Done (archive)"
          },
          {
            "keys": "w",
            "title": "Open in Wisp"
          },
          {
            "keys": "p",
            "title": "Open the inbox in pal"
          },
          {
            "keys": "tab",
            "title": "Next network (1 all, 2 to 9 each network)"
          },
          {
            "keys": "up",
            "title": "Move the cursor (down, j, k too; a click sets it)"
          }
        ]
      }
    },
    "links": {
      "open": {
        "description": "Open a conversation, or the inbox",
        "params": {
          "conversation": {
            "description": "A conversation's id, or words of its title; absent, the inbox"
          }
        }
      },
      "search": {
        "description": "Search Wisp",
        "params": {
          "q": {
            "description": "The query, in Wisp's search language"
          }
        }
      },
      "send": {
        "description": "Send a message into a conversation",
        "params": {
          "conversation": {
            "description": "A conversation's id, or words of its title",
            "required": true
          },
          "text": {
            "description": "The message",
            "required": true
          }
        }
      },
      "new": {
        "description": "Write to someone: New Message with a name typed",
        "params": {
          "to": {
            "description": "Words of the person's name, a number or an address"
          }
        }
      }
    },
    "store": {
      "tagline": "Every inbox you keep in Wisp, read and answered from pal",
      "category": "integration",
      "features": [
        "Every account Wisp connects (WhatsApp, Gmail, Slack, Telegram, SMS, Instagram, LinkedIn, X) in one list, under Wisp's own sections and views: Inbox, Now, To do, the Screener, All",
        "Any conversation reached by name from pal's root, and a new message to anyone in Wisp's people, from the account you choose",
        "A conversation to read and answer inside pal: messages by day, photos inline, reactions, a field that sends on Enter, new messages as they arrive",
        "Wisp's AI in the conversation: its summary on top, a suggested reply in the field on a key, a voice message's words; reply to one message or react to it",
        "To do, To do tomorrow, Waiting on them, Done and read or unread on a key, over many conversations at once",
        "One bar item: each network's mark and unread count in the bar's own ink, a red @ for mentions meant for you, a count under their own badge for the people you gave one in Wisp, To dos that are due; a click on a network opens its tab",
        "Its popover is the whole inbox, unread first, with a chip per network: open, preview, reply, mark read, To do or done without opening anything",
        "Wisp's search across every account, with from:, in:, is:unread and dates",
        "Each account's state, the ones that need attention first, on the strip's popover and in Wisp Accounts",
        "Follows Wisp's event stream, so the counts and an open conversation move as messages come in",
        "Built on Wisp's integration API with a token that acts as you; github.com/zcag/wisp"
      ],
      "permissions": [
        "network",
        "token"
      ],
      "platforms": [
        "macos",
        "linux"
      ],
      "screenshots": [
        {
          "file": "1-list.png",
          "caption": "Every account's inbox in one list, under Wisp's sections: the picture, the last line, the unread count in the network's colour, a To do that is due"
        },
        {
          "file": "2-detail.png",
          "caption": "The pane: the latest messages of the conversation, its account and what is unread"
        },
        {
          "file": "3-conversation.png",
          "caption": "Enter opens the conversation: messages by day, the photo inline, a field that sends on Enter; cmd+t makes it a To do, cmd+e marks it done"
        },
        {
          "file": "4-actions.png",
          "caption": "⌘K on a conversation: read or unread, send a message, To do, tomorrow, waiting on them, done, open in Wisp"
        },
        {
          "file": "bar-menubar.png",
          "caption": "On the menu bar: an @ count for mentions meant for you, each network's glyph with its unread count, the To dos that are due",
          "kind": "bar"
        },
        {
          "file": "bar-popover.png",
          "caption": "A click opens every inbox: unread first, then the To dos, then a line per read conversation, one chip per network with something unread; Enter opens, r replies, m marks read, t To do, e done",
          "kind": "bar",
          "box": [
            16,
            64,
            840,
            960
          ]
        },
        {
          "file": "bar-popover-conversation.png",
          "caption": "A group conversation in the popover, each sender named, answered without opening pal",
          "kind": "bar",
          "box": [
            16,
            64,
            840,
            960
          ]
        },
        {
          "file": "bar-sketchybar.png",
          "caption": "On sketchybar: the same counts, each network in its colour and the @ in red",
          "kind": "bar"
        }
      ]
    }
  },
  "playable": false,
  "updated_at": "2026-11-22T01:38:11Z",
  "url": "https://pal.cagdas.io/extensions/wisp",
  "tagline": "Every inbox you keep in Wisp, read and answered from pal",
  "category": "integration",
  "screenshots": [
    "https://pal.cagdas.io/extensions/wisp/screenshots/1-list-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/1-list.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/2-detail-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/2-detail.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/3-conversation-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/3-conversation.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/4-actions-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/4-actions.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-menubar-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-menubar.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-conversation-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-conversation.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-sketchybar-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-sketchybar.png"
  ],
  "panel_screenshots": [
    "https://pal.cagdas.io/extensions/wisp/screenshots/1-list.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/2-detail.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/3-conversation.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/4-actions.png"
  ],
  "bar_screenshots": [
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-menubar.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-conversation.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-sketchybar.png"
  ],
  "panel_screenshots_dark": [
    "https://pal.cagdas.io/extensions/wisp/screenshots/1-list-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/2-detail-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/3-conversation-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/4-actions-dark.png"
  ],
  "bar_screenshots_dark": [
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-menubar-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-conversation-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-popover-dark.png",
    "https://pal.cagdas.io/extensions/wisp/screenshots/bar-sketchybar-dark.png"
  ],
  "has_bar": true,
  "bar_items": [
    {
      "id": "inbox",
      "title": "Inbox",
      "description": "Unread per network as each network's mark and count in the bar's own ink (or on a faint capsule, in their colours, or the font's glyphs; per network, per account, or one count after Wisp's glyph), a red @ count while something is meant for you, To dos that are due; a click on a network opens the popover on its tab, which is every account's inbox, unread first, with a chip per network: open a conversation, reply, mark read, To do or done without leaving it.",
      "refresh": {
        "every": 120,
        "on": [
          "show",
          "wake",
          "network"
        ]
      },
      "refresh_words": "every 2 min, when the panel shows, on wake, when the network is back"
    }
  ],
  "has_links": true,
  "links": [
    {
      "route": "open",
      "url": "pal://wisp/open",
      "cli": "pal call wisp/open",
      "description": "Open a conversation, or the inbox",
      "params": [
        {
          "name": "conversation",
          "description": "A conversation's id, or words of its title; absent, the inbox"
        }
      ]
    },
    {
      "route": "search",
      "url": "pal://wisp/search",
      "cli": "pal call wisp/search",
      "description": "Search Wisp",
      "params": [
        {
          "name": "q",
          "description": "The query, in Wisp's search language"
        }
      ]
    },
    {
      "route": "send",
      "url": "pal://wisp/send?conversation=\u003cconversation\u003e\u0026text=\u003ctext\u003e",
      "cli": "pal call wisp/send conversation=\u003cconversation\u003e text=\u003ctext\u003e",
      "description": "Send a message into a conversation",
      "params": [
        {
          "name": "conversation",
          "description": "A conversation's id, or words of its title",
          "required": true
        },
        {
          "name": "text",
          "description": "The message",
          "required": true
        }
      ]
    },
    {
      "route": "new",
      "url": "pal://wisp/new",
      "cli": "pal call wisp/new",
      "description": "Write to someone: New Message with a name typed",
      "params": [
        {
          "name": "to",
          "description": "Words of the person's name, a number or an address"
        }
      ]
    }
  ],
  "multi": false,
  "has_readme": true
}
