AI Assistant Guide
This guide is designed for AI coding assistants (like Antigravity, Claude, or Cursor) to help them integrate SupraWall into your codebase accurately on the first try.
Zero Guesswork
Eliminate hallucinations by providing the assistant with exact SDK signatures and initialization patterns.
Secure by Default
Ensures the assistant configures a "Deny-by-default" posture according to security best practices.
The Master Integration Prompt
Vibe Coding OptimizedCopy this prompt and paste it into your AI assistant's chat to begin the integration.
Act as a Senior AI Integration Engineer. Your task is to install and configure SupraWall to secure my AI agent.
1. **Install SDK:** Run `pip install suprawall` (Python) or `npm install suprawall` (Node).
2. **Environment:** Load `SUPRAWALL_API_KEY` from environment variables.
3. **Initialization:** Create `suprawall_client.py` using this exact boilerplate:
from suprawall import Client, secure_agent
import os
client = Client(
api_key=os.environ.get("SUPRAWALL_API_KEY"),
default_policy="DENY"
)4. **Integration:** Find the main Agent Executor and wrap it using `secure_agent(my_agent, client=client)`.
5. **Verification:** Create a test script that tries to execute a blocked tool (e.g., `db.drop_table`) to verify protection.
Expected Code Shape
Encourage your assistant to follow this clean separation of concerns.
Directory Structure
project-root/ ├── .env # API Key here ├── main.py # Main agent logic ├── suprawall_client.py # Client init & policy └── test_security.py # Verification script
Recommended Boilerplate
# suprawall_client.py
from suprawall import Client, secure_agent
import os
client = Client(
api_key=os.environ.get("SUPRAWALL_API_KEY"),
default_policy="DENY"
)
def secure(agent):
return secure_agent(agent, client=client)