Skip to content

Driving an Agent

Brian Jr edited this page Nov 17, 2026 · 1 revision

3 · 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 in TccLookSpec.kt, colors in TccLookColors.kt, and — if it has them — its renderers in ui/components/looks/). The vibe is <describe: colors, mood, font feel, card/tile/gauge shapes>. Steps: add the TccUiLook value + label; add colors in resolveLookColors; (add a font if needed, with a THIRD_PARTY_NOTICES.txt entry); create <Name>LookSpec and map it in specForLook; 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 in docs/overlay-look-ui-audit.md and 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 overlay

Dark 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

Clone this wiki locally