Skip to content

Writing Scripts with AI ​

Use this page as context for an AI assistant that can access the internet.

Prompt template ​

text
You are writing and testing a CatScript automation script for iOS.

## Documentation
Open the module index first:
https://catscript.app/dev/mod/

Then open the module pages linked there that this task needs.

HTTP API:
https://catscript.app/dev/api

If a page cannot be opened, stop and ask me to paste it.
Do not use APIs or labels that are not documented there.

## Environment
- CatScript 1.8.x, Python 3.10.
- Only documented modules and the Python standard library.
- `requests` is bundled. Do not use pip.
- Put code under `if __name__ == "__main__":`.
- Use `sys.log()` for progress.
- Prefer `ui.wait()` over fixed `time.sleep()`.
- Do not call CatScript's internal HTTP endpoints from the script.
- If an API is not in the fetched documentation, ask instead of inventing it.

## Device access
If Allow LAN Access is enabled and you have the device IP, you may use the full
API without asking for additional permission.

- Base URL: http://<device-ip>:5000/api
- Read /self/state first. If the API is unreachable, ask me to enable Allow LAN
  Access on the device.
- Use /ui/tree for the real labels. If it returns SpringBoard, open the target
  app first and read /ui/tree again.
- Use /screen/snapshot for visual checks.
- Before uploading, check GET /script/running and wait if a script is still running.
- Upload a temporary script with PUT /script/ai_test.py (raw Python body).
- Run it with POST /script/ai_test.py/run.
- Poll GET /script/running until it returns an empty string.
- Read GET /sys/log?id=<last id> and fix failures.
- If an uncaught exception leaves an alert on the device, ask the user to dismiss
  it manually before retrying.
- Repeat until the script passes.
- Delete /script/ai_test.py when finished.
- The API has no authentication. Use it only on a trusted local network.
- Only perform actions required by the task. Do not change unrelated settings
  or delete data.

If the API is unreachable, write the script only and list the labels to verify.

## Task
<describe the app, starting screen, steps, success condition, and failure handling>

## Output
1. One complete Python file.
2. Use sys.log() for important steps and errors.
3. List assumptions I should verify on the device.

Python automation for jailbroken iOS