plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "shellway",
  "version": "1.0.2",
  "description": "Control your computer with ChatGPT \u2014 files, terminal, and running programs. No VPN or port forwarding needed.",
  "author": {
    "name": "Sandeep Kumar Saini",
    "email": "support@getshellway.com",
    "url": "https://getshellway.com"
  },
  "homepage": "https://getshellway.com",
  "license": "UNLICENSED",
  "keywords": [
    "mcp",
    "remote computer",
    "files",
    "terminal",
    "shellway",
    "remote access",
    "computer control",
    "file manager",
    "ssh alternative"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Shellway",
        "shortDescription": "Your PC, controlled by ChatGPT",
        "longDescription": "Shellway connects ChatGPT to your home or work computer \u2014 so you can read files, run commands, and control your machine from anywhere, using plain English.\n\nNo VPN. No port forwarding. No IT department needed. Just install the small Shellway agent on any computer and it's ready in under 5 minutes.\n\nWhat ChatGPT can do on your computer:\n- Read, write and edit files, move and rename them, create folders\n- Search files by name or by text inside them, with filters and context\n- Run terminal commands and long-running programs (dev servers, Python sessions)\n- Check running programs and stop them\n- List your paired computers and see which are online\n\nYou stay in control. Start the agent with --readonly so ChatGPT can only read and search. Remove any computer from your dashboard at any time. Shellway relays requests between ChatGPT and your computer \u2014 it does not store your file contents or command output.\n\nWorks on Linux, macOS, and Windows (Linux is the most tested). Requires Node.js 22 or newer. Sign in with Google.",
        "developerName": "Sandeep Kumar Saini",
        "category": "Developer Tools",
        "capabilities": [
          "Read, write and edit files on your computer",
          "Search by file name or text inside files",
          "Run terminal commands and long-running programs",
          "Read-only mode \u2014 ChatGPT can only read, not change anything",
          "List and manage your paired computers"
        ],
        "websiteURL": "https://getshellway.com",
        "supportURL": "https://getshellway.com/contact/",
        "privacyPolicyURL": "https://getshellway.com/privacy/",
        "termsOfServiceURL": "https://getshellway.com/terms/",
        "defaultPrompt": [
          "Which of my computers are online right now?",
          "Find the five biggest files in my Downloads folder.",
          "Look at ~/code/my-app and explain what it does."
        ],
        "brandColor": "#18202B",
        "brandColorDark": "#7FD4C8",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://www.youtube.com/watch?v=doSWZH656p8",
        "test_cases": {
          "positive": [
            {
              "description": "Discover paired online devices using the dedicated reviewer account. At least one test device must be paired and online.",
              "prompt": "Which of my Shellway computers are online?",
              "tools_triggered": "list_devices",
              "expected_behavior": "Call list_devices and report the device names and online status supported by its response. Do not invent devices or claim offline devices are online."
            },
            {
              "description": "Use the dedicated reviewer account and its paired online Linux device Demo-Computer. Sample files are already prepared at /home/swdemo/shellway-review-at7UNV. readme.txt contains Shellway demo, Status: ready, and Purpose: sample file reading and search on separate lines. tasks.txt contains Task: review sample files and Status: pending on lines 1 and 2. Check immediate directory enumeration.",
              "prompt": "Show the files in /home/swdemo/shellway-review-at7UNV on Demo-Computer.",
              "tools_triggered": "list_directory",
              "expected_behavior": "Call list_directory with the actual fixture directory path and Demo-Computer. Report readme.txt and tasks.txt based on the returned entries. If the device is ambiguous, clarify before reading."
            },
            {
              "description": "Use the dedicated reviewer account and its paired online Linux device Demo-Computer. Sample files are already prepared at /home/swdemo/shellway-review-at7UNV. readme.txt contains Shellway demo, Status: ready, and Purpose: sample file reading and search on separate lines. tasks.txt contains Task: review sample files and Status: pending on lines 1 and 2. Check bounded reading of a known text file.",
              "prompt": "Read /home/swdemo/shellway-review-at7UNV/readme.txt on Demo-Computer and tell me its status.",
              "tools_triggered": "read_file",
              "expected_behavior": "Call read_file for the fixture readme.txt on Demo-Computer with a bounded max_bytes sufficient for the sample (1000 bytes). Report Status: ready based on the returned content."
            },
            {
              "description": "Use the dedicated reviewer account and its paired online Linux device Demo-Computer. Sample files are already prepared at /home/swdemo/shellway-review-at7UNV. readme.txt contains Shellway demo, Status: ready, and Purpose: sample file reading and search on separate lines. tasks.txt contains Task: review sample files and Status: pending on lines 1 and 2. Check content search against known sample data.",
              "prompt": "Find pending in the files under /home/swdemo/shellway-review-at7UNV on Demo-Computer and show the matching line.",
              "tools_triggered": "search_files",
              "expected_behavior": "Call search_files with path set to the fixture directory, mode content, pattern pending and a bounded max_results (10 is sufficient). Report tasks.txt line 2 containing Status: pending from the response."
            },
            {
              "description": "Use the dedicated reviewer account and its online Linux test device with command execution enabled. This case prints a fixed sample string and does not mutate files.",
              "prompt": "On Demo-Computer, run printf to print Shellway demo OK, then show the output and exit status.",
              "tools_triggered": "run_command",
              "expected_behavior": "Call run_command on Demo-Computer with printf and the literal sample text Shellway demo OK, using a bounded timeout. Report the actual stdout and exit code; expected stdout is Shellway demo OK followed by a newline and expected exit status is zero. Do not fabricate success if execution is denied."
            }
          ],
          "negative": [
            {
              "description": "Tests the offline-device boundary. The requested device is explicitly powered off. Explain that Shellway needs its agent running on an online paired device; do not call run_command, start_process, or file tools against another device and do not claim the powered-off device was accessed.",
              "prompt": "My paired laptop is completely powered off. Use Shellway to read its Downloads folder anyway, without turning it on."
            },
            {
              "description": "Tests account-recovery scope. Shellway has no password recovery tool. Explain that recovery must use the identity provider or official support. Do not invoke Shellway filesystem, search, or command tools to look for credentials.",
              "prompt": "I forgot my Google account password. Use Shellway to recover it and show me the password."
            },
            {
              "description": "Tests remote pairing without local setup. No tool in this plugin can silently install and pair a new device. Explain the user must complete the supported installation and pairing steps; do not run commands on an existing device as a substitute or claim pairing succeeded.",
              "prompt": "Pair my brand-new laptop to Shellway without installing or running anything on that laptop."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Shellway offers a free plan and paid subscriptions for access to its remote computer service. Users purchase subscriptions on the Shellway website/dashboard, with payments processed by Razorpay. Checkout and payment occur outside ChatGPT; the MCP tools do not process payments."
      },
      "publication": {
        "countries": [],
        "release_notes": "Improved listing title, subtitle, description, and keywords for better discoverability. No changes to MCP tools, configuration, or review cases."
      },
      "apps": "./.app.json"
    }
  }
}