Reference for all environment variables recognized by Tapsmith.
Most users will never need to set any of these. They are primarily useful for debugging, CI customization, and advanced setups where the defaults do not apply.
Override the path to the tapsmith-core daemon binary. Checked before auto-resolution from npm packages, monorepo builds, and PATH.
TAPSMITH_DAEMON_LOG
Path to a file for daemon stdout/stderr. When set, the CLI redirects the spawned daemon’s output to this file. Useful for debugging daemon-side behavior (MITM proxy, agent startup, etc.).
TAPSMITH_REUSE_DAEMON
When set (any truthy value), the CLI connects to an existing daemon without killing it. Used internally by the MCP server’s tapsmith_run_tests tool to avoid destroying a daemon owned by UI mode.
TAPSMITH_AGENT_READ_HEADROOM_MS
Milliseconds the daemon waits for an on-device agent to answer a command, on top of the caller’s timeout (default 5000). This is effectively the ceiling on a single UIAutomator hierarchy dump, which the agent runs uninterruptibly regardless of the caller timeout. Raise it on slow/CPU-starved CI emulators where a dump can exceed 5s and surface as Agent command timed out; do not lower it, as that turns a slow-but-completing dump into a hard timeout.
Override the path to the mitmproxy Redirector app binary. Default search order: (1) this env var, (2) /Applications/Mitmproxy Redirector.app/Contents/MacOS/Mitmproxy Redirector, (3) ~/.tapsmith/redirector/ (auto-extracted from brew cask).
When set (and not "false"), Tapsmith skips the Android device-health preflight and disables interactive progress output. Most CI providers set this automatically. Reporter selection is no longer affected — list is the default everywhere; set reporter: 'dot' explicitly for compact CI output.
GITHUB_ACTIONS
When set (GitHub Actions sets it automatically), Tapsmith auto-adds the github reporter for inline annotations on test failures.
GITHUB_STEP_SUMMARY
Path to the GitHub Actions step summary file. The GitHub reporter writes a Markdown summary table when this is set.
