SwiftAutoGUI Agent Smoke Test

SkillAI & models

Run manual development checks for SwiftAutoGUI AI Agent actions through the local sagui CLI. Use when Claude or Codex needs to test app-control or Accessibility BasicAction generation on macOS.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the SwiftAutoGUI Agent Smoke Test skill

What this skill tells your AI

The instructions your AI receives, as published by nakaokarei/swiftautogui in .agents/skills/agent-smoke-test/SKILL.md and read by ahel’s review.

Run examples from the repository root. Always source ~/.zshrc so the latest OPENAI_API_KEY is available.

Build once:

swift build --product sagui

Search for Swift in Safari:

source ~/.zshrc && .build/debug/sagui agent \
  "Search for Swift in Safari." \
  --max-iterations 10 --delay 1

Get the frontmost application:

source ~/.zshrc && .build/debug/sagui agent \
  "Use exactly one getFrontmostApp action, then mark the goal done." \
  --max-iterations 1 --delay 0

Activate Calculator:

source ~/.zshrc && .build/debug/sagui agent \
  "Use exactly one activateApp action with app name Calculator, then mark the goal done." \
  --max-iterations 1 --delay 0

Press Calculator button 7 with Accessibility:

source ~/.zshrc && .build/debug/sagui agent \
  "Calculator is open. Use exactly one pressButton action with label 7 and bundleID com.apple.calculator. Do not use mouse or keyboard actions." \
  --max-iterations 1 --delay 0

Set the first TextEdit text field:

source ~/.zshrc && .build/debug/sagui agent \
  "TextEdit has a Save sheet open. Use exactly one setTextField action with an empty label, value SWIFTAUTOGUI_AGENT_TEST, and bundleID com.apple.TextEdit." \
  --max-iterations 1 --delay 0

Select a TextEdit menu item:

source ~/.zshrc && .build/debug/sagui agent \
  "TextEdit has a rich-text document open. Use exactly one selectMenuItem action with path [Format, Make Plain Text] and bundleID com.apple.TextEdit." \
  --max-iterations 1 --delay 0

Raise a Calculator window:

source ~/.zshrc && .build/debug/sagui agent \
  "Use exactly one raiseWindow action with title Calculator and bundleID com.apple.calculator." \
  --max-iterations 1 --delay 0

Open a URL:

source ~/.zshrc && .build/debug/sagui agent \
  "Use exactly one openURL action with URL https://example.com." \
  --max-iterations 1 --delay 0

Quit Calculator:

source ~/.zshrc && .build/debug/sagui agent \
  "Use exactly one quitApp action with app name Calculator." \
  --max-iterations 1 --delay 0

Check the Actions: line in each command output to confirm which BasicAction the Agent generated.

Signals

GitHub stars
93
Forks
10
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
agent-smoke-test
Source
github.com/nakaokarei/swiftautogui