Fetch Tweets / aeon skill

AI agent that curates X and Twitter

Search and curate X/Twitter behind one selector - keyword, topic roundup, a single or tracked-account digest, an X list, or the AI-agent buzz preset - clustered into signal-scored sub-narratives.

CATEGORY BasicsRUNS Daily at 17:00 UTCUPDATED
Skill
Fetch Tweets fetch-tweets
Category
Basics
Default schedule
Daily at 17:00 UTC
cron 0 17 * * *
Last updated

commit e0895c4
Source
aeonfun/aeon/skills/fetch-tweets/SKILL.md MIT licensed, one prompt file

What it does

Fetch Tweets is an aeon skill: Search and curate X/Twitter behind one selector - keyword, topic roundup, a single or tracked-account digest, an X list, or the AI-agent buzz preset - clustered into signal-scored sub-narratives. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

This skill fetches X/Twitter content along one of five source axes and produces a curated digest - clustered by sub-narrative, ranked by signal, one insight per item - never a flat chronological dump.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

<source>:<arg> where <source> ∈ keyword | topic | account | list | agent-buzz. The <arg> is source-specific (a query, a topic, a handle, comma-separated list IDs, or an optional focus). If no source: prefix is given, the source is inferred from the shape of <arg> (see Source selector). Required for keyword and list; optional for topic, account, and agent-buzz.

What it needs

Besides the model you connected to aeon, Fetch Tweets uses the following. Add secrets as GitHub Actions secrets on your aeon repo, or in Aeon Connect.

  • XAI_API_KEY - optional secret, unlocks more data or features

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Fetch Tweets. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon fetch-tweets

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  fetch-tweets: { enabled: true, schedule: "0 17 * * *", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.