pull
Copy the structured feed into the local SQLite mirror.
alicli pull --json
alicli pull --full --json
alicli pull --follow --interval 60| Field or option | Meaning |
|---|---|
--full | Re-read from sequence zero. Existing message identities are upserted; the stored resume cursor never moves backward. |
--follow | Run incremental cycles until interrupted. Errors are logged and the loop continues. |
--interval N | Seconds between follow cycles, default 60. It is a delay after each cycle. |
--json | Return the one-shot summary on stdout. Follow mode emits cycle progress to stderr, not a final JSON snapshot. |
What is copied
Conversations, messages and available media bytes. The summary contains threads, newMessages, lastSeq, mediaFetched and mediaFailed. A failed media fetch is recorded and counted without aborting the message pull. HTML preview pages are rejected as media.
Historical gaps
Incremental reads start after the saved feed sequence. Use a separate pull --full to revisit missing historical rows or attachments. Combining --follow --full does not make every cycle full: follow mode runs incremental cycles.
A zero-message pull can mean a quiet source or a source that is not capturing messages. It is not an independent liveness proof. The store lock allows one pull owner; coordinate follow mode with other commands that need the store lock.