Work recap: scopes & troubleshooting

Saving Slack & Linear tokens

In the app, use Save tokens now to store your Slack token, optional Linear API key, and Slack user id field in an AES-256-GCM encrypted row keyed to your user id (server secret CREDENTIALS_ENCRYPTION_SECRET, same as Dev Inbox credentials). Or enable after a successful generate to refresh that vault automatically. Clear saved removes them from the server; your browser fields clear too.

What it includes

• Slack: search (with optional query override), automatic fallback to crawl when search is not allowed for your token, or crawl-only; optional channel filter; messages grouped by channel with timestamps and links when search provides them.
• Linear: issues assigned to you with updates in the range; issue history lines list substantive changes (state, assignee, labels, priority, etc.), not only workflow moves.
• Output: a reference weekly-email template, totals, and a suggested prompt for an AI pass; optional structure instructions (textarea in the app) tailor the header and that suggestion.

Saved recaps

When “Save recap to my account” is enabled (default), each run stores the Slack-only markdown, optional Linear-only markdown, and the full combined file as plain text in your applib account so you can download or revisit older exports. No API tokens are persisted—only generated markdown.

Slack token

Best option is a Slack user token (xoxp-…) for your own account. Add these OAuth scopes to your Slack app and reinstall the app to the workspace:

• Required (search): search:read.public
• Usually needed: search:read.im, search:read.mpim
• Private channels: search:read.private
• Optional: search:read.files

Bot token (xoxb-…)

Some workspaces return not_allowed_token_type for search.messages with a bot token. Prefer a user token, or set mode to crawl and provide your Slack user id (U…). Crawl mode typically needs: public channels channels:read, channels:history; private groups:read, groups:history (and the app in the channel); DMs im:read, im:history; group DMs mpim:read, mpim:history.

Linear

Optional: a Linear personal API key (lin_api_…). The recap lists issues assigned to you that were updated in the time window, with issue history in that window summarized as human-readable lines (including state changes plus assignee, labels, priority, and similar fields when present).

Troubleshooting

• missing_scope / incomplete results: add the missing search:read.* scopes and reinstall the Slack app.
• Search can cap results (often around 1k). Narrow the window, add a channel filter, or split by date in the override query.
• from:me works best with a user token. With a bot token, set your Slack user id so the query can use from:<@U…>.