# WebAnnotate
> Visual Website Feedback to AI Code Fixes

WebAnnotate connects visual website annotations directly to issue trackers (Jira or Notion) and coding-agent workflows (Claude Code, GitHub Copilot, Codex, OpenCode, Copilot CLI). Freelancers, agencies, and SaaS teams capture element-level page context, screenshots, DOM details, and selected text, then route verified bug fixes to cloud or paired local AI runners executing in isolated Git worktrees.

## Core Capabilities
- **Visual Website Annotations**: Capture feedback on exact DOM elements with full browser context, screenshots, URLs, selected text, and priority.
- **Jira & Notion Ticket Sync**: Automate ticket creation and bidirectional status updates in connected Jira projects or Notion databases.
- **Coding-Agent Automation**: Trigger plan generation, automated code fixes, or GitHub pull request creation via cloud or local AI agents.
- **Local Runner Isolation**: Execute local Codex, Claude Code, OpenCode, and Copilot CLI tasks in isolated Git worktrees so active checkouts remain untouched.
- **Security & Privacy**: Local runner credentials and repository access stay strictly on the user's machine using secure outbound HTTPS polling.

## Key Pages & Documentation
- [Home Page](https://www.webannotates.com/): Product overview and live interactive demonstration.
- [Features](https://www.webannotates.com/features): Complete list of annotation, ticket sync, and coding-agent features.
- [Workflow](https://www.webannotates.com/workflow): 3-step visual feedback to pull request workflow.
- [Outcomes](https://www.webannotates.com/results): Quantitative review cycle time reductions and team results.
- [Pricing](https://www.webannotates.com/pricing): Comprehensive plan comparison (Free, Starter, Professional, Enterprise).
- [Machine-Readable Pricing](https://www.webannotates.com/pricing.md): Parsable pricing breakdown for autonomous AI buying agents.
- [Full LLM Specification](https://www.webannotates.com/llms-full.txt): Detailed architecture, runner setup, and technical specs for AI systems.
- [Security Model](https://www.webannotates.com/security): Enterprise security, local runner protection, and data handling protocols.

## Supported Integrations
- **Issue Trackers**: Jira (Cloud), Notion Workspace
- **Cloud AI Agents**: GitHub Copilot Agent
- **Local AI Runners**: Claude Code CLI, Codex CLI, OpenCode CLI, GitHub Copilot CLI
- **Source Control**: GitHub Repositories & Pull Requests
- **Browser Extension**: Chrome Extension (Manifest V3)

## Technical Architecture Overview
1. **Annotation Capture**: Chrome Extension / Web Embed records element CSS selectors, window coordinates, viewport metadata, and DOM snapshot.
2. **Issue Handoff**: Project destination formats structured issue payloads for Jira REST API v3 or Notion API v1.
3. **Agent Handoff**: Job queue dispatches context-rich prompt bundles containing DOM target, current source mapping, screenshot, and step-by-step resolution requirements.
4. **Local Execution**: Paired local daemon creates isolated Git worktree (`git worktree add`), runs code agent, verifies build/tests, pushes branch, and triggers GitHub PR API.