Aun

Aun is a local AI inline completion assistant for macOS.

It watches the focused text field through macOS Accessibility APIs, shows a quiet ghost-text suggestion near the caret, and accepts it with Tab. Inference runs locally through llama.cpp.

Status

Warning

Aun is alpha software. Features, configuration format, and APIs may change without notice. Expect rough edges. Intended for local testing on macOS, not production use.

Requirements

• macOS 14 or later
• Xcode Command Line Tools
• Nix, optional but recommended
• A local GGUF completion model

Quick Start

Enter the development shell:

nix develop

Download the default Gemma GGUF:

make model

Install and launch the local app:

make install

Rebuild from a clean app bundle and reinstall:

make clean-install

Then allow Aun in:

• System Settings > Privacy & Security > Accessibility
• System Settings > Privacy & Security > Input Monitoring

Open TextEdit or another editable app, type a few characters, pause briefly, and press Tab to accept the suggestion.

If Accessibility shows an old Aun entry or the permission does not seem to apply:

make reset-accessibility
make clean-install

macOS does not allow apps to grant Accessibility permission automatically. For fewer permission resets during development, sign with a stable local code-signing identity:

AUN_CODESIGN_IDENTITY="Apple Development: Your Name (...)" make clean-install

Keyboard

Key	Action
Tab	Accept suggestion
Esc	Dismiss suggestion
Option-Space	Manually request suggestion

Development

Run checks:

make check

Build the app bundle:

make package

Privacy

Aun is designed to run locally. The app does not send typed text to a network service. Model files are not committed to the repository.