Skip to content
TakoAPI
Back to skills

claude-code-control

by melichar-m

CLI Utilities
817Downloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Control Claude Code programmatically through visible Terminal.app windows on macOS.

Description

What This Skill Does

Programmatically controls Claude Code through visible Terminal.app windows on macOS using AppleScript. Sends commands via keystrokes, captures screenshots of the Terminal window, and records full sessions with timestamped logs.

Controls Claude Code without a headless or API approach, keeping the Terminal window visible for monitoring while still enabling full programmatic automation.

When to Use It

  • Automating repetitive Claude Code prompts across multiple projects
  • Recording Claude Code sessions for review or documentation
  • Running Claude Code in CI-like scripts without manual input
  • Capturing screenshots of Claude Code output for reports
  • Orchestrating Claude Code from a parent Node.js script

Example Workflow

INPUT

User asks: automate running Claude Code to write tests for a Python project

AGENT
  1. 1

    Call launch() with the project directory path to open Terminal and start Claude Code

  2. 2

    Call send() with the command 'write tests for app.py' and a wait timeout

  3. 3

    Receive the result object containing a screenshot path and duration_ms

  4. 4

    Call saveSession() to write the full session log to a JSON file

  5. 5

    Call close() to exit Claude Code gracefully

OUTPUT

Session JSON log saved to disk with timestamped commands and a Terminal window screenshot of the completed test-writing step

Requirements

  • Claude Code installed and authenticated
  • Accessibility permissions granted for Terminal.app and Script Editor in macOS System Settings → Privacy & Security → Accessibility

Installation

clawhub install melichar-m/claude-code-control

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links