Claude Code Control

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

How It Works

Uses AppleScript to:

1. Open Terminal.app and launch claude code in a project directory
2. Type commands via System Events keystrokes
3. Capture screenshots of just the Terminal window (not full screen)
4. 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

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