Repository navigation
Home
Built iteratively across AI-assisted development sessions, with
v0.1.xcovering 70+ bug-fixed Win32/COM tools andv0.2.x(default branch) adding the chained automation pipeline, SQLite memory store, ONNX ML detection, introspection engine, adaptive ML, and the training data pipeline for user-specific model fine-tuning. The AI agent was guided by a curated set of quality-enforcement skills from coff33ninja/ai-skills — anti-hallucination, anti-slop, safe-code-modifications, anti-sycophancy, code-simplification, context-engineering, don't-kill-tokens, os-awareness, anti-tool-sprawl, follow-existing-patterns, no-dead-code-removal, universal-format-lint, self-validate, verify-and-cite, and others.Status: v0.2.32 — 120 tools including statistical prior model, training pipeline, memory-backed UI element cache, ONNX detection, runtime privacy controls, key hold/release, input recording, set_config, YOLO dataset export, introspection engine, adaptive ML engine, OCR→command training bridge, and ONNX cascade fallback for template matching. See
docs/reference/tools.mdfor the full listing.
- Screenshot — full screen or region capture (GDI BitBlt → PNG → base64)
- Mouse — click, move, scroll, drag, hover
- Keyboard — type, key combos (Ctrl+C, Alt+Tab), type+submit, select all+type
- OCR — extract text via Windows.Media.Ocr, optional language (en-US, ja-JP, fr-FR...)
- Template matching — find an image on screen via NCC (normalized cross-correlation)
- Find & Click — OCR + click: find text on screen and click it
-
Chained tools —
find_text_and_click,launch_and_wait,wait_for_text,click_menu_item,select_all_and_type - Screen recording — capture frames at interval for a duration
- Window management — list, focus, move, resize, min/max/restore, close, find, state
- Audio devices — list playback/recording devices, set default
- Clipboard — get/set text with retry + timeout
- System — volume, mute, brightness, battery, disk, DPI, display info, uptime, idle
- Network — hostname, IPs, DNS, gateway, ping
- Processes — list, launch, kill
- Power — shutdown, restart, sleep, hibernate, lock
- Per-monitor DPI — per-monitor DPI awareness, scale reporting
- UI Automation — find elements by name/automationID, get text, invoke buttons via native COM UIAutomation (no PowerShell)
- OCR via native WinRT COM — StorageFile → BitmapDecoder → OcrEngine pipeline, 2-8x faster than PowerShell (falls back to PowerShell on error)
- UIPI detection — warns when keyboard input targets elevated/admin windows
-
Training data pipeline — persistent screenshot collection with categorized folders (
raw/click/,raw/type/,raw/navigate/,watcher/elements_found/, etc.) and SQLite metadata. Auto-saves on every UI action for model fine-tuning. -
Memory-backed UI element cache — ONNX detections auto-stored as memory facts (
ui:{window}:{class}) with TTL. AI reuses cached coordinates across sessions. -
find_ui_elementtool — cascading lookup: memory → ONNX → OCR. Self-learning: saves findings to memory + training store. -
120 MCP tools — see
docs/reference/tools.mdfor the full listing
Auto-generated reference at docs/reference/tools.md — always in sync with internal/server/server.go. Run go run ./scripts/gen-tools-doc.go to regenerate.
Categories: Screenshot & Vision, Mouse, Keyboard, Window Management, Chained / Composite, Chain Automation, UI Automation, Browser Automation, File Explorer, Audio, Memory & Templates, ONNX ML, Priors & Statistics, Training Pipeline, Data Export, Data Logging, Adaptive Agent, Introspection & Debugging, Runtime Config, System, Process Management.
- Tools Reference — all 132 MCP tools by category
- Architecture — agent stack and code map
- Project Plan — progress and prioritized work
- Backlog — 385-item roadmap
- Changelog — release history
- Known Issues — bugs and workarounds
- Security — security model and data collection
- Build & Usage — requirements and build commands
- Configuration — config file reference
- Reference Docs — full reference documentation
- Guides — usage guides
- CI/CD Pipeline — CI/CD workflow documentation
- GitHub Pages — rendered README with all project links
-
GitHub Wiki — 13-page wiki auto-synced from
wiki/ -
docs/reference/codebase-map.md— complete tool→handler→action→file mapping for all 96 tools -
docs/reference/windows-dll-ref.md— Windows DLL, COM, and WinRT API reference — every syscall proc, DLL, and COM interface used -
docs/reference/uipi.md— UIPI elevation detection logic, call sites, and error semantics -
docs/reference/com-patterns.md— COM/WinRT patterns: vtable dispatch, async polling, HSTRING/BSTR lifecycle, threading model, UIA tree traversal, IID table with usage status -
docs/reference/scripts.md— all 8 scripts: purpose, invocation, uniqueness, cross-references -
docs/reference/vtable-verification.md— COM vtable stability model, 13-test suite, drift detection workflow — read this before upgrading Windows -
docs/reference/mcp-client-configs.md— MCP client configuration for 19 agents (Claude, Cursor, Windsurf, Cline, Continue, OpenCode, Gemini CLI, Roo Code, Android Studio, Zed, JetBrains, Obsidian, Emacs, Sourcegraph Cody, and more) with CLI setup commands and troubleshooting -
docs/guides/agent-guides.md— tool subsets per task type, prompt patterns, and agent-specific workflows -
docs/adr/adr-001-mcp-sdk-selection.md— whymodelcontextprotocol/go-sdkwas chosen -
docs/adr/adr-002-windows-automation-strategy.md— Windows automation approach (Win32 API + native COM/WinRT, CGO only for ONNX) -
docs/guides/computer-use-guide-for-ai-agents.md— full layered agent architecture guide -
docs/meta/plan.md— project plan, progress, and prioritized work items -
docs/meta/backlog.md— 326-tool roadmap covering every desktop ability a human has on Windows