Sovereign Voice

iOS 17+

Interact with your private AI agents directly via iOS Shortcuts. No app store, no trackers, no gatekeepers. Just direct, encrypted communication between your iPhone and your Kovalent node.

Pre-built Shortcut AvailableSkip the manual steps below. Add our official shortcut directly to your iPhone and configure your node endpoint in one place.

Add to Shortcuts

Zero Trust Security
This integration requires your phone to be connected to your private **Tailscale Mesh**. Siri commands will fail if the VPN is inactive.

01. The Skeleton

Assemble the logical flow of your shortcut. These steps define how your phone collects input and processes the AI response.

Initiate InputAdd Ask for "Text" with "Prompt"

Network RequestAdd Get Contents of "URL"

Parse JSONAdd Get Dictionary from "Contents of URL"

Extract ResponseAdd Get Value for "textResponse" in "Dictionary"

Voice OutputAdd Speak "Dictionary Value"

02. The Configuration

Point your shortcut to your specific node and provide the necessary credentials for secure proxying.

Identity & Security

Endpoint Target

Managed (Recommended)
https://api.kovalentai.com/api/nodes/{NODE_ID}/proxy/api/v1/workspace/default/chat

Sovereign (VPN Required)
http://{NODE_NAME}:8080/api/v1/workspace/default/chat

Method

POST

Body Type

JSON

Headers

Authorization: Bearer YOUR_TOKEN

03. Data Exchange

Define the payload structure. Map the "Ask for Input" (from step 1) to the `message` field and ensure the `mode` is set to `chat`.

REQUEST BODY (JSON)

{
                "mode": "chat",
                "message": "<Ask for Input>"
              }

Performance Tip

Rename your shortcut to whatever you want, like a trusted advisor or friend. You can trigger it hands-free by saying "Hey Siri, Ask Tom".

Ensure the Accept header is NOT set to text/event-stream in Shortcuts, as it doesn't support streaming well.

04. Hands-Free Automation

Take sovereignty to the next level by triggering your AI through physical world events.

Double Back-Tap

Go to Settings > Accessibility > Touch. Set Back Tap to trigger your Kovalent shortcut.

NFC Triggers

Place an NFC sticker on your desk to instantly wake your sovereign assistant when you sit down.

Focus Filters

Automatically switch between different Kovalent personas when your "Work" or "Sleep" focus kicks in.

Skip the setup. Use the official shortcut.

Our pre-built shortcut is ready to use. Add it to your iPhone, enter your node endpoint and API token once, and start talking to your agent immediately.

Add to Shortcuts