AI Intervention Agent

pip install ai-intervention-agent # or uv add ai-intervention-agent

{ "mcpServers": { "ai-intervention-agent": { "command": "uvx", "args": ["ai-intervention-agent"], "timeout": 600, "autoApprove": ["interactive_feedback"] } } }

- Only ask me through the MCP `ai-intervention-agent` tool; do not ask directly in chat or ask for end-of-task confirmation in chat. - If a tool call fails, keep asking again through `ai-intervention-agent` instead of making assumptions, until the tool call succeeds. ai-intervention-agent usage details: - If requirements are unclear, use `ai-intervention-agent` to ask for clarification with predefined options. - If there are multiple approaches, use `ai-intervention-agent` to ask instead of deciding unilaterally. - If a plan/strategy needs to change, use `ai-intervention-agent` to ask instead of deciding unilaterally. - Before finishing a request, always ask for feedback via `ai-intervention-agent`. - Do not end the conversation/request unless the user explicitly allows it via `ai-intervention-agent`.

flowchart TD subgraph CLIENTS["AI clients"] AI_CLIENT["AI CLI / IDE<br/>(Cursor, VS Code, Claude Code, ...)"] end subgraph MCP_PROC["MCP server process"] MCP_SRV["ai-intervention-agent<br/>(server.py)"] MCP_TOOL["MCP tool<br/>interactive_feedback"] CFG_MGR["Config manager<br/>(config_manager.py)"] NOTIF_MGR["Notification manager<br/>(notification_manager.py)"] end subgraph WEB_PROC["Web UI process"] WEB_SRV["Web UI service<br/>(web_ui.py / Flask)"] HTTP_API["HTTP API<br/>(/api/*)"] TASK_Q["Task queue<br/>(task_queue.py)"] WEB_SRV --> HTTP_API WEB_SRV --> TASK_Q end subgraph USER_UI["User interfaces"] BROWSER["Browser"] VSCODE["VS Code extension<br/>(Webview)"] end CFG_FILE["config.jsonc<br/>(user config directory)"] AI_CLIENT -->|MCP call| MCP_TOOL MCP_SRV -->|exposes| MCP_TOOL MCP_TOOL -->|ensure Web UI running| WEB_SRV MCP_TOOL <-->|create task / poll result| HTTP_API BROWSER <-->|HTTP| HTTP_API VSCODE <-->|HTTP| HTTP_API CFG_MGR <-->|read/write| CFG_FILE WEB_SRV <-->|read| CFG_FILE MCP_SRV --> NOTIF_MGR NOTIF_MGR -->|web / sound / system / Bark| USER["User"]