# Aitiy

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

Aitiy is a Windows desktop app with a self-developed UI framework and customizable Lua actions. The Windows user guide covers everyday setup and use. macOS is in development and coming soon; it is not available to download yet.

## Canonical site

- https://aitiy.com/

## Main pages

- Home: https://aitiy.com/
- Documentation: https://aitiy.com/docs.html
- Portable mode: https://aitiy.com/docs.html#portable
- Custom actions: https://aitiy.com/docs.html#writing-scripts
- Lua reference (Simplified Chinese / English, selectable within the section): https://aitiy.com/docs.html#lua-reference
- AI help and copyable prompt: https://aitiy.com/docs.html#ai-help

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 is in active development — coming soon, not yet available to download

## Documentation scope

The user guide is fully translated into all 10 interface languages. It covers startup, portable mode, gestures, hotkeys, screen edges, schedules, screenshots, OCR, pinned images, selection tools, Infinite Mouse, input aids, backups, updates and troubleshooting.

To enable portable mode, exit Aitiy, create a folder named .aitiy beside Aitiy.exe, then restart. Existing user data is not moved automatically; back it up before copying it into this folder.

The Lua reference on the same documentation page describes the current Windows action API:

- Use aitiy.domain.verb_object functions and named option tables.
- Handle errors with pcall; calls suspend and resume the action coroutine.
- Regions use physical pixels and {x, y, width, height}; images use {data_url, width, height}.
- Window handles are explicit or default to context.window_handle captured at trigger time.
- Clipboard, selection, input, windows, screen capture, OCR, image tools, system settings, app control, configuration and temporary state are separate modules.
- Documentation includes all 53 public signatures, defaults, result types, limits and executable Lua examples.
- The default library contains 83 editable Lua actions in 10 task-oriented categories.
- The Lua reference follows the website language, with complete descriptions in all 10 supported languages. Function names, argument names and executable examples remain unchanged across translations.

## Audience

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

## Contact

- hi@aitiy.com