Imported from XNet-NGO/aiope (AGENTS.md). Install upstream with npx skills add XNet-NGO/aiope. Copyright stays with the author.

AIOPE Development Loop

Environment

Build server (192.168.1.2)

• Hostname: build
• User: xnet-admin
• Linux x86_64, 8 cores, 15GB RAM
• Working directory: /home/xnet-admin/projects/
• Android SDK: ~/android-sdk (platforms 34-37, NDK 28, build-tools 33-36)
• Java: OpenJDK 21
• Go: 1.25 at /usr/local/go/bin/go
• Reachable from phone via LAN (192.168.1.x) or WireGuard

Repos

AIOPE Monorepo Structure

aiope/
├── app/                    # Android app module (MainActivity, Hilt, signing)
├── build-logic/            # Gradle convention plugins
├── buildSrc/               # Configurations.kt (versions, compileSdk)
├── core-data/              # Data layer
├── core-designsystem/      # Compose theme, icons, material deps
├── core-model/             # Shared models
├── core-navigation/        # Navigation
├── core-network/           # ProviderProfile, ModelDef, API clients
├── core-preferences/       # SharedPreferences
├── core-terminal/          # Proot, shell, JNI native libs
├── daemon/                 # aiope-remote (Go SSH daemon, multi-arch)
│   ├── *.go                # SSH server, exec, sftp, auth, health
│   └── scripts/            # build-installer.sh, installer-header.sh
├── docs/                   # AGENT_SYSTEM_SPEC.md
├── feature-chat/           # Main chat UI, agents, tools, streaming
│   ├── db/                 # Room (ChatDatabase, entities, migrations)
│   ├── di/                 # Hilt modules (ChatModule)
│   ├── engine/             # AgentExecutor, PipelineExecutor, StreamingOrchestrator, ToolExecutor, WorkManager
│   ├── settings/           # Settings screens (voice, MCP, profiles)
│   ├── theme/              # ThemeState, ThemePrefs, ThemeSettingsScreen
│   └── browser/            # BrowserPanel (WebView)
├── feature-remote/         # Remote server SSH deploy + tool bridge
│   ├── ssh/                # SshSessionManager, DeployUseCase
│   ├── db/                 # RemoteServerEntity, dao
│   ├── ui/                 # ServerListScreen, ViewModel
│   └── assets/             # aiope-remote-installer.sh (bundled)
├── gradle/                 # libs.versions.toml (dependency catalog)
└── spotless/               # ktlint config

Production gateway (inf.xnet.ngo)

• SSH: ssh ubuntu@inf.xnet.ngo
• Blue/green deploy: ~/aiope-gateway/deploy.sh
• Caddy reverse proxy, Docker containers

Device

• ADB over WiFi: adb connect 192.168.1.182:5555
• Pixel (Android 16, API 36)

Android App Build & Install

# Build AIOPE release
cd ~/projects/aiope
./gradlew :app:assembleRelease -x spotlessCheck -x spotlessKotlinCheck

# Install on device
adb install -r app/build/outputs/apk/release/app-release.apk

Build time: ~2 minutes (cached), ~4 minutes (clean).

Signing

• AIOPE: ../xnet-keystore/xnet.keystore (alias: xnet-key, pass: configured in keystore.properties)
• Pulse-AI: ../xnet-keystore/xnet-upload.keystore (alias: xnet-upload)
• keystore.properties is gitignored, must exist locally

Secrets

• secrets.properties in each Android repo root (gitignored)
• Contains GATEWAY_KEY=<api-key> compiled into BuildConfig

Gateway Deploy

ssh ubuntu@inf.xnet.ngo "~/aiope-gateway/deploy.sh"

Zero-downtime blue-green swap. Builds jar, swaps Caddy upstream, verifies health.

For hot-patching a single file:

scp src/main/kotlin/.../File.kt ubuntu@inf.xnet.ngo:~/aiope-gateway/src/main/kotlin/.../File.kt
ssh ubuntu@inf.xnet.ngo "~/aiope-gateway/deploy.sh"

aiope-remote (daemon)

Go SSH daemon deployed from AIOPE app to remote servers. The installer binary is bundled in the APK at feature-remote/src/main/assets/aiope-remote-installer.sh.

When daemon Go code changes, you must rebuild and rebundle before the Android build:

Build installer

cd ~/projects/aiope/daemon
GOBIN=/usr/local/go/bin/go bash scripts/build-installer.sh 0.1.0
# Output: daemon/dist/aiope-remote-installer.sh (7.3MB, multi-arch: amd64+arm64+arm)

# Bundle into APK assets
cp daemon/dist/aiope-remote-installer.sh feature-remote/src/main/assets/

# Then rebuild Android
cd ~/projects/aiope
./gradlew :app:assembleRelease -x spotlessCheck -x spotlessKotlinCheck

The installer is a self-extracting shell script: header (arch detection + systemd/openrc setup) + tar.gz payload (3 binaries + authorized_keys). On deploy, AIOPE SCPs it to the server via port 22, executes it, then connects to the daemon on port 2222.

Manual service management

systemctl status aiope-remote
sudo systemctl restart aiope-remote
journalctl -u aiope-remote -f

Listens on port 2222. Config at ~/.aiope/. Host key at ~/.aiope/host_key.

Spotless

# Check formatting
./gradlew spotlessCheck

# Auto-fix
./gradlew spotlessApply

# Skip during build
./gradlew :app:assembleRelease -x spotlessCheck -x spotlessKotlinCheck

Dev Loop

Every change follows this cycle:

1. Branch    → git checkout -b fix/description
2. Change    → make code changes
3. PR        → git push -u origin fix/description && gh pr create
4. Review    → review diff, verify logic
5. Build APK → ./gradlew assembleRelease
6. Serve     → APK served at http://192.168.1.2:3333/app-release.apk
7. Test      → install on device, verify fix works
8. Merge     → gh pr merge --merge --delete-branch
9. Release   → patch version bump, commit, tag, build final APK
10. Publish  → gh release create vX.Y.Z --target main app-release.apk

Rules:

• Never commit directly to main
• Every change gets a PR, even single-line fixes
• APK must be tested on device before merge
• After merge: bump buildSrc/.../Configurations.kt (patchVersion + versionCode), commit, push, build, release
• Release notes describe what changed in user-facing terms

Version bumps

# In Configurations.kt:
# patchVersion = N+1, versionCode = M+1

cd ~/projects/aiope
git add buildSrc/src/main/kotlin/Configurations.kt
git commit -m "chore: bump version to X.Y.Z (versionCode N)"
git push origin main
./gradlew assembleRelease
gh release create vX.Y.Z --title "vX.Y.Z" --notes "changelog" --target main app/build/outputs/apk/release/app-release.apk

Serving APKs for testing

A Python HTTP server runs on port 3333 from the APK output directory:

cd ~/projects/aiope/app/build/outputs/apk/release
python3 -m http.server 3333

Download from device: http://192.168.1.2:3333/app-release.apk