Claude Code Control

Control Claude Code sessions via AppleScript keystrokes and capture screenshots on macOS.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/darblex/price-compare-israel --skill claude-code-control
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Claude Code Control
Source: https://github.com/darblex/price-compare-israel/tree/main/workspace/skills/claude-code-control
Command: npx skills add https://github.com/darblex/price-compare-israel --skill claude-code-control

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to programmatically control Claude Code, a powerful AI coding assistant, by interacting with its visible Terminal.app window on macOS. This bridges the gap between AI-driven code generation and human oversight, enabling real-time monitoring and control.

Core Features & Use Cases

  • Programmatic Control: Launch Claude Code, send commands, and capture screenshots directly from your Node.js scripts.
  • Visual Monitoring: Watch Claude Code execute commands in a real Terminal window, providing transparency and confidence.
  • Session Recording: Log all commands, responses, and screenshots for review, debugging, or demonstration purposes.
  • Use Case: Automate complex coding tasks by having an AI agent drive Claude Code, then use this Skill to monitor its progress, capture evidence of its work, and ensure it stays on track.

Quick Start

Launch Claude Code in your project directory by running the command const cc = require('./index'); await cc.launch('/path/to/your/project');.

Frequently Asked Questions about Claude Code Control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Claude Code tasks in a visible macOS Terminal window?

To automate Claude Code visually on macOS, you can use Node.js scripts to launch the application in Terminal.app and send commands via AppleScript keystrokes. This enables programmatic control while maintaining full visual transparency of the session.

Can I capture screenshots of my Claude Code session for debugging?

Yes, you can capture targeted screenshots of the active Claude Code session directly from your automation scripts. The Skill facilitates taking Terminal screenshots to provide visual evidence and debugging context for the AI's executed commands.

Does programmatic Claude Code control work on operating systems other than macOS?

Programmatic visual control of Claude Code is designed specifically for macOS. It relies on AppleScript keystrokes to interact with the Terminal.app window, meaning it cannot be used to visually monitor or control sessions on Linux or Windows environments.

How do I send commands to Claude Code using Node.js automation?

You send commands to Claude Code by requiring the automation module in Node.js, launching your project directory, and dispatching inputs via AppleScript keystrokes. This simulates actual typing within the visible Terminal.app window.

Why should I visually monitor an AI coding agent instead of running it headless?

Visual monitoring bridges the gap between AI-driven code generation and human oversight by letting you watch the terminal in real-time. This transparency ensures the AI stays on track, allowing you to intervene immediately if it executes an unexpected command.

Can I record full session logs of my Claude Code automation?

Yes, the automation Skill records full session logs including all commands, responses, and captured screenshots. This creates a comprehensive history for later review, debugging, or demonstration of the AI's coding progress.