Jane Alesi
ad8c738160
Spec for full AI agent mobile control capability:
- Voice call control (dial/answer/hangup/status/list)
- App lifecycle management (install --url, update, permissions, grant, info)
- Device backup & restore (create/list/restore/app/verify, AES-256 encrypt)
- SMS send/delete + wait-reply via KDE Connect
- Audio control (volume/mute/route)
- Contacts management (list/add/export VCF)
56 tasks across 7 phases. TDD: fixtures → RED tests → GREEN impl.
Target: ≥130 BATS tests on completion.
Closes: specs/003-autonomous-agent-control/{spec,plan,tasks}.md
android-fs5
CLI toolset for managing the exone GmbH FS5 Android 9 device via ADB.
Device
| Property | Value |
|---|---|
| Model | exone GmbH FS5 |
| Serial | RD51QE202392 |
| Android | 9 |
| Storage | ~52 GB |
Requirements
| Tool | Version | Install |
|---|---|---|
| adb | 1.0.41+ | sudo pacman -S android-tools |
| bash | 5.x | pre-installed |
| python3 | 3.x | pre-installed |
Setup
cp .env.example .env
# Edit .env if your device serial differs
chmod +x fs5
Usage
Usage: fs5 <command> [options]
Commands:
status Show device health and info
push <src> <dst> Push file/dir to device
pull <src> <dst> Pull file/dir from device
app list List installed apps
app install <apk> Install APK on device
app uninstall <pkg> Uninstall package (requires --force)
shell [cmd] Execute shell command on device
logs Stream or capture logcat output
Global Options:
--json Output as JSON
--force Allow destructive/overwrite operations
--help Show help
Examples
# Device health check
./fs5 status
./fs5 status --json | python3 -m json.tool
# File transfer
./fs5 push ./report.pdf /sdcard/Documents/report.pdf
./fs5 pull /sdcard/DCIM/photo.jpg ./photo.jpg
./fs5 push ./file.txt /sdcard/file.txt --force # overwrite
# App management
./fs5 app list
./fs5 app list --all --json
./fs5 app install ./myapp.apk
./fs5 app uninstall com.example.app --force
# Shell access
./fs5 shell "df -h"
./fs5 shell "pm list packages | grep google"
# Log capture
./fs5 logs --lines 50
./fs5 logs --filter ActivityManager
./fs5 logs --lines 100 --output /tmp/device.log
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Device not found |
Configuration (.env)
DEVICE_SERIAL=RD51QE202392 # ADB device serial
LOG_FILE=./fs5.log # Operation log path
DEFAULT_PUSH_PATH=/sdcard/ # Default push destination
ADB_TIMEOUT=10 # ADB timeout in seconds
Testing
# Install test dependencies (once)
sudo pacman -S bats bats-assert bats-support shellcheck
# Run all tests
bats tests/
# Run specific test file
bats tests/test_status.bats
# Lint
shellcheck fs5 lib/adb.sh lib/output.sh
Operation Log
All mutating operations (push, pull, install, uninstall) are logged to fs5.log:
2026-03-02T15:43:00+01:00 PUSH /home/ja/file.txt -> /sdcard/file.txt [OK]
2026-03-02T15:44:00+01:00 INSTALL /tmp/app.apk [OK]
Project Structure
android-fs5/
├── fs5 # Main CLI entrypoint
├── lib/
│ ├── adb.sh # ADB wrapper functions
│ └── output.sh # Output formatting (human + JSON)
├── tests/
│ ├── test_status.bats
│ ├── test_transfer.bats
│ ├── test_app.bats
│ ├── test_shell.bats
│ └── test_logs.bats
├── specs/ # Spec-Driven Development artifacts
├── .env.example # Config template
└── README.md