# Aitiy

> Aitiy is a local-first desktop productivity tool focused on mouse gestures, screenshots, OCR, text selection tools, screen edges, and hotkeys.

Aitiy is primarily a Windows desktop app built with a native C++ core and WebView2-based UI. macOS development is currently paused due to a sudden Mac price increase, with no release timeline.

## Canonical site

- https://aitiy.com/

## Main pages

- Home: https://aitiy.com/
- Documentation: https://aitiy.com/docs.html
- User-facing AI help and copyable prompt: https://aitiy.com/docs.html#ai-help
- Native runtime API reference: https://aitiy.com/docs.html#runtime-native

This file is an AI-oriented overview and index, not a complete API specification. Read the documentation before generating scripts; check the user's installed version and platform, and do not invent undocumented APIs.

## Product summary

- Mouse gestures for global and app-specific actions
- Screenshot toolkit with annotation, OCR, pinning, and long screenshot stitching
- Selection toolbar for search, translation, copy, and custom actions
- Screen edges, hot corners, wheel actions, and global hotkeys
- Focus helpers such as find mouse, key echo, input stats, and Alt-based window move
- Local-first architecture with no cloud dependency for core workflows

## Platform status

- Windows 10 and 11 are the primary supported platforms
- macOS development is currently paused due to a sudden Mac price increase, with no release timeline

## Documentation scope

The documentation page describes Aitiy's built-in JavaScript runtime for custom action scripts. It covers:

- Action context values exposed to scripts
- Runtime APIs for executing processes and commands
- Keyboard and mouse input simulation
- Screenshot and clipboard APIs
- Window and system control APIs
- Windows async runtime APIs: screen.capture, ocr.recognizeRegion, pin.create, editor.open, mouse.highlight, window.clearCropLocks, window.isFullscreen, screen.getWorkArea, system.getBrightness, numeric system.setBrightness, system.isDarkMode, and keyboard.isDown
- Async APIs use physical screen pixels and Promise results; PNG captures can be passed to pin.create or editor.open. OCR returns text using the system engine. macOS rejects these new APIs with unsupported_platform.
- Window topmost toggling and configuration-based toggles for key echo, sleep prevention, and keeping the display on; existing configurations do not automatically receive new actions
- QR display via runtime.internal.showQrCode(text)
- Example automation scripts

## Audience

- End users evaluating Aitiy as a desktop productivity tool
- Power users configuring gestures, hotkeys, and selection actions
- Developers writing custom JavaScript runtime scripts inside Aitiy

## Contact

- hi@aitiy.com