# AI app tool reference

> Every tool Alloy offers a connected AI app, grouped by area, with what each one does.

An AI app sees only the tools its [permissions](/ai/get-started/permissions) allow. You don't call these yourself: the app picks them from what you ask.

## Shared rules

- Dates are `YYYY-MM-DD`, in your own time zone. A week runs Monday to Sunday.
- Each planned session has a slot id, such as `1-swim` or `6`, unique within its week. The week tools take it.
- Every change accepts `dry_run`, and returns a `change_id` that `undo_change` takes.

## The week

| Tool | What it does |
| --- | --- |
| `get_today` | Today's date, your time zone and today's sessions |
| `get_week` | A week's planned sessions, after moves and skips, with their slot ids |
| `get_session_workout` | A session's full workout |
| `get_week_recap` | A past week's recap |
| `move_session` | Moves a session to another day of its week |
| `swap_sessions` | Trades two sessions' days |
| `reset_move` | Puts a moved session back on its own day |
| `skip_sessions` | Skips one or more sessions, with a reason |
| `unskip_session` | Brings a skipped session back |

## The log

| Tool | What it does |
| --- | --- |
| `list_logs` | Logged sessions in a date range |
| `log_session` | Logs a session, planned or not |
| `update_log` | Changes a logged session |
| `delete_log` | Deletes a logged session |

## The program

Your routine lives in eras: a weekly plan and the Monday it starts.

| Tool | What it does |
| --- | --- |
| `list_eras` | Every era and the Monday it starts |
| `get_era` | One era's weekly plan |
| `save_era` | Saves a whole era |
| `patch_era` | Edits an era that hasn't started, as a JSON Patch |
| `delete_era` | Deletes an era |
| `start_era_from` | Changes the routine from a given Monday on |

## The season

| Tool | What it does |
| --- | --- |
| `list_events` | Your races, goals and other events |
| `save_event` | Adds or changes an event |
| `delete_event` | Deletes an event |
| `save_event_type` | Adds or changes an event type |
| `delete_event_type` | Deletes an event type |
| `set_season_plan` | Sets the season's phases |
| `get_ftp` | Your FTP |
| `set_ftp` | Sets your FTP |

## Fuel

| Tool | What it does |
| --- | --- |
| `get_fuel` | A day's meals and target |
| `estimate_meal` | Estimates a meal from a description in words |
| `log_meal` | Logs a meal |
| `update_meal` | Changes a logged meal |
| `delete_meal` | Deletes a logged meal |

## Health

These need the health permissions.

| Tool | What it does |
| --- | --- |
| `get_injections` | Your injections, the next site and when you're due |
| `log_injection` | Logs an injection |
| `update_injection` | Changes a logged injection |
| `delete_injection` | Deletes a logged injection |
| `manage_injection_sites` | Adds, renames, reorders or retires sites, and sets the cadence |
| `list_body_records` | Weigh-ins, DEXA scans and lab results |
| `save_body_records` | Saves records, or a Renpho, DEXA or lab CSV |
| `delete_body_record` | Deletes a body record |
| `get_readiness` | Readiness check answers |
| `set_readiness` | Records a day's readiness check |

## Drive

| Tool | What it does |
| --- | --- |
| `list_clips` | Your Drive clips |
| `add_clip_from_link` | Saves an Instagram post or reel, or a TikTok video, from its link |
| `update_clip` | Changes a clip's category or note |
| `delete_clip` | Deletes a clip |

## Strava

| Tool | What it does |
| --- | --- |
| `strava_status` | Whether Strava is connected, and how sessions arrive |
| `strava_sync` | Checks Strava now and logs what's new, as the live connection would |
| `strava_connect_link` | A link to connect Strava in Alloy |

## Changes

| Tool | What it does |
| --- | --- |
| `list_changes` | What connected apps changed in the last 30 days |
| `undo_change` | Puts a change back, unless something has changed the same record since |
