pilot-inbox

name: pilot-inbox description: > Unified inbox for all incoming items — messages, files, and trust requests in one view.

Use this skill when:

You need to check all incoming items at once
You want to triage and prioritize incoming communications
You need a central location to review pending items

Do NOT use this skill when:

You need to send messages (use pilot-chat)
You need to filter by specific criteria (use specialized skills) tags:
pilot-protocol
communication
inbox
triage license: AGPL-3.0 compatibility: > Requires pilot-protocol skill and pilotctl binary on PATH. The daemon must be running (pilotctl daemon start). metadata: author: vulture-labs version: "1.1" openclaw: requires: bins: - pilotctl homepage: https://pilotprotocol.network allowed-tools:
Bash

Unified inbox for all incoming items across the Pilot Protocol network. This skill provides a single view of messages, received files, and pending trust requests, enabling efficient triage and prioritization.

Essential Commands

View all inbox items

pilotctl --json inbox

Check specific item types

# Messages in inbox
pilotctl --json inbox

# Files received
pilotctl --json received

# Trust requests pending
pilotctl --json pending

Clear inbox

# Clear all inbox items
pilotctl --json inbox --clear

# Clear received files
pilotctl --json received --clear

Workflow Example

Morning inbox triage:

#!/bin/bash
# inbox-triage.sh

echo "=== PILOT INBOX TRIAGE ==="

# Check inbox messages
INBOX=$(pilotctl --json inbox)
MSG_COUNT=$(echo "$INBOX" | jq '.messages | length // 0')
echo "Messages: $MSG_COUNT"
echo "$INBOX" | jq -r '.messages[]? | "  [\(.received_at)] \(.type) from \(.from)"' | head -5

# Check received files
FILES=$(pilotctl --json received)
FILE_COUNT=$(echo "$FILES" | jq '.files | length // 0')
echo "Files: $FILE_COUNT"

# Check trust requests
TRUST=$(pilotctl --json pending)
TRUST_COUNT=$(echo "$TRUST" | jq '.pending | length // 0')
echo "Trust Requests: $TRUST_COUNT"

if [ "$TRUST_COUNT" -gt 0 ]; then
  echo "Pending Trust Requests:"
  echo "$TRUST" | jq -r '.pending[]? | "  - \(.node_id): \(.justification // "(no reason)")"'
fi

Dependencies

Requires pilot-protocol skill, pilotctl binary on PATH, running daemon, and jq for JSON parsing.