aivane-agent-android 0.1.8

Local-first Android UI automation CLI for the AIVane Android REPL beta

Python Client

This directory contains the publishable Python CLI package for the AIVane Android REPL beta.

Run

After installation, use the console script:

agent-android --help
agent-android --repl --url http://<device-ip>:8080
agent-android --health --url http://<device-ip>:8080

If the phone requires a shared token:

agent-android --repl --url http://<device-ip>:8080 --token YOUR_TOKEN

Set the environment variable AIVANE_API_TOKEN when you prefer not to pass the token on every command line.

Inside the REPL you can also persist it locally:

set token YOUR_TOKEN

For prepared multi-step flows:

agent-android --template template.json --url http://<device-ip>:8080
agent-android --template template.json --async --url http://<device-ip>:8080

For a workflow bundle with one main template plus child templates:

agent-android --application-bundle app.zip --main-template-file __main__.json --url http://<device-ip>:8080
agent-android --application-bundle app.zip --main-template-file __main__.json --async --url http://<device-ip>:8080

Async execution returns a taskId immediately. Poll or stop the task with:

agent-android --task TASK_ID --url http://<device-ip>:8080
agent-android --task-logs TASK_ID --url http://<device-ip>:8080
agent-android --stop-task TASK_ID --url http://<device-ip>:8080

For syncing templates, images, or other files from your computer to the phone:

agent-android --upload foo.json --remote-path Templates/foo.json --url http://<device-ip>:8080
agent-android --upload foo.json --remote-path Templates/foo.json --no-overwrite --url http://<device-ip>:8080

--upload overwrites by default. It uses the same phone-side token check as the other protected REPL endpoints.

Package Layout

• pyproject.toml: setuptools package metadata and console-script registration
• src/agent_android/: installable package source
• tests/: unit and device smoke tests

Notes

• The package uses a standard src layout under src/agent_android.
• The phone hosts the beta HTTP service locally and the client connects directly to http://<device-ip>:8080 by default. If the phone-side REPL settings use a different port, pass that port in --url.
• If a command cannot connect, first check whether the AIVane app or its local API service has exited on the phone, then retry /health.