---
name: aion-cli
description: Control Aion process manager on macOS via CLI and Unix domain socket. Protect background applications (browsers, IDEs, build tools) from auto-quit during long AI agent tasks using AI protection leases.
---

# Aion CLI & AI Protection Lease Skill

This skill allows AI agents to interact with **Aion** (macOS Smart Process & Protection Automation App).

## 🛡️ Key Capability: AI Protection Leases (`aion lease`)

When running long agent workflows (e.g. multi-step browser automation, complex builds, test runners), background apps like Chrome, Xcode, or Terminal might be auto-quit by Aion due to idle timeouts.

Use `aion lease` to hold an **AI Protection Lease** on target applications. Aion will guarantee the app remains open while the lease is active.

### Common Commands

```bash
# 1. Start a 10-minute AI protection lease for Chrome
aion lease begin com.google.Chrome 600

# 2. Renew an existing lease for 5 more minutes
aion lease renew com.google.Chrome 300

# 3. Release the lease when task is complete
aion lease end com.google.Chrome

# 4. List all active AI protection leases
aion lease list

# 5. Check overall Aion system status
aion status
```

### Advanced System Control

```bash
# Activate a specific scene
aion scene activate "Coding"

# Toggle Full-Screen Video Lock
aion protect video on

# Add an app to the auto-quit blacklist
aion blacklist add com.apple.Safari

# Open Aion Settings to a specific tab
aion ui settings --tab advanced
```

## 🚀 One-Line Symlink Setup

If `aion` command is not in your `$PATH`, link it from Aion's bundle:

```bash
mkdir -p ~/.local/bin
ln -sf /Applications/Aion.app/Contents/Resources/aion-cli.sh ~/.local/bin/aion
```