Quickstart Guide

From zero to your first successful TEE action in under 5 minutes.

Step 1 — Start the TEE server

The TEE is a standalone Express server. Clone the repository and start it in dev mode.

01-setup.sh

1	`# Clone and install`
2	`git clone https://github.com/taurusx/tee.git && cd tee`
3	`npm install`
4
5	`# Start the TEE server in dev mode (hot reload)`
6	`npm run dev # → http://localhost:3001`
7
8	`# Health check`
9	`curl http://localhost:3001/health`
10	`# → { "status": "ok", "service": "taurusx-tee" }`

Every action needs a target device. Register yours and note the id from the response.

02-register.sh

1	`curl -X POST http://localhost:3001/api/tee/devices/register \`
2	`-H "x-user-id: alice" \`
3	`-H "Content-Type: application/json" \`
4	`-d '{`
5	`"type": "macos",`
6	`"name": "Alice MacBook Pro",`
7	`"capabilities": {`
8	`"canOpenApps": true,`
9	`"canAccessFiles": true,`
10	`"canCaptureScreen": true,`
11	`"canRunScripts": false`
12	`}`
13	`}'`

DescribeScreen is a low-risk action and executes immediately without confirmation.

03-action.sh

1	`# Submit a DescribeScreen action (low risk — no confirmation needed)`
2	`curl -X POST http://localhost:3001/api/tee/actions \`
3	`-H "x-user-id: alice" \`
4	`-H "Content-Type: application/json" \`
5	`-d '{`
6	`"targetDeviceId": "<device-id-from-step-2>",`
7	`"actionType": "DescribeScreen",`
8	`"parameters": {}`
9	`}'`
10	`# → { "status": "success", "details": "Screen described successfully." }`

Tasks support dependency ordering via dependsOn.

04-task.sh

1	`# Submit a 2-step task`
2	`curl -X POST http://localhost:3001/api/tee/tasks \`
3	`-H "x-user-id: alice" \`
4	`-H "Content-Type: application/json" \`
5	`-d '{`
6	`"steps": [`
7	`{ "id": "s1", "actionType": "OpenApp", "targetDeviceId": "<id>",`
8	`"parameters": { "appName": "Finder" } },`
9	`{ "id": "s2", "actionType": "TakeScreenshot", "targetDeviceId": "<id>",`
10	`"parameters": {}, "dependsOn": ["s1"] }`
11	`]`
12	`}'`