An AI Agent Skill for Perceiving User Behavior
Agent-aware is a skill that gives your AI Agent (Cursor, Claude Code, etc.) the ability to see what users do in web apps—clicks, scrolls, frustration, edits, and more.
npx reskill@latest install agent-awareAfter installation, your AI Agent will automatically:
- Start Server — Run the behavior collection service in the background
- Init SDK — Add one line of code to generated web projects
- Monitor & Alert — Real-time monitoring with automatic issue detection
- Auto-Fix — Analyze and fix issues based on user behavior signals
- Query & Optimize — Fetch behavior data and improve UI/UX
Just talk to your AI and let it build web apps. It now has eyes.
┌─────────────────────────────────────────────────────────────────────┐
│ Your Web App Agent-aware Server │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ SDK tracks │──HTTP────────▶│ Stores behavior│ │
│ │ user behavior │ POST │ Detects issues │ │
│ └────────────────┘ └───────┬────────┘ │
│ │ │
│ ┌────────────────┼────────────────┐ │
│ │ Write alerts │ HTTP GET │ │
│ ▼ ▼ │ │
│ ┌──────────────────────────┐ ┌────────────────┐ │ │
│ │ .agent-aware/alert/ │ │ Behavior/Error │ │ │
│ │ - error.json │ │ API │ │ │
│ │ - behavior.json │ └───────┬────────┘ │ │
│ └──────────┬───────────────┘ │ │ │
│ │ Monitor script polls │ Query details │ │
│ ▼ ▼ │ │
│ ┌─────────────────────────────────────────────────┐ │ │
│ │ AI Agent │ │ │
│ │ 1. Monitor alerts → 2. Query details → 3. Fix │ │ │
│ └─────────────────────────────────────────────────┘ │ │
└─────────────────────────────────────────────────────────────────────┘
| Signal | Insight |
|---|---|
| Runtime Error | JavaScript errors (highest priority) |
| Rage Click | Rapid repeated clicks — user frustration |
| Dead Click | Click with no response — possible bug |
| Click | What users interact with |
| Scroll | How deep users browse |
| Hover | Where users hesitate |
| Edit | User modifications to AI-generated content |
git clone https://github.com/kanyun-inc/agent-aware.git
cd agent-aware
pnpm install
pnpm build # Build packages
pnpm dev:server # Start server in dev mode
pnpm test # Run unit testsIn Cursor, tell the Agent "test agent-aware" and it will automatically:
- Generate test app — Create a random React + Vite project with 2-3 intentional bugs (dead_click, rage_click, runtime_error)
- Start monitoring — Run Server and example app
- Detect issues — Automatically detect problems when user tests the page
- Fix issues — Analyze root cause and auto-fix the code
- Generate report — Output test report to verify fixes
See .cursor/skills/agent-aware-e2e-test/SKILL.md for details.
agent-aware/
├── skill/ # Skill definition (for AI Agents)
│ ├── SKILL.md # Complete usage guide (read by AI Agent)
│ ├── references/ # Reference documentation
│ │ ├── api.md # Full API reference
│ │ └── troubleshooting.md
│ └── scripts/ # Monitoring scripts
│ └── monitor.sh # Auto-monitoring script
├── .cursor/skills/ # Cursor IDE skills
│ ├── agent-aware-e2e-test/ # E2E testing skill
│ └── vercel-react-best-practices/
├── packages/
│ ├── sdk/ # Browser SDK (behavior tracking)
│ └── server/ # HTTP Server (storage + query)
├── specs/ # Behavior specs
└── examples/ # E2E test generated projects
MIT