Agile Alert Support

Getting Started

You will need your Octopus Energy Account number and an API key.

To get your Octopus Energy account number, log in to your Octopus Energy Dashboard. Your account number is shown under your name and looks something like A-34H8J3V4.

To get your Octopus Energy API key, navigate to the Personal Details section under the account number in your Octopus Energy Dashboard, and select API Access under Developer settings. You can view or generate a new key there to use for Agile Alert.

You can only view the API key at the moment it is created. If you did not save it, you must generate a new one, which will invalidate the old one.

Agile Alert Setup

In Settings, choose Configure account, then enter your Octopus account number and API key.

Use Validate to check the account details. When validation succeeds, Agile Alert can discover active import, gas, and export tariffs and update the selected region from the tariff codes it finds.

On the settings page you can also choose whether you use gas, have solar PV, or have battery storage so the dashboard only shows the comparisons that matter to your home.

Settings are designed to sync through your own iCloud account when iCloud is available so you should only have to set them once to cover all of your devices that run the app.

Tariffs and Comparisons

• ImportUse your account tariff, a public Octopus tariff code, or a manual price for comparison.
• GasTurn on gas support to compare Agile import rates against your gas tariff or fallback manual rate.
• ExportUse an export tariff or manual export value to judge whether importing is better than using stored or exported energy.
• VATSet the VAT percentage applied to electricity bills.

Alerts

The Alerts tab controls local notifications. You can be notified when import prices go negative, fall below your chosen threshold, become cheaper than gas, or when tomorrow's daily price summary is available.

Lead time can be adjusted from 0 to 120 minutes in five-minute steps. Notifications are scheduled on each device from the latest prices and the settings synced to that device.

Solar PV and Battery

If you have solar PV, choose a home location and installed capacity in kW. Agile Alert uses WeatherKit when available, with fallback behaviour when live weather forecasts are unavailable.

Battery storage enables additional dashboard markers for import-versus-export decisions.

Apple Watch

On Apple Watch, Agile Alert on iOS can show the current import rate and a compact rate table, with a circular complication for quick price checks.

AppleScript Interface

The macOS version of Agile Alert includes AppleScript commands for reading import rates, refreshing cached prices, and managing alert settings. Commands are sent to the running Agile Alert application. Here is an example:

tell application "Agile Alert"
    current import rate
    future import rates 8
    cheapest import rate
    refresh import rates
    alert settings
    set threshold alert value 10.5
    set alert lead time 15
end tell

Agile Alert AppleScript Commands

• current import rate Returns the current import rate in pence per kWh.
• future import rates Returns known current and future import rate slots. Pass an optional number to limit the results.
• cheapest import rate Returns the cheapest known upcoming import rate slot.
• refresh import rates Refreshes import rates, updates the local cache, and reschedules alerts.
• alert settings Returns threshold, enabled alert categories, lead time, and whether any alerts are enabled.
• alerts enabled Returns true when at least one alert category is enabled.
• set threshold alert value 10.5 Sets the below-threshold alert value in pence per kWh and returns the saved value.
• set alert lead time 15 Sets the number of minutes before a rate slot that alerts should fire.
• enable alerts Enables all supported alert categories.
• disable alerts Disables all supported alert categories.

Automation Notes

Rate commands need enough tariff information to load prices. If Agile Alert is still starting up, no rates are available, or a script passes an invalid value, the app returns an AppleScript error.

Refreshing prices also updates the dashboard cache and reschedules notifications using your current alert settings.

For Agile Alert support, email Hexela with a short description of the issue and the platform you are using: iPhone, iPad, Mac, or Apple Watch.

If you are reporting a bug, it helps to include your iOS, iPadOS, macOS, or watchOS version, whether you connected an Octopus account, and the steps you took before the problem appeared.

Before You Write...

• Account validation failsCheck that both the Octopus account number and API key are complete, current, and copied without extra spaces.
• Prices are unavailableConfirm the import tariff is configured and try refreshing after the main dashboard has loaded.
• Alerts do not arriveCheck notification permission on the device and confirm the relevant alert category is enabled.
• Solar forecast is missingThe app still works for pricing alerts when WeatherKit is unavailable; check location and solar settings first.