Repository navigation
Driving an Agent
Give the agent the theming guide, a template Look to mirror, and the ability to build + screenshot. A good prompt:
Add a new overlay Look called "" to this repo. Follow
GUIDELINE.md. Mirror<ClosestExistingLook>as a template (its spec inTccLookSpec.kt, colors inTccLookColors.kt, and — if it has them — its renderers inui/components/looks/). The vibe is <describe: colors, mood, font feel, card/tile/gauge shapes>. Steps: add theTccUiLookvalue + label; add colors inresolveLookColors; (add a font if needed, with aTHIRD_PARTY_NOTICES.txtentry); create<Name>LookSpecand map it inspecForLook; build:app:assembleDebug, install on device , set the Look (see below), and screenshot both overlay tabs and the companion in dark and light. Then run the audit indocs/overlay-look-ui-audit.mdand fix any contrast/clipping it finds.
To switch the Look for screenshots without tapping through the UI, write the pref directly (debug build is jr.brian.commandpannel.debug):
adb -s <serial> shell am force-stop jr.brian.commandpannel.debug
# shared_prefs/command_panel.xml → <string name="overlay_look">MY_LOOK</string>
adb -s <serial> shell run-as jr.brian.commandpannel.debug cp /data/local/tmp/prefs.xml shared_prefs/command_panel.xml
adb -s <serial> shell am start -n jr.brian.commandpannel.debug/jr.brian.commandpannel.MainActivity
adb -s <serial> shell am broadcast -a jr.brian.commandpannel.action.SHOW_OVERLAY -p jr.brian.commandpannel.debug
adb -s <serial> exec-out screencap -p -d <bottom-display-id> > look.png # bottom screen = the overlayDark vs light is Settings.System tcc_theme_mode (1 = follow night, 3 = light, else pure black).
There is no Compose @Preview in this project — the agent must verify on a device/emulator.
Next: Gotchas