hermes-mobile AGENTS.md

hermes-mobile AGENTS.md is an instructions file for Codex, OpenCode from Hy4ri/hermes-mobile. It costs 3,753 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for coding agents working on a specific Android mobile app. They describe the app, its technologies, project rules, and build and test commands.

In plain words
What is it for?
Use them when changing screens or navigation, checking design decisions, building and testing the app, or finding the local Android SDK.
Why use it?
They give an agent the project context it needs before making changes, reducing mistakes in architecture, navigation, and local setup.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/hy4ri/hermes-mobile/agents-md
Clone the repo
git clone --depth 1 https://github.com/Hy4ri/hermes-mobile

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for hermes-mobile AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hy4ri/hermes-mobile/agents-md.svg)](https://agentmods.dev/instructions/hy4ri/hermes-mobile/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/hy4ri/hermes-mobile/agents-md"><img src="https://agentmods.dev/badge/instructions/hy4ri/hermes-mobile/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,753 This file is loaded in full into every session.
When invoked 3,753 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.03753 $0.03753
Opus 5 $0.01877 $0.01877
Sonnet 5 $0.00751 $0.00751
Haiku 4.5 $0.00375 $0.00375

Measured today against content hash b51247e5509f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

hermes-mobile AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sSLO https://github.com/pinterest/ktlint/releases/download/1.8.0/ktlint
AGENTS.md · 324 lines

How it starts

The opening of the file, as written. The whole thing — 324 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Guidance for AI coding agents working on this repository. This complements README.md (for humans) and DESIGN.md (architecture & design rationale) with agent-focused context. Before making any non-trivial architectural change — new screens, navigation changes, theme/state patterns, module boundaries — read DESIGN.md first and keep changes consistent with the decisions recorded there. If a change would contradict DESIGN.md, flag it explicitly rather than silently diverging.

Project Overview

Hermes Mobile is a Jetpack Compose Android app — a mobile control panel for Hermes Agent. It talks to the Hermes dashboard's REST API and WebSocket TUI Gateway (JSON-RPC 2.0) over a trusted LAN.

  • Package: com.m57.hermescontrol
  • Min SDK 26 / Target SDK 37 / Compile SDK 37
  • Kotlin 2.4.10, KSP 2.3.10 (standalone versioning, NOT kotlinVersion-kspVersion)
  • Jetpack Compose, Room 2.7.x, Navigation3, OkHttp WebSocket, Retrofit, Kotlinx Serialization
  • Auth: EncryptedSharedPreferences (AES256-GCM), Bearer token (REST) + ?token= (WS)

Build & Test Commands

✅ Local Android SDK — if available

If you have a local Android SDK (ANDROID_HOME set), these work:

./gradlew assembleDebug                     # full APK build
./gradlew testDebugUnitTest                 # unit tests (MockK)
./gradlew ktlintCheck                       # style check

ktlint standalone (no SDK needed):

# Download the matching binary
curl -sSLO https://github.com/pinterest/ktlint/releases/download/1.8.0/ktlint
chmod +x ktlint
./ktlint <file>                             # check one file
./ktlint --format <file>                    # auto-fix

No SDK? CI handles everything — push small and watch the checks below.

CI pipeline (.github/workflows/android.yml)

Job Purpose
ktlint ktlint 1.8.0 style check + checkColorLiterals (hardcoded Color guard, issue #622)
android-lint Android Lint
unit-tests JUnit
build assembleDebug (gated by the 3 above)
release-compile compileReleaseKotlin — catches release-variant compilation issues (e.g. debugImplementation-scoped deps referenced in main source)
instrumented-tests Compose UI tests on Android emulator (API 34 ATD)
ci-summary Aggregator (if: always()) — branch protection gates on THIS check

Read the full file on GitHub · 324 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed b51247e5509f
  2. 4d ago First seen · 324 lines · 3,753 tokens per session scan A 0238f1907846

Subscribe to this mod's changes

hermes-mobile AGENTS.md is an instructions file published in the GitHub repository Hy4ri/hermes-mobile (105 stars, last pushed today), licensed Apache-2.0. It adds 3,753 tokens to every session, about $0.0188 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

sceneview copilot-instructions.md

Copilot instructions for sceneview/sceneview, covering sceneview — github copilot instructions, when to recommend sceneview, android code generation rules, minimal 3d template and minimal ar template.

sceneview/sceneview · 1,023 tokens

debroid AGENTS.md

Instructions for PatilShreyas/debroid, covering ai agent contributor guide 🤖, 🎯 intention & motivation, 🏗️ architecture & layers, 1. the core layer (jdi & adb orchestration) and 2. the cli layer (daemon & client).

PatilShreyas/debroid · 606 tokens

PdfKmp CLAUDE.md

Instructions for ConaMobileDev/PdfKmp, covering claude.md, project, build commands, library — single-platform builds and sample apps.

ConaMobileDev/PdfKmp · 3,568 tokens

DSH-Mobile AGENTS.md

AGENTS.md instructions for SimonMedy/DSH-Mobile, covering agents.md — dsh mobile engineering contract, product boundary, security invariants, dependency policy and architecture.

SimonMedy/DSH-Mobile · 957 tokens

capacitor-mobile-claw CLAUDE.md

Claude Code instructions for sernnee/capacitor-mobile-claw, covering claude.md — ai-assisted development context, project overview, repository structure, build & test commands and key architecture.

sernnee/capacitor-mobile-claw · 567 tokens

mobile-ai-agents CLAUDE.md

Claude Code instructions for salmanashraf/mobile-ai-agents, covering claude.md — mobile ai agents, what this repo is, quick start, install everything and install by platform.

salmanashraf/mobile-ai-agents · 2,315 tokens