Request Mobile Input

Instructions

When invoked, follow these steps:

1. Parse the Arguments

Extract the prompt and any options from the arguments. Examples:

• /request-mobile-input "Which approach? 1=Refactor, 2=Rewrite, 3=Skip" --options 1,2,3
• /request-mobile-input "Continue with deployment?" --options yes,no
• /request-mobile-input "Enter the API key prefix"

2. Load Configuration

Read the Claude Traveller config to get the listener connection details:

CONFIG_FILE="$HOME/.claude-traveller/config.json"

Extract:

• listener.port (default: 41420)
• listener.auth_token
• network.tls.enabled (to determine http vs https)

3. Make the Request

Use curl to call the /input-request endpoint:

# Example for numeric options
curl -s -X POST "http://localhost:41420/input-request" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -d '{
    "prompt": "Which approach should I use?",
    "options": ["1", "2", "3"],
    "input_type": "numeric",
    "timeout_seconds": 300
  }'

The endpoint will block until:

• A response is received from the mobile device
• The timeout is reached
• An error occurs (no devices connected)

4. Handle the Response

Success response:

{
  "success": true,
  "response": "2",
  "responded_by": "mobile",
  "response_time_ms": 15000
}

Error response (no devices):

{
  "success": false,
  "error": "No mobile devices connected for monitoring",
  "connected_devices": 0
}

Error response (timeout):

{
  "success": false,
  "error": "Mobile input request timed out after 300 seconds",
  "connected_devices": 1
}

5. Report to User

After receiving the response:

• If successful: Report the user's choice and continue with the task
• If no devices: Inform the user to enable monitoring mode on their phone, then fall back to asking directly
• If timeout: Inform the user and ask if they want to retry or respond directly

Example Usage

Numeric Choice

/request-mobile-input "Which database migration strategy? 1=Incremental, 2=Full rebuild, 3=Skip" --options 1,2,3

Yes/No Question

/request-mobile-input "Deploy to production?" --options yes,no

Free Text (short)

/request-mobile-input "Enter the environment name" --timeout 120

Implementation Notes

• The listener must be running (claude-traveller start)
• At least one iOS device must be connected with monitoring mode enabled
• The request blocks the current terminal until response/timeout
• For HTTPS listeners, use -k flag with curl to accept self-signed certs

Fallback Behavior

If the mobile request fails:

1. Check if listener is running (curl http://localhost:41420/health)
2. Check monitor status (curl http://localhost:41420/monitor/status)
3. If no devices connected, inform user and ask the question directly in the terminal
4. If timeout, offer to retry or get direct input