dogfood
callstackincubator/agent-device
Systematically explore and test mobile apps on iOS/Android to find bugs and UX issues.
What is dogfood?
Dogfood is a router for exploratory QA that uses agent-device to test mobile applications. Use it when you need to perform QA testing, bug hunting, or exploratory testing on iOS or Android apps.
- Systematically explore mobile app flows on iOS and Android platforms
- Capture snapshots and screenshots during testing to document behavior
- Identify and report bugs, UX issues, and other problems found during runtime
- Generate structured findings with evidence from actual app execution
- Provide guided workflow for exploratory testing sessions
How to install dogfood
npx skills add https://github.com/callstackincubator/agent-device --skill dogfood- agent-device CLI binary (version 0.14.0 or higher) exposed on PATH or available via npx
- Access to a target mobile app on iOS or Android
- Device or simulator configured for testing
How to use dogfood
- 1.Verify agent-device is installed and meets minimum version requirement by running: agent-device --version
- 2.Read current CLI guidance with: agent-device help dogfood
- 3.Open the target app on the device or simulator
- 4.Take initial snapshot and screenshot to establish baseline state
- 5.Systematically explore app flows and features
- 6.Capture evidence (snapshots, screenshots) for each issue discovered
- 7.Document findings with the structured format provided by the CLI
- 8.Close the app when testing is complete
Use cases
- Finding bugs and UX issues in a mobile app before release
- Performing exploratory QA testing on iOS or Android applications
- Conducting bug hunts to identify edge cases and unexpected behavior
- Testing app flows and user interactions on real or simulated devices
- Documenting issues with screenshots and snapshots as evidence
- QA engineers and testers
- Mobile app developers
- Product managers reviewing app quality
- Teams performing pre-release testing
dogfood FAQ
agent-device version 0.14.0 or higher is required. Older versions lack necessary help topics and workflow guidance.
Ensure agent-device is available on PATH by running: agent-device --version. If it fails, expose a trusted agent-device binary on PATH or approve an exact-version npm command.
Dogfood supports testing on both iOS and Android platforms. You can infer the platform from the app or specify it when starting a testing session.
Use the snapshot and screenshot commands to capture evidence of each issue. The CLI will guide you on the exact report format and evidence commands needed.
No, dogfood is designed for exploratory QA and manual testing. Findings must come from runtime behavior observed during interactive testing sessions.
Full instructions (SKILL.md)
Source of truth, from callstackincubator/agent-device.
name: dogfood description: Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile. allowed-tools: Bash(agent-device:), Bash(npx agent-device:)
Dogfood
Router for exploratory QA. Private setup before using this skill:
agent-device --version
If that fails, stop and tell the user to expose a trusted agent-device binary on PATH or approve an exact-version npm command. This skill intentionally keeps allowed tools restricted to agent-device and npx agent-device.
Require agent-device >= 0.14.0; older CLIs lack these help topics. If older, stop and tell the user to upgrade the trusted install or approve an exact-version npm command. Do not run npm install -g agent-device@latest or npx -y agent-device@latest autonomously, and do not include version/upgrade commands in final plans.
Read current CLI guidance:
agent-device help dogfood
Loop: open app -> snapshot -i + screenshot -> explore flows -> capture evidence per issue -> close.
Target app is required; infer platform or ask. Findings must come from runtime behavior, not source reads. Let help dogfood provide exact report shape, evidence commands, and current workflow guidance.
Related skills
More from callstackincubator/agent-device and the wider catalog.
agent-device
Automate iOS, tvOS, macOS, and Android device interactions—tap, type, scroll, screenshot, and extract UI data.
react-devtools
Inspect and profile React Native component trees, props, state, hooks, and render performance.