Developer API

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer your_api_key_here

Base URL

https://api.shellpilot.pro/v1

Endpoints

{
  "prompt": "list all files larger than 100MB",
  "shell": "bash",
  "context": {
    "cwd": "/home/user/projects",
    "os": "linux"
  }
}

{
  "command": "find . -type f -size +100M",
  "explanation": "Searches recursively for files larger than 100MB",
  "safety": "safe"
}

{
  "command": "find . -name '*.log' -mtime +7 -delete"
}

{
  "explanation": "Finds and deletes all .log files older than 7 days",
  "breakdown": [
    { "part": "find .", "meaning": "Search from current directory" },
    { "part": "-name '*.log'", "meaning": "Match files ending in .log" },
    { "part": "-mtime +7", "meaning": "Modified more than 7 days ago" },
    { "part": "-delete", "meaning": "Delete matched files" }
  ],
  "safety": "destructive"
}

{
  "commands": [
    {
      "id": "cmd_123",
      "prompt": "find large files",
      "command": "find . -size +100M",
      "timestamp": "2026-05-20T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "total": 42
  }
}

Rate Limits