SwiftAutoGUI Agent Smoke Test
SkillAI & modelsRun 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.
No other account needed.
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