qol-tray-task-runner-ide-checkoutlisted
Install: claude install-skill qol-tools/qol-skills
# Task Runner API Contract v1.0
A generic HTTP API standard for browser extensions to execute arbitrary tasks via a local daemon.
## Overview
The Task Runner daemon exposes a REST-like API on `127.0.0.1:{PORT}`. Browser extensions can:
1. **Discover** available actions via `GET /actions`
2. **Execute** tasks via `POST /execute`
3. **Check** daemon health via `GET /health`
## Endpoints
### GET /health
Health check endpoint.
**Response (200):**
```json
{
"status": "ok",
"version": "1.0.0"
}
```
### GET /actions
Discover available actions and their schemas.
**Response (200):**
```json
{
"actions": [
{
"id": "git-checkout",
"name": "Git Checkout",
"description": "Clone/checkout a git branch to a temp directory",
"params": {
"projectPath": { "type": "string", "required": true, "description": "Path to local git repo" },
"branch": { "type": "string", "required": true, "description": "Branch name to checkout" }
},
"returns": {
"tempPath": { "type": "string", "description": "Path to the checked-out temp repo" }
}
},
{
"id": "open-app",
"name": "Open Application",
"description": "Open a file or directory in a configured application",
"params": {
"app": { "type": "string", "required": true, "description": "App ID from config (e.g., 'idea', 'vscode', 'cursor')" },
"path": { "type": "string", "required": true, "description": "Path to open" }
},