✓ Verified 💻 Development ✓ Enhanced Data

Claude Code Control

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

Rating: 3.9 (94 reviews)
Downloads: 9,592 downloads
Version: 1.0.0

Overview

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

Complete Documentation

View Source →

Claude Code Control

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

How It Works

Uses AppleScript to:

Open Terminal.app and launch claude code in a project directory
Type commands via System Events keystrokes
Capture screenshots of just the Terminal window (not full screen)
Record full sessions with timestamped logs

Requirements

macOS
Node.js 18+
Claude Code installed and authenticated
Accessibility permissions for Terminal.app + Script Editor (System Settings → Privacy & Security → Accessibility)

Usage

javascript

const cc = require('./index');

// Launch Claude Code visibly
const session = await cc.launch('/path/to/project');

// Send a command (types it + presses Enter)
const result = await cc.send(session, 'write tests for app.py', 30);
// result.screenshot → path to Terminal window screenshot

// Save session recording
await cc.saveSession(session, './recording.json');

// Close
await cc.close(session);

API

Function	Description
launch(path, opts?)	Open Terminal + start Claude Code. Returns session ID
send(id, command, waitSec?)	Type command, wait, screenshot. Returns {screenshot, duration_ms}
verifyScreen(id, desc)	Take a verification screenshot
approveSecurity(id)	Handle "trust this folder" prompt
handleLogin(id)	Send /login command
saveSession(id, path)	Save session log to JSON
close(id) / closeAll()	Exit Claude Code gracefully
takeScreenshot(path?)	Capture Terminal window
focusTerminal()	Bring Terminal to front

Pro Features (Coming Soon)

🎬 Video recording of sessions
🤖 Multi-agent / multi-terminal orchestration
📊 Session analytics
🔄 Session replay
🌐 Remote control via SSH

Installation

Terminal bash


openclaw install claude-code-control

Copied!

💻Code Examples

example.js

const cc = require('./index');

// Launch Claude Code visibly
const session = await cc.launch('/path/to/project');

// Send a command (types it + presses Enter)
const result = await cc.send(session, 'write tests for app.py', 30);
// result.screenshot → path to Terminal window screenshot

// Save session recording
await cc.saveSession(session, './recording.json');

// Close
await cc.close(session);