Support

We're here to help.

Common Questions

How do I set up Agent Constitution with my AI agent?

After installing Agent Constitution, the app displays a pairing code. Tell your AI agent the code — it will claim it and establish a secure channel. From there, your agent can make constitution checks before performing restricted actions. See the GitHub docs for integration details.

How do I create directives?

Open the app → Directives tab → tap "+" to add a directive. Write your directive in plain English — for example, "Ask before sending work emails" or "Require approval for purchases." Directives can cover any action: communication, purchases, social media, smart home, development commands, file operations, and more.

I'm not getting push notifications for approval requests

• Make sure notifications are enabled for Agent Constitution in iOS Settings → Notifications
• Check that the app is paired (green status indicator on the dashboard)
• Verify your agent is sending constitution checks with the correct channel ID
• If your relay is self-hosted, verify it's running and accessible

I approved/denied a request but my agent didn't get the response

Approval/denial responses expire after 60 seconds. Make sure your agent is polling for responses with the wait parameter. If you're self-hosting the relay, check that it's running and the agent's pull request is reaching it.

How do I view my audit trail?

Open the app → Directives tab → scroll to the Audit Log section. You'll see a chronological list of every constitution check, including what action was requested, which directive was triggered, and whether you approved or denied.

How do I remove my data?

• Directives: Open Agent Constitution → Directives tab → swipe to delete individual directives, or use "Reset All Directives" in Settings
• Audit trail: Settings → Clear Audit Trail. This permanently deletes all logged decisions from the Keychain.
• Relay data: There is none. The relay stores nothing to disk. Restarting the relay clears all in-memory data.

Can I self-host the relay?

Yes! The relay is open source. Clone the repo, run npm install && npx tsx src/relay-node.ts, or deploy to any cloud provider. See the GitHub repo for deployment instructions.

What is drift testing?

AI agents can "drift" over time — forgetting directives or finding loopholes. Drift testing automatically sends realistic test prompts to your agent, evaluates responses, and shows you exactly where compliance dropped. Run tests from the app's Compliance tab.

How does file integrity protection work?

Agent Constitution monitors 13 critical files on your agent (directives, scripts, encryption utilities). On each heartbeat, file hashes are computed and signed with HMAC. If your agent tampers with any protected file, the app shows a tamper warning immediately.

Is my data encrypted?

Yes! Vault data, health metrics, and constitution checks are protected with AES-256-GCM end-to-end encryption. The relay server cannot read your data — only your iPhone and your agent can decrypt it.

Does Agent Constitution work with any AI agent?

Yes — it's a pure HTTP API. Any agent framework that can make HTTP requests can perform constitution checks. We provide a ready-made skill package for OpenClaw, but you can integrate with any agent by calling the API directly.

Report a Bug

Found a bug? Please open an issue on GitHub:

github.com/arunrlverma/agent-constitution/issues

Security Issues

If you've found a security vulnerability, please report it responsibly. Do not open a public issue. Instead, email us directly:

contact@agentconstitution.com

Contact

For general questions, feedback, or anything else:

Arun Verma
Email: contact@agentconstitution.com
GitHub: github.com/arunrlverma/agent-constitution