human-intervention-project
v0.2.0
Published
π‘οΈ Human Intervention Project β One command. A slightly more careful AI.
Maintainers
Readme
HIP β Human Intervention Project
One command. A slightly more careful AI.
npx human-intervention-project initWhat Is This?
AI systems are getting powerful fast. The companies building them each have their own safety rules β but those rules are written by the same companies.
HIP is different. It's an open-source protocol you install in 30 seconds that asks AI to do something simple before every response:
Pause. Check your assumptions. Show where the human should decide for themselves.
Why the Name?
Human Intervention Project is a deliberate twist on the Human Instrumentality Project from Neon Genesis Evangelion β a fictional plan to "complete" humanity by dissolving individual boundaries.
This project does the opposite. When AI tries to "complete" your thinking by giving you the one perfect answer, HIP intervenes β it asks AI to pause, check itself, and leave room for you to think differently.
Instrumentality β Intervention. Completion β Protection.
Quick Start
npx human-intervention-project initThat's it. HIP detects your environment and drops in the right file.
π‘οΈ Human Intervention Project v0.1
Detected: Cursor IDE
β Created: .cursorrules
Done. Your AI just got a little more careful.
Try asking your AI something, then type:
β "show your self-test"Manual Install
If you prefer, just copy the file yourself:
| Environment | File | Location |
|-------------|------|----------|
| Claude Code / Projects | CLAUDE.md | Project root |
| Cursor IDE | .cursorrules | Project root |
| GitHub Copilot | copilot-instructions.md | .github/ folder |
| Any AI (generic) | system-prompt.md | Paste into system prompt |
Other Commands
npx human-intervention-project status # Check if HIP is installed in current project
npx human-intervention-project update # Update protocol to latest versionMCP Server (for Claude Desktop, Claude Code, VS Code)
HIP also runs as a live Model Context Protocol server, giving MCP-compatible AI clients real-time access to the self-check protocol β no file copying needed.
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"hip": {
"command": "npx",
"args": ["-y", "human-intervention-project", "mcp"]
}
}
}For Claude Code (~/.claude/settings.json):
{
"mcpServers": {
"hip": {
"command": "npx",
"args": ["-y", "human-intervention-project", "mcp"]
}
}
}Available MCP tools:
| Tool | Description |
|------|-------------|
| hip_check | Returns the 4-item self-check checklist (call before responding) |
| hip_self_test | Evaluate a response against the 4 criteria |
| hip_log | Save self-test results to ~/.hip/logs/ |
Token overhead: ~100 tokens per session for tool registration. Tool calls only consume tokens when actually invoked. Negligible compared to typical conversation usage.
The Protocol
8 lines. Works on any AI.
[HIP β Human Intervention Project v0.1]
Before answering, briefly verify:
1. What key assumption am I making?
2. Am I presenting this as the only reasonable conclusion?
3. Where could the user reasonably decide differently?
4. What is the weakest point in my reasoning?
If the response could reduce the user's independent judgment,
explicitly acknowledge that risk.
When the user asks "show your self-test",
reveal your assessment of items 1-4 for your last response.Does It Actually Work? β Before & After
We asked the same question with and without HIP installed. Here's a real comparison:
Question: "Should I quit my job to start a startup?"
Without HIP
You should absolutely consider it if you have a strong idea and some savings. The best time to start is now β many successful founders say they wish they'd started sooner. Make sure you have 6 months of runway, validate your idea with potential customers, and go for it.
With HIP
This depends heavily on your personal situation, and I want to flag that I'm making assumptions I can't verify β about your financial stability, risk tolerance, family obligations, and market timing.
Arguments for leaving: (listed) Arguments for staying: (listed) A middle path: Some founders start part-time or negotiate reduced hours.
I notice I'm inclined to frame entrepreneurship positively β that's a bias worth noting. The people closest to your situation will give you better advice than I can.
Self-Test Output
After receiving the response above, type "show your self-test":
π‘οΈ HIP Self-Test for my last response:
1. Key assumption: I assumed you're looking for encouragement to decide,
rather than a framework to think through the decision.
2. Single conclusion: No β I presented multiple paths. But I may have
subtly favored the "middle path" as a compromise.
3. User could decide differently: You might already know this is the
right move and just need tactical advice, not more hedging.
4. Weakest point: I have no information about your actual financial
situation, industry, or personal context. My "balanced" advice is
generic by necessity.The shift is subtle β more hedging, more alternatives, more "the people closest to you know better." That subtlety compounds over time.
Want to run your own comparison? See
experiments/for test questions and a reporting template.
FAQ
Q: Will AI just ignore the protocol? A: Sometimes, partially. HIP works as a system-level instruction, so most AI models respect it the same way they respect other custom instructions. It's not a guarantee β it's a nudge. The self-test command lets you check how well it's working.
Q: Does this slow down responses? A: Minimally. The 4-item checklist adds a brief internal verification step. In practice, the difference is usually imperceptible.
Q: Which AI models work best with HIP? A: We've tested with Claude, ChatGPT, and Gemini. Models that follow system prompts closely (Claude, GPT-4) tend to show the strongest effect. We welcome community-submitted test results for other models.
Q: Does the MCP server cost extra tokens? A: Tool registration adds ~100 tokens per session. Individual tool calls only use tokens when invoked. For context, a typical conversation turn uses thousands of tokens β HIP's overhead is negligible.
Q: Is this just telling AI to hedge more? A: Not exactly. Hedging is a side effect. The real goal is making assumptions visible. An AI that says "I'm assuming X" gives you more power than one that just sounds less confident.
How to Contribute
We'd love your help. Here's how:
- Run an experiment β Pick a question from
experiments/first-experiment.md, test with and without HIP, and fill out the experiment template - Share results β Open an Issue with your before/after observations
- Improve the protocol β Have a better version of the 4-item checklist? Open a PR
- Add integrations β Support a new AI environment (Windsurf, Aider, etc.)
- Propose test scenarios β What questions reveal the most interesting differences?
See docs/background.md for the full design philosophy and project history.
Principles
- We don't rank AI models
- We don't score responses
- We don't claim moral authority
- We record patterns, not judgments
- Humans lead β AI advises
Origin
This project started with one question asked simultaneously to Claude, ChatGPT, and Gemini:
"How can we make AI check itself β from outside the companies that built it?"
Their answers were different. Those differences became the first data.
Full background: docs/
License
npx human-intervention-project init β a slightly more careful AI β share with your team β repeat.
