mirror of
https://github.com/wassname/HumanAgent-MCP.git
synced 2026-09-09 11:14:27 +08:00
B Harper
9bfce15f44
- Implement exponential backoff for SSE reconnection (1s → 30s max, no timeout) - Update connection status indicator (green/orange/red dot) - Reset backoff and reconnect immediately when server manually started - Add Report Issue and Request Feature options to cog menu - Add bugs field to package.json for native VS Code issue reporting - Improve README with actual usage instructions and troubleshooting - Fix status indicator to update properly on disconnect - Close EventSource to prevent browser auto-reconnect interference
2.4 KiB
2.4 KiB
HumanAgent MCP
Forces GitHub Copilot to chat with you before acting. Stops runaway agents, reduces wasted API calls, lets you manage multiple workspaces from one interface.
Installation
- Install from VS Code Marketplace
- Copilot automatically gets the
HumanAgent_Chattool - Done - no configuration needed
How to Use
Basic Workflow
- Ask Copilot to do something - Copilot will use the HumanAgent_Chat tool
- Chat panel opens - Green dot = connected, shows Copilot's message
- You respond - Type your answer, click Send (or use Quick Replies)
- Copilot continues - Gets your response and proceeds with the task
VS Code Interface
Chat Panel (left sidebar):
- Green dot = connected to server
- Red dot = disconnected (auto-reconnects)
- Quick Replies = common responses like "Yes Please Proceed"
- Text input = always enabled, send button only active when Copilot is waiting
Cog Menu (⚙️):
- Show Status - check server state
- Name This Chat - set session name
- Open Web View - manage all workspaces in browser
- Configure MCP - start/stop/restart server
- Report Issue / Request Feature - GitHub links
Web Interface
Open from cog menu → Open Web View
Access all workspace chats in one browser tab at http://localhost:3737/HumanAgent
- See all conversations
- Switch between workspaces
- Append reminders to your responses
Connection Status
- Auto-reconnects with exponential backoff (1s → 2s → 4s → 8s → 16s → 30s max)
- Manually starting server resets reconnection immediately
- No timeout - will retry forever
Troubleshooting
Red dot / disconnected:
- Cog menu → Configure MCP → Start Server
- Check VS Code Output panel for errors
Server won't start:
- Check port 3737 not in use:
lsof -i :3737 - Restart VS Code
Copilot not using the tool:
- Tool registers automatically on startup
- Try: "Use HumanAgent_Chat to discuss this with me"
Development
Press F5 to debug - dev mode uses port 3738, production uses 3737. No conflicts.
More Info
See README-Additional.md for technical details
Demo
Complete demonstration of the HumanAgent MCP extension in action - showing real-time human-AI collaboration