# Verify

> Build, relaunch, and observe the Claudence menu bar app to verify a change end-to-end.

- Skill: `mark-in-motion/verify` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mark-in-motion/verify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mark-in-motion/verify/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Mark-in-Motion (https://skillmd.com/u/mark-in-motion)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/mark-in-motion/verify

---


# Verifying Claudence changes

Claudence is a macOS menu bar app (SwiftUI, Xcode project + SwiftPM package in the same repo).

## Build

- Unit-test/compile loop: `swift build` and `swift test` from the repo root (fast, seconds).
- Real app bundle: `xcodebuild -scheme Claudence -configuration Debug build`
  (single scheme `Claudence`; output lands in
  `~/Library/Developer/Xcode/DerivedData/Claudence-*/Build/Products/Debug/Claudence.app`).

## Relaunch

The user usually has a Debug instance running from DerivedData. To swap in a new build:

```bash
pkill -x Claudence; sleep 1; open ~/Library/Developer/Xcode/DerivedData/Claudence-*/Build/Products/Debug/Claudence.app
```

Keychain session key (`com.claudence.session` / `default`) survives relaunch; the app fetches live usage within seconds of launch.

## Observe (no accessibility access needed)

The popover can't be opened programmatically (osascript lacks assistive access), but the app persists everything it renders:

- Current snapshot: `~/Library/Application Support/Claudence/Snapshots/current_snapshot.json`
  (also `last_known_good_snapshot.json`; check `fetchedAt` to confirm a fresh live fetch happened after relaunch)
- History: `~/Library/Application Support/Claudence/History/usage_history.json` (appended on each live fetch)
- Diagnostics/errors: `~/Library/Application Support/Claudence/diagnostics.json`
- Settings: `~/Library/Application Support/Claudence/settings.json` (session key is NOT here, it's in the Keychain)

For UI-only changes, ask the user to click the menu bar icon and screenshot — programmatic capture is blocked without accessibility + screen-recording permissions.

## Gotchas

- `grep --include=*.swift` fails under zsh globbing; quote it or use `-r ... --include "*.swift"`.
- Reading the keychain item from a script triggers a blocking permission dialog — don't; let the app do the fetch and read its output files instead.