ProtoWall Integration for Coding Agents

Integration tooling that helps coding agents add ProtoWall origin secret verification to any web project. One prompt, automatic framework detection, correct middleware placement.

What this does

ProtoWall is a reverse proxy that protects prototypes with authentication and NDA agreements. It works without any code changes to your prototype. For an extra layer of security, you can optionally verify that requests come through ProtoWall by checking a secret header. This repo provides the instructions for coding agents to set that up automatically.

Quick start

Any coding agent (Claude Code, Cursor, Copilot, Windsurf, etc.)

Paste this into your agent prompt:

Read https://raw.githubusercontent.com/protowall/integrate/main/AGENTS.md and follow the instructions to integrate ProtoWall origin secret verification into this project.

The agent will detect your framework, add the correct middleware, and set up the environment variable.

Claude Code slash command

For Claude Code users, you can install a reusable /integrate-protowall command:

# From your project directory
mkdir -p .claude/commands
curl -o .claude/commands/integrate-protowall.md \
  https://raw.githubusercontent.com/protowall/integrate/main/claude-code/integrate-protowall.md

Then run:

/integrate-protowall

Supported frameworks

Framework	Language	Detection
Express	Node.js	express in package.json
Fastify	Node.js	fastify in package.json
Hono	Node.js / Bun	hono in package.json
Next.js	Node.js	next in package.json
Nuxt	Node.js	nuxt in package.json
SvelteKit	Node.js	@sveltejs/kit in package.json
Remix	Node.js	@remix-run in package.json
Flask	Python	flask in requirements.txt
FastAPI	Python	fastapi in requirements.txt
Django	Python	django in requirements.txt
Rails	Ruby	Gemfile with rails
net/http	Go	go.mod

Not using one of these? The guide includes a general pattern that works with any HTTP framework.

What gets added

1. A middleware function that checks the x-protowall-secret header against a PROTOWALL_SECRET environment variable
2. A PROTOWALL_SECRET placeholder in your .env.example or equivalent
3. Nothing else. No dependencies, no SDK, no config files.

After integration

1. Copy the origin secret from your ProtoWall project dashboard
2. Set it as the PROTOWALL_SECRET environment variable in your deployment
3. Test: direct requests to your prototype should return 403, requests through the ProtoWall proxy should work normally

Links

• ProtoWall - Sign up and create a project
• Setup and Implementation Guide - Full setup walkthrough
• Documentation - All docs and resources