Skillget

PC-Automation

agent
Security Audit
Warn
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 28 GitHub stars
Code Pass
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Give any AI agent real hands on your Mac. A stdlib-only Python CLI for volume, brightness, apps, browser, media, screenshots and mic tests. No dependencies, no daemon.

README.md

PC-Automation: Give an AI Agent Real Hands on Your Mac

A stdlib-only Python CLI that lets any AI agent control macOS: volume, brightness, apps, browser tabs, media playback, screenshots, clipboard, notifications and hardware tests. No third party packages, no daemon, no interactive prompts.

Python
macOS
Zero Dependencies
Stars

What it does

Most desktop automation projects hardcode a list of phrases and guess at intent. This one does not. It exposes a clean, predictable verb catalog and lets the AI agent do the thinking. The agent decides what to do, this CLI is simply the hands that do it.

Every command is a single subprocess call, returns structured output, and never blocks waiting for input, which is exactly what an autonomous agent needs.

Quick start

python3 scripts/pc.py doctor
python3 scripts/pc.py volume set 40
python3 scripts/pc.py app open Safari
python3 scripts/pc.py youtube play "lo-fi beats"
python3 scripts/pc.py browser new-tab
python3 scripts/pc.py mic-test

doctor is the one to run first. It reports which capabilities are available and which macOS permissions still need granting.

Features

  • System state: battery, volume, brightness, IP address, running apps
  • App control: launch and quit any application by name
  • Web and media: open URLs, search YouTube, play, pause, skip tracks
  • Browser control: new tabs, navigation, window management
  • Capture: screenshots and clipboard read/write
  • Output: system notifications and text to speech
  • Hardware: honest microphone and speaker tests that actually verify signal

The full verb catalog, permission setup and design notes live in SKILL.md.

Install as a Claude Code skill

git clone https://github.com/AnubhavChaturvedi-GitHub/PC-Automation.git ~/.claude/skills/pc-control

Then invoke /pc-control, or just ask your agent to control the computer.

Permissions

macOS gates several of these behind privacy settings. Grant your terminal (or the agent host app) access under:

  • System Settings > Privacy & Security > Accessibility for keystrokes and window control
  • System Settings > Privacy & Security > Screen Recording for screenshots
  • System Settings > Privacy & Security > Microphone for mic tests

Run doctor after granting to confirm.

Why v2 looks nothing like v1

v1 was a console assistant with a hardcoded phrase brain. v2 deletes that brain entirely. Modern AI agents already handle intent far better than a keyword table ever could, so the correct division of labour is: agent thinks, skill acts. The result is smaller, faster, dependency free and far more reliable.

Requirements

macOS. Python 3.9 or newer (ships with the OS). Nothing to pip install.

Contributing

Issues and pull requests welcome. New verbs should stay stdlib only and non-interactive.

License

See the repository license file.

Author

Anubhav Chaturvedi, founder of NetHyTech, a developer community of 30,000+ members.

YouTube
LinkedIn

If this project saved you time, a star on the repo helps other people find it.

Reviews (0)

No results found