Progress Status: HermesControl Android App

This document tracks the completed features and the pending backlog for the HermesControl Jetpack Compose Android application.

👥 Done (Implemented & Verified)

1. Base Infrastructure & Environment

Nix Flake Dev Environment (flake.nix): Fully configured with JDK 17, Android SDK (platforms 34-36), ktlint, and Gradle.
Scaffolding & Build Pipeline: Android Jetpack Compose project compiles cleanly using ./gradlew assembleDebug.
Code Formatting: Code formatting checks integrated using ktlint (./gradlew ktlintCheck).
Unit Testing Suite: Verified with ./gradlew test (AuthManager, EventParser, ConnectViewModel, ChatViewModel).
Network Capabilities: Cleartext traffic enabled in AndroidManifest.xml to allow connection to local networks (e.g., 192.168.1.18 to 192.168.1.48).

2. Implemented Features (~45 of 213 endpoints, ~21%)

Connection Screen (ConnectScreen): Saves Host, Port, and Auth Token to AuthManager (EncryptedSharedPreferences), with live verification via GET /api/status.
Chat Screen (ChatScreen): Live chat over WebSocket (JSON-RPC) supporting:
- Creating sessions, resuming sessions, listing sessions, and submitting prompts.
- Message token streaming, thinking delta indicator, and interrupting sessions.
- Basic Markdown-ish rendering (bold, code blocks) and expandable tool call indicators.
Skills Screen (SkillsScreen): Lists skills (GET /api/skills) and allows toggling them (PUT /api/skills/toggle) with auto-refresh and swipe-to-refresh. Toggles have optimistic state reversion on failure.
Cron Jobs Screen (CronJobsScreen): Lists cron jobs (GET /api/cron/jobs) with actions for Trigger, Pause, Resume, and Delete. Auto-refresh and swipe-to-refresh.
Gateway Control Screen (GatewayScreen): Integrates Start (POST /api/gateway/start), Stop (POST /api/gateway/stop), and Restart (POST /api/gateway/restart) with platform state reporting.
Profiles Management Screen (ProfilesScreen): Switch active profile, update soul personality description (PUT /api/profiles/{name}/soul), and switch AI model providers.
Toolsets Screen (ToolsetsScreen): List and toggle toolsets (GET/PUT /api/tools/toolsets) to enable/disable specific tool groups (e.g., Web Search, Python local run).
Achievements Screen (AchievementsScreen): Displays a gamified list of discovered/locked/unlocked achievements with progress bars (GET /api/plugins/hermes-achievements/achievements).
Settings Screen (SettingsScreen): Allows changing settings (Host, Port, Token, Theme, Auto-reconnect) and tests connection.
Navigation Drawer: Integrated Material3 navigation drawer using Navigation3 for switching screens.

⏳ Left (To Be Implemented)

All remaining 168 endpoints across the Hermes Dashboard API need to be implemented. The categories and their priority order are:

Priority 1: Model & Provider Management (3 endpoints)

List model providers (GET /api/model/providers)
Get and set recommended default model (GET/POST /api/model/recommended-default)
UI: Select model directly from a dropdown in Settings or Profiles.

Priority 2: Skills Hub & Editing (8 endpoints)

Browse hub, preview, install, uninstall, update skills.
Create/edit custom skills by editing their raw YAML/markdown files (GET/PUT /api/skills/content).

Priority 3: Advanced Sessions & Search (8 endpoints)

Search through session transcripts.
Delete sessions in bulk, prune empty sessions, export session transcripts.
Get session statistics.

Priority 4: Cron Creation & Blueprint Instantiation (3 endpoints)

Form/UI to create new Cron Jobs (POST /api/cron/jobs).
Form/UI to update Cron Jobs (PUT /api/cron/jobs/{id}).

Priority 5: Kanban Plugin (46 endpoints)

Full Kanban task boards, lists, cards, comments, attachments.

Priority 6: Other Administrative Tools

Env vars management, webhooks, system backup/restore, credential storage.

4.0 KiB Raw Blame History