{"_id":"@approachjy/supershell","_rev":"5-16e499edd5216420a2c60be4f6352065","name":"@approachjy/supershell","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@approachjy/supershell","version":"0.1.0","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"license":"MIT","_id":"@approachjy/supershell@0.1.0","maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"bin":{"supershell":"dist/index.js"},"dist":{"shasum":"01e53deef46ab307f625aba6f79436223c5b192b","tarball":"https://registry.npmjs.org/@approachjy/supershell/-/supershell-0.1.0.tgz","fileCount":15,"integrity":"sha512-8vqR5lbBO2XPApHYnk1bPfqIOhiCJzSopgLVetoyvBCibpZqU/0dtHDkgiqJBPRw6EPMUrCouOmRzOwC9VRRvw==","signatures":[{"sig":"MEYCIQCotfvWfvbg9ve1lNgtw+iAvZoUknntLtk+geKvZrTIswIhAL2J+av19owKQLrv5vUYjYe00I099lQQHLw0/KaljNau","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":79365},"type":"module","engines":{"node":">=18"},"gitHead":"5196db8fdc9c7b2930736b731bd36715656d39dc","scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"approachjy","email":"2474590974@qq.com"},"_npmVersion":"11.4.2","description":"A unified entry point for working with remote machines","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.18.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^22.13.10"},"_npmOperationalInternal":{"tmp":"tmp/supershell_0.1.0_1785682366416_0.06168205288464379","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@approachjy/supershell","version":"0.1.1","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"license":"MIT","_id":"@approachjy/supershell@0.1.1","maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"bin":{"supershell":"dist/index.js"},"dist":{"shasum":"0411b979b0e4b814e7f7f16e73b67a80ebcdadd7","tarball":"https://registry.npmjs.org/@approachjy/supershell/-/supershell-0.1.1.tgz","fileCount":14,"integrity":"sha512-r2l58dAxYNlt8UUAAtZK7s46XMy59zErqtrOpu5s4xNNzoMDmyIKL4M0rYXKhbZ6FxvKlx0nGBTAO13CbqkJYA==","signatures":[{"sig":"MEYCIQCIk8Jrz0gZl+ntqupI0sptc7B+bsRhfPbH97FkIFl96gIhAJQzWU81fK5k59NqIWcxarAF5zCwBqtCzNIkT8sv8XXJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56019},"type":"module","engines":{"node":">=18"},"gitHead":"5196db8fdc9c7b2930736b731bd36715656d39dc","scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"approachjy","email":"2474590974@qq.com"},"_npmVersion":"11.4.2","description":"A unified entry point for working with remote machines","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.18.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^22.13.10"},"_npmOperationalInternal":{"tmp":"tmp/supershell_0.1.1_1785683580024_0.2513024769231311","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@approachjy/supershell","version":"0.2.0","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"license":"MIT","_id":"@approachjy/supershell@0.2.0","maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"bin":{"supershell":"dist/index.js"},"dist":{"shasum":"8c0ac3992814fddf4c70fb96ab51d478e83a12bf","tarball":"https://registry.npmjs.org/@approachjy/supershell/-/supershell-0.2.0.tgz","fileCount":16,"integrity":"sha512-Vs+WUUKxcK4YqwgOWCy4TDBIF7f2XJ7LYy/6rR7QvbzY77YjRq/6usld2oJJTkLeRrIvQFTniuAhw+j07XWPUg==","signatures":[{"sig":"MEUCIEmbFNOO1cwZQuTJNmX0AfWkNhe9xPM4MCTXZS3hibtiAiEAyfhzIUzne94Q3UsHFtIvfCC1CBEzhfx3hTcl4+Z91Cc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67145},"type":"module","engines":{"node":">=18"},"gitHead":"5196db8fdc9c7b2930736b731bd36715656d39dc","scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"approachjy","email":"2474590974@qq.com"},"_npmVersion":"11.4.2","description":"A unified entry point for working with remote machines","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.18.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^22.13.10"},"_npmOperationalInternal":{"tmp":"tmp/supershell_0.2.0_1785767245139_0.017128803767268774","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@approachjy/supershell","version":"0.3.0","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"license":"MIT","_id":"@approachjy/supershell@0.3.0","maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"bin":{"supershell":"dist/index.js"},"dist":{"shasum":"592590579ad32a65a9d4e534025136e1120f20b4","tarball":"https://registry.npmjs.org/@approachjy/supershell/-/supershell-0.3.0.tgz","fileCount":18,"integrity":"sha512-bmbRqIuih8bksP6anDNFrRu9Y1h5HkkDdmDi/CDfXZdYFgqNBnz5gFxh4FFLX2zOkmCL+HvUqPHnLBVp4SCD/A==","signatures":[{"sig":"MEQCIFk5vcovLcqnAIUem3lRtwv58Tj38TsawWERQUZSfD6RAiALZVRhM8h7ICMtTd2fwNowO744RJ+U6Dg19k6ucAggzw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99171},"type":"module","engines":{"node":">=18"},"scripts":{"test":"npm run build && node --test test/input.test.mjs test/cli-version.test.mjs","build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"approachjy","email":"2474590974@qq.com"},"_npmVersion":"11.4.2","description":"A unified entry point for working with remote machines","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@modelcontextprotocol/sdk":"^1.18.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^22.13.10"},"_npmOperationalInternal":{"tmp":"tmp/supershell_0.3.0_1787913752840_0.9292855397502207","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@approachjy/supershell","version":"0.3.1","description":"A unified entry point for working with remote machines","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"license":"MIT","type":"module","bin":{"supershell":"dist/index.js"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"engines":{"node":">=18"},"scripts":{"build":"tsc -p tsconfig.json","test":"npm run build && node --test test/input.test.mjs test/cli-version.test.mjs test/platform-smoke.test.mjs","test:package":"node test/package-smoke.mjs","prepublishOnly":"npm test && npm audit --omit=dev --registry=https://registry.npmjs.org/ && npm run test:package"},"dependencies":{"@modelcontextprotocol/sdk":"1.29.0"},"devDependencies":{"@types/node":"^22.13.10","typescript":"^5.8.2"},"_id":"@approachjy/supershell@0.3.1","_nodeVersion":"23.11.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-y4ui0L5HTEw2DTKmZC9OscXNG+A447LotIEOfkXGRVJPQpGY28RSqaoiU24iPt8F2VC4f5tjU9GVZbTb06r+ww==","shasum":"668f98af655a82769bdfe4c2342b9e79a9d07974","tarball":"https://registry.npmjs.org/@approachjy/supershell/-/supershell-0.3.1.tgz","fileCount":18,"unpackedSize":102032,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDH1EWyjKEC7nMb4eviPqQHw+fmNkmUcSRqD+t0TL43IwIhAP04A0VNoZewFeSMWLBFj3oaqge3MZYC8OHOWM/FSVDp"}]},"_npmUser":{"name":"approachjy","email":"2474590974@qq.com"},"directories":{},"maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/supershell_0.3.1_1787933042516_0.4570772091539428"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-02T14:52:46.251Z","modified":"2026-08-28T16:04:02.960Z","0.1.0":"2026-08-02T14:52:46.550Z","0.1.1":"2026-08-02T15:13:00.160Z","0.2.0":"2026-08-03T14:27:25.274Z","0.3.0":"2026-08-28T10:42:32.986Z","0.3.1":"2026-08-28T16:04:02.671Z"},"license":"MIT","keywords":["ssh","sftp","terminal","mcp","netcatty","port-forwarding","remote"],"description":"A unified entry point for working with remote machines","maintainers":[{"name":"approachjy","email":"2474590974@qq.com"}],"readme":"# supershell\n\nA unified entry point for working with remote machines.\n\nTerminals, file transfer, port forwarding and saved hosts are exposed through a single command, so callers don't have to care about what runs underneath.\n\n## Install\n\n```bash\nnpm install -g @approachjy/supershell\n```\n\n## Usage\n\n```bash\nsupershell run [--key value | --key=value ...]\n```\n\n```bash\nsupershell run get_environment\nsupershell run terminal_execute --sessionId --command \"uname -a\"\nsupershell run terminal_execute --sessionId= -- --literal command tokens\n```\n\nEvery token is consumed strictly: unknown parameters, bare values, duplicate parameters, and missing values are errors. String, finite number/integer, and boolean fields follow the type shown by `supershell help `. A boolean accepts `--flag` (true), `--flag=true`, `--flag=false`, or the equivalent space-separated explicit value.\n\nFor a tool with a `command` field, exactly one of these command sources may be used:\n\n```bash\nsupershell run terminal_execute --sessionId --command \"printf 'exact text\\\\n'\"\nprintf 'line 1\\nline 2\\n' | supershell run terminal_execute --sessionId --command-stdin\nsupershell run terminal_execute --sessionId --command-file ./command.sh\nsupershell run terminal_execute --sessionId --command-base64 \"$(printf 'uname -a' | base64)\"\nsupershell run terminal_execute --sessionId -- uname -a\n```\n\n`--command`, stdin, files, and base64 are decoded as exact UTF-8 text, including trailing newlines; invalid UTF-8 is rejected. The `--` form must be last and joins the remaining already-tokenized arguments with single spaces, so use one of the exact-text sources when whitespace must be preserved.\n\n## Discovering tools\n\n```bash\nsupershell # overview\nsupershell domains # tools grouped by domain\nsupershell tools # full tool list\nsupershell help # parameters for one tool\nsupershell search # search by name or description\nsupershell --version # package version (short form: -V)\n```\n\n## Requirements\n\nRequires a running [Netcatty](https://github.com/binaricat/Netcatty) instance with external tool access enabled.\n\nTo check whether everything is ready:\n\n```bash\nsupershell run meta_status\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}