Tavily, Notion, and Slack

All three are optional. A setup with only X credentials and an LLM still fetches, builds a persona, and generates drafts.

Tavily

Key: TAVILY_API_KEY from tavily.com.

Command	What it calls
`tf search`	Tavily Search. `--news` switches the topic to news.
`tf enrich`	Tavily Extract for ordinary URLs. X-hosted articles use the X API instead.
`tf generate --timely`	One news search, last 7 days, 5 results, folded into the prompt.
`tf cron`	Calls enrich. Without the key, cron errors after the fetch. Use `tf refresh` instead.

Search defaults: general topic, 5 results, basic depth, an answer summary included. News searches default to 7 days.

Human required. Creating the Tavily account and pasting the key.

Verify. tf search "tweet-factory" --max 1 prints a result list.

Notion

Key: NOTION_API_KEY, an internal integration secret from notion.so/my-integrations.

Human required. Create the integration, copy the secret, and share each page or database with the integration. Unshared pages are invisible. tf notion search only returns what that share allows.

Commands are search, tag, untag, list, and sync. See Commands. The onboarding TUI can search and tag too (n on the forge screen).

Tagged pages are stored in tweets.db with your label and an optional note. tf generate includes them as reference material (roughly 1,500 characters per page, 6,000 overall) and is told to use the tag as a hint — voice, product facts, or idea seeds — rather than quoting the page. tf cron syncs pages whose last-edited time changed.

Verify. tf notion search lists at least the pages you shared. tf notion tag <id> --tag voice then tf notion list shows that tag.

Slack

Key: SLACK_WEBHOOK_URL, an incoming webhook.

Path	Behavior
`tf notify <file> [header]`	Posts the file, split around 3,500 characters, as webhook text.
`tf generate --post-to-slack`	Writes the drafts file, then notifies.
`tf cron`	If the pending count is above zero, posts a one-line ping telling you to run `tf generate`. It does not attach drafts.

No webhook: tf notify logs a skip and returns. Cron stays quiet.

Human required. Create the webhook in Slack and paste the URL.

Verify. printf 'hello from tf\n' > /tmp/tf-slack.txt && tf notify /tmp/tf-slack.txt "tf setup check" posts that one line. Delete the Slack message if the channel is shared.