Skip to content

Claude assistant

The Claude bar runs on the Claude Code installed on this computer, through the Claude Agent SDK, and uses that installation's login. Usage counts against that account.

Set up

Install Claude Code and run claude once to sign in. MoTA looks for it in ~/.local/bin, ~/.claude/local or on PATH, or you can set mota.ai.claudePath.

What Claude can do

Claude works through MoTA's own tools:

  • Devices: list, info, screenshot, UI tree, log tail
  • Input: tap, swipe, text, keys, launch app, wake
  • Maestro: list, read and write flows, run one flow, start a test run, read results
  • Apps: install APK, clear data, uninstall

Claude can read files in the workspace, but it can write only inside the flows folder. It has no shell and no web access, and it loads none of your other Claude Code settings or connectors.

Permissions

Mode Behaviour
Ask once per task (default) Claude shows a plan card before acting on a device or changing files. After you approve it, small steps run without further prompts.
Ask only for data loss Claude acts without asking, except as below.
Read-only Claude only looks and explains.

Clearing app data, uninstalling and overwriting a flow always ask again, unless you chose Allow for this conversation. Devices outside the conversation's selection always ask. A replaced flow's previous version is saved in .mota/ai/flow-backups/.

Token budget

The token cap is a hard stop. As a guide:

Task Tokens
A quick action or question 5–15K
Diagnosing a failure 15–40K
A run summary 10–30K
Writing or fixing a flow 60–150K
Exploring the app 200K or more

Claude is also told its budget so it can pace itself. MoTA's short system prompt keeps a small task to about 2–10K tokens. Screenshots are shrunk so their longest side is at most mota.ai.screenshotWidth (960) pixels, which is about 500–1,300 tokens each.

Warning

Screenshots and logs go to Claude, so use test accounts on farm phones. The UI tree hides text typed into fields.

Android can't list the elements of a screen that keeps animating (could not get idle state). In that case Claude uses screenshots instead.