# Poke

> Save only your configured Poke conversation from macOS Messages.

Hansard reads the one-to-one conversation with Poke's number in macOS
Messages. Poke has no single number that everyone texts, and the number can
differ for each messaging channel. Use the number that Poke texts you from in
Messages. Capture stays off until you enter it under **Poke number** in
**Settings → Imports → Messages assistants** and select **Save number**.

You can also configure it from the CLI. Replace the synthetic example with
the number, including its country code:

```sh
hansard config set imports.pokeHandle "+12025550104"
hansard import --source poke --since all
```

If source selection is Custom, enable Poke in the Agents list. The watcher
checks the configured conversation on its polling cadence. To stop future
capture, clear **Poke number** and select **Save number**, or run
`hansard config unset imports.pokeHandle`.
Previously archived history stays available.

Poke uses the same Messages reader as [Instinct](https://www.hansard.dev/imports/instinct/). The reader
captures text, message times, reactions, observed edits and unsends, reply
references, link previews, and available attachments from iMessage, RCS, and
SMS chats with that number. One number remains one continuous Hansard
conversation. Poke's recipes, integrations, models, measured tokens, and
billing information are unavailable in Messages.

Only selected rows and selected attachments enter the archive. Hansard never
archives the Messages database, other chats, or group conversations, even a
group that includes Poke. Offline rebuild uses the preserved selection.
Attachments larger than 16 MiB, missing files, and iCloud-offloaded files
retain a descriptor with an explicit reason. Hansard does not download
offloaded files.

Capture from the Messages store on a Mac has not been verified yet. Do not
grant Full Disk Access to your terminal for it.

Poke conversations in WhatsApp and Telegram are not imported.
