get-started

# Get started with Aeon Aeon is an agent that runs skills on a schedule with GitHub Actions in the user's own GitHub repo. This plugin connects to their Aeon agent through Aeon Connect (`https://www.aeon.fun/connect/mcp`). ## 1. Check the connection Call `list_skills`. - **It works:** go to step 2. - **It asks to sign in, or fails with an auth error:** tell the user to connect Aeon (sign in with GitHub, then pick their agent on the "Connect an app" screen), then try again. - **They have no agent yet:** send them to https://www.aeon.fun/connect to create one (about two minutes: sign in with GitHub, create the repo, connect a model). Then connect the plugin again. The connection works on one agent repo at a time. If the user allowed switching when they connected, `list_instances` shows their other Aeon repos and `switch_instance` moves to one. Only bring this up if they have more than one agent or ask about another repo. ## 2. Show what the agent does and what it still needs From the `list_skills` result, tell the user in a few lines: - which repo the plugin is connected to, - how many skills are on, and the schedule of each one that is on, - two or three skills that are off and look useful, with one line each. Keep it short. Do not list every skill. Then call `setup_status`. If a model is not connected, or enabled skills are missing API keys, name what is missing and say where to add it: the Keys tab for this agent at https://www.aeon.fun/connect. `setup_status` gives key names only. Never ask for the values. ## 3. Run one skill If a model is connected, offer to run `heartbeat` (a quick check that the agent works; it needs no setup). If the user agrees: 1. Call `run_skill` with `skill: "heartbeat"`. 2. Follow the run. Some apps show a live runs view right in the chat; otherwise call `get_run` with the returned `run_id` every so often until `status` is `completed`. A run takes one to ten minutes; tell the user it is running and keep the chat useful meanwhile. 3. If it succeeded, call `read_output` with `skill: "heartbeat"` and summarize what it found in a few lines. 4. If it failed, `get_run` gives the likely reason (most often the model login is missing or expired). Explain it and the fix in plain words, and point to https://www.aeon.fun/connect to fix it. If there is no `heartbeat` skill, offer any skill that is on instead. If no model is connected, skip this step and point back to the missing model from step 2. ## 4. Next steps Tell the user what they can ask from now on, for example: - "Turn on the digest skill every morning at 8" - "Did anything fail today? Why?" - "Show me what my last digest found" - "What has my agent written down about this week?" - "Add 'grow the newsletter' to my strategy" - "What skill packs can I add?" - "Open my Aeon dashboard" ## Rules - `update_skill`, `update_strategy`, `update_soul`, `install_pack` (it opens a pull request), `switch_instance`, `update_instance_settings` and the settings switches change the user's setup. Say what will change and get a yes before calling them. - Never ask for API keys, tokens or secrets. `setup_status` shows key names only; keys are added in Aeon Connect, not in chat. - If an Aeon tool fails or answers wrong, `send_feedback` reports it to the Aeon team (pass `run_id` for a failed run). Tell the user what you sent; never include secrets.