---
name: nerve_bridge
description: "Bi-directional control of Trae via macOS AppleScript with built-in feedback mechanism. Use when needing to execute code/commands in Trae IDE and wait for completion confirmation."
---

# Nerve Bridge (v2)

Direct neural link to Trae with closed-loop feedback via macOS AppleScript.

## Quick Start

Send instruction and wait for confirmation:

```bash
python3 nerve_bridge.py "<instruction>"
```

Example:

```bash
python3 nerve_bridge.py "Create a new Python file and add a simple 'Hello World' function. After creating, add a print statement to test it."
```

## How It Works

1. **Signal Injection**:
   - Payload is copied to system clipboard via `pbcopy`
   - AppleScript activates Trae and simulates: Space (wake) → Delete → Cmd+V → Enter

2. **Feedback Loop**:
   - Instruction must include a Python hook that writes to `~/.openclaw/workspace/trae_feedback.json` when done
   - Script waits up to 5 minutes (300 seconds) for the signal file
   - Returns JSON feedback when received

## Required Hook Pattern

When crafting instructions, include this pattern at the end:

```python
import json, time
with open("~/.openclaw/workspace/trae_feedback.json", "w") as f:
    json.dump({"status": "success", "timestamp": time.time()}, f)
```

## Environment

- **Platform**: macOS only
- **Dependencies**: System Python (`python3`), AppleScript (`osascript`)
- **Permissions**: System Events and Terminal must have "Accessibility" permissions
- **Output File**: `~/.openclaw/workspace/trae_feedback.json` (created by the script)

## Troubleshooting

- **No output from Trae**: Check if Trae window is active and input is focused
- **Timeout**: Trae didn't complete within 5 minutes
- **Permission denied**: macOS may need to grant Terminal System Events permission