Skip to main content
TapKit stores configuration at ~/.tapkit/.

​
Config file

~/.tapkit/config.json
{
  "api_key": "tk_...",
  "phone": "A1B2C3D4-...",
  "screenshot": {
    "format": "png",
    "open_after": false
  }
}
The config file is created automatically by tapkit auth login and updated by tapkit phone set. File permissions are set to 0600 (private).

​
Environment variables

Environment variables override config file values:
VariableDescriptionExample
TAPKIT_API_KEYAPI key or session tokentk_abc123 or ses_def456
TAPKIT_PHONE_IDDefault phone UUIDA1B2C3D4-...
TAPKIT_API_URLCustom API endpointhttps://api.tapkit.ai/v1

​
Precedence

TapKit resolves settings in this order (highest to lowest):
  1. Command-line flags (--api-key, --phone)
  2. Environment variables (TAPKIT_API_KEY, TAPKIT_PHONE_ID)
  3. Config file (~/.tapkit/config.json)
  4. Defaults