Help & troubleshooting
Support
Need help with KorkeTrigger?
Most issues are related to endpoint configuration, network availability or authentication.
Frequently asked questions
Why does an action work on iPhone but not on Apple Watch?
Requests execute directly on the Watch, without an iPhone proxy. Check that the Watch can reach the endpoint, then confirm the active profile shows “Synced” on iPhone. Verify the URL, authentication and local network access. A VPN connection on iPhone does not automatically make that route available to Watch.
Can I use HTTP instead of HTTPS?
Yes. Plain HTTP is supported for environments that need it, but it does not encrypt requests or credentials. Prefer HTTPS where available and use HTTP only on networks you trust.
Can I use local IP addresses?
Yes. Local IP addresses, hostnames and custom ports are supported. The device executing the action must be able to reach the address and resolve the hostname. Allow local network access when prompted.
Does KorkeTrigger work over VPN?
It can use endpoints reachable through the executing device’s network connection, including a suitable VPN route. KorkeTrigger does not create or manage a VPN. Check routing and name resolution on each device; iPhone connectivity alone does not confirm Watch access.
Why does my widget show an unavailable action?
The selected profile or action may have been deleted, or the action may no longer be enabled for that widget surface. Check its visibility settings in the companion app, then edit the widget and select the profile and action again. Restore any credentials removed from a shared profile before execution.
Do Lock Screen actions require unlocking?
Yes. On a locked device, iOS requires authentication before the action executes. Lock Screen widgets provide quick access, with system authentication still applied.
How do I share a profile?
Use Share for a profile in the iPhone app, then choose AirDrop or another destination in the iOS Share Sheet. If sensitive values are detected, choose whether to include credentials. “Share without credentials” clears passwords, custom header values and query values in the exported copy; usernames remain. The recipient must restore missing credentials before using those actions.
Why does my live image not refresh?
Enable the live image in the active profile and synchronize it to Watch. The image refreshes only while its page is visible and the Watch app is active. Check that the URL returns a supported still image, the Watch can reach it, and authentication is correct. Tap the image to retry. Downloads are limited to 20 MB; smaller images are better suited to Watch.
Does KorkeTrigger require a cloud account?
No. There is no KorkeTrigger cloud account or proprietary cloud backend. Your configured endpoint may have its own account or authentication requirements.
Build a profile with your assistant
From a conversation to a profile
Download the free profile skill and unzip it. If your assistant supports skill folders, add the included korketrigger-profiles folder using that assistant’s instructions. Otherwise, provide SKILL.md, the format reference and the example as files. The assistant needs file creation to return a download; otherwise save its JSON as a .korkeprofile file.
Try: “Create a Home profile with a full-width gate button and a second row for lights and garage. Ask me for the endpoint URLs and methods. Leave credentials out.”
Save the generated file to Files on iPhone, then choose Import Profile in KorkeTrigger. Review the requests, fill in missing details locally and choose Use on Watch when ready. Configure widgets separately. Importing does not automatically activate a profile.
The download includes an optional Python 3 validator that checks the file locally without contacting endpoints. Validation cannot confirm that an endpoint is correct or safe. Test Action sends a real request. Never send passwords, tokens or private profiles to an AI service; request bodies are not scrubbed by “Share without credentials.”
Get in touch
Contact Support
Tell us what you expected, what happened, and which device you used. If useful, include your app version and iOS or watchOS version manually.
Please leave out passwords, tokens, private endpoint URLs and unredacted profiles.
Contact SupportNo device information is collected automatically.