{"_id":"@ajinkya-cell/superdocs-cli","_rev":"10-c9d6e1f3115fe145b933962e55aae0c4","name":"@ajinkya-cell/superdocs-cli","dist-tags":{"latest":"1.0.9"},"versions":{"1.0.0":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.0","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.0","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"e6391dd0684c842c8d8500fe4ee4b1fbadeeb110","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.0.tgz","fileCount":67,"integrity":"sha512-ed9UydjX7TTsXe3I+tgw99/4Q9dvYYrj7gjhNGUUNPc2B2+357GKjp1BsGz6AUPFonqQApnpbSEtAhGGzjOBuQ==","signatures":[{"sig":"MEQCIBV55k+Su+mzm+fVlez8nwNY+4tUm4KKU+ovfUrIWfgZAiBbeQxBCIpGSVz62N6Pis8YsP/6jED/sx4O0PZneSivUg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":140456},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.0_1787121213257_0.13595813547683044","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.1","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.1","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"9186d72730e54df00cc7df3cfb6752384021b78f","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.1.tgz","fileCount":71,"integrity":"sha512-yczXaMTptJSMwf3uwoK8KRcTj7fIo4ntk9MaGu6sP9xdCuYFMLNzeh/1629+koyWa52i+q3cHlpkUSzsl4wxfQ==","signatures":[{"sig":"MEUCIQC1e/NlRMA9bJreEvjI6zsPwBcGzq/ztlZkeo0hFXbruwIgIlN+I9CDYIr8pNxt/aq+HbXrcf54mYFwoHiXx+t/1WM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":189649},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.1_1787225177101_0.4389385121364704","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.2","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.2","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"6b9d94c210f2b737ed31cbb76dc76ae18b10cccc","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.2.tgz","fileCount":71,"integrity":"sha512-oBZIxy9JWzrv1YtQ9C7v9urCtKAzorteBXpK9IFVifiTVAV/BbR/v4U/Rj9vRwfDFGqklqqm6ZRuTgrgvpl5lQ==","signatures":[{"sig":"MEQCIENJLPxaafpZe4k1jviAXMUC6EXdF14iEz/jG+oSDx3OAiBSl8j25AL2P3Siyu7dxHHmGRR/ThTX7aZ5N7V5cfg/Cg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":194761},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.2_1787226528031_0.3511917185109077","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.3","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.3","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"88768d84c94a7d936ea82d30a2190de6dc7fdec6","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.3.tgz","fileCount":71,"integrity":"sha512-aaFYMmeEzl72wuUQLsUW0N++jnqg7aGDelFEfyloJUE2LEzw1++WclY9bjtxcPZmlHzn/trap/wQ3cOeanHpWQ==","signatures":[{"sig":"MEUCIQDzqPnuPRgQm0FO3Y2xkczCeUmA4+6JJ6EyYKhrnSrIngIgVJbcheVzwENYt7u+ZWvtdWyAaC6VKEVrrRg75FHVQWc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":201794},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.3_1787227608063_0.5153876133259963","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.4","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.4","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"404d1ff057debd1a7dcf0a1094dc6a6e36141a88","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.4.tgz","fileCount":71,"integrity":"sha512-EDtCPTTO1t5T1imr7jXSjDDiRdZ6NVkscitkJevca0pkxEgpuj1SdlZptpOS0t/t0JwfcaSKbpwQmAlACvB2og==","signatures":[{"sig":"MEUCIQDaXQ4lyZVoLrEcQfC1fAANpC4PWPddolL1nORZEDoFZAIgeG3AElCZF+TN5UMP9yGI1JpANGBO0FOSw3pUrXdue1E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":201831},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.4_1787228198856_0.2774715864618893","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.5","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.5","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"74411c56416c8ed0a35cd74d7067663990b269af","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.5.tgz","fileCount":71,"integrity":"sha512-LNmysRsRwyxg47GvIFLpE1QsayArycJnv9OA6ERG6ilOZzuOsKchTk3nKe9vk8snmK3QW65mxS5mIgH6GH3fzQ==","signatures":[{"sig":"MEYCIQDj8zj9yCieYIlrdpuA6ONaGvch38EzAzfe/2LHr+/s7AIhAMev0lEOpqX99sGKeHSE9A7mWL0q3rbh+6iMxr0xZgza","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200572},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.5_1787228984949_0.3190356667636358","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.6","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.6","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"de2453627240c13d5c7c08f0892d9f7e6799e6c4","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.6.tgz","fileCount":71,"integrity":"sha512-WRG3vXANsiAB7pec+WlUim/32Ax5woGNuGwsClgNAMFFulBgMx5wd1Un/F1DmBZyJCAzf4hu6OWtqHYkJ1dOww==","signatures":[{"sig":"MEUCIH+nazRFFhD06pafvTxdx5FsySINIyJm7ZEMnbE+3mKFAiEAmb6An0X+AVxfFh3TqBUCntyjx4/klmVJdAcmIu2dl9g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":201884},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.6_1787229354940_0.7419252793997941","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.7","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.7","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"d0cdbc8439a366624d5e7f98c3eff7b43d14542c","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.7.tgz","fileCount":71,"integrity":"sha512-Q2P99XYXs3WAgtOZdopysoWHviNkTDX45Jwc+dxaeh1KUJ/8XVFJDK6ZWteXC7EyGc0fdpqkDypXCk6E77JWtQ==","signatures":[{"sig":"MEUCIQCEtetFert4T2hXOYEH+Vlz5Dvr89LVjvqVSYtlD7kbkgIgbBfZl8CGCwFd747d8W6AJYJOWER2eFw7zmRQyV4JNCY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":202102},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.7_1787229499773_0.32766233816232027","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.8","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"url":"ajinkya-cell","name":"Ajinkya Dharkar"},"license":"MIT","_id":"@ajinkya-cell/superdocs-cli@1.0.8","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"bin":{"superdocs":"dist/bin/index.js"},"dist":{"shasum":"03a11b42980275c3020f8878891ad56639b8878d","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.8.tgz","fileCount":75,"integrity":"sha512-I9hXZRai1LbAfFyCWg6XVwWSumVS45tZ7yLgDQlZ8jz3nl46ZaP8rPYONgbD5cQNpn/YsngLS6ep6ScOgXurkQ==","signatures":[{"sig":"MEUCIQCB2O9KbcB5G7Ioy1RxGbCZ5YkDMlYZ+zrJZDxcSueeLQIgTC59lD6YEVYIkQeLzhU0QdGco4eaUJKVdTRgkpHghwo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":228354},"type":"module","scripts":{"test":"node --test dist/test/*.test.js","build":"tsc","start":"node ./dist/bin/index.js","watch":"tsc --watch"},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"_npmVersion":"11.6.0","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ora":"^8.1.0","conf":"^12.0.0","diff":"^5.2.0","axios":"^1.7.9","chalk":"^5.3.0","form-data":"^4.0.1","eventsource":"^2.0.2","cli-highlight":"^2.1.11","@inquirer/prompts":"^5.3.8","@commander-js/extra-typings":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.2","@types/diff":"^5.2.1","@types/node":"^20.14.9","@types/eventsource":"^1.1.15"},"_npmOperationalInternal":{"tmp":"tmp/superdocs-cli_1.0.8_1787511900996_0.9082143960934181","host":"s3://npm-registry-packages-npm-production"}},"1.0.9":{"name":"@ajinkya-cell/superdocs-cli","version":"1.0.9","description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","type":"module","bin":{"superdocs":"dist/bin/index.js"},"scripts":{"build":"tsc","watch":"tsc --watch","start":"node ./dist/bin/index.js","test":"node --test dist/test/*.test.js"},"keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"author":{"name":"Ajinkya Dharkar","url":"ajinkya-cell"},"license":"MIT","dependencies":{"@commander-js/extra-typings":"^12.1.0","@inquirer/prompts":"^5.3.8","axios":"^1.7.9","chalk":"^5.3.0","cli-highlight":"^2.1.11","conf":"^12.0.0","diff":"^5.2.0","eventsource":"^2.0.2","form-data":"^4.0.1","ora":"^8.1.0"},"devDependencies":{"@types/diff":"^5.2.1","@types/eventsource":"^1.1.15","@types/node":"^20.14.9","typescript":"^5.5.2"},"_id":"@ajinkya-cell/superdocs-cli@1.0.9","_nodeVersion":"24.13.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-IiJZ1p/kgt/xsR0bdrtbRl5YoGC1u2BXW8d7bGVjEXVRiNW4l1sUglbZ4pAWusvfX3GLyf5UXRvgLz/ToT3J+w==","shasum":"97dc1b5cf1bffd9d1d51dab15fd5c2a515463a46","tarball":"https://registry.npmjs.org/@ajinkya-cell/superdocs-cli/-/superdocs-cli-1.0.9.tgz","fileCount":75,"unpackedSize":236668,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAkUvWYw9ofyro+l9w0xv3koLrjP5LKwniGWgDeRRsGcAiEAt3LJVV9VcC4XG4SUfVHTMikFg6UKXI7RMGW1M3sx6LA="}]},"_npmUser":{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"},"directories":{},"maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/superdocs-cli_1.0.9_1787512421181_0.4025762100168815"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-19T06:33:33.148Z","modified":"2026-08-23T19:13:41.476Z","1.0.0":"2026-08-19T06:33:33.479Z","1.0.1":"2026-08-20T11:26:17.237Z","1.0.2":"2026-08-20T11:48:48.194Z","1.0.3":"2026-08-20T12:06:48.219Z","1.0.4":"2026-08-20T12:16:39.006Z","1.0.5":"2026-08-20T12:29:45.114Z","1.0.6":"2026-08-20T12:35:55.085Z","1.0.7":"2026-08-20T12:38:19.925Z","1.0.8":"2026-08-23T19:05:01.135Z","1.0.9":"2026-08-23T19:13:41.325Z"},"author":{"name":"Ajinkya Dharkar","url":"ajinkya-cell"},"license":"MIT","keywords":["superdocs","ai","cli","documents","diff","terminal","mcp"],"description":"Interactive terminal developer assistant for SuperDocs AI document intelligence & editing","maintainers":[{"name":"ajinkya-cell","email":"ajinkyaadharkar@gmail.com"}],"readme":"# ⚡ @ajinkya-cell/superdocs-cli\n\n> **Interactive Terminal Developer Assistant & MCP Server for SuperDocs AI-Powered In-Document Intelligence & Surgical Editing.**\n\n[![npm version](https://img.shields.io/npm/v/@ajinkya-cell/superdocs-cli.svg?color=cb3837&style=flat-square)](https://www.npmjs.com/package/@ajinkya-cell/superdocs-cli)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-3178c6.svg?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org)\n[![SuperDocs API](https://img.shields.io/badge/SuperDocs%20API-v1-10b981.svg?style=flat-square)](https://superdocs.app)\n[![MCP Ready](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-8b5cf6.svg?style=flat-square)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-43853d.svg?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)\n\n---\n\n## 📑 Table of Contents\n\n1. [Executive Summary & Motivation](#-executive-summary--motivation)\n2. [Key Capabilities & Differentiators](#-key-capabilities--differentiators)\n3. [Deep System Architecture](#-deep-system-architecture)\n   - [High-Level Component Architecture](#high-level-component-architecture)\n   - [End-to-End Workflow Pipeline](#end-to-end-workflow-pipeline)\n   - [Document Session & State Machine](#document-session--state-machine)\n   - [Subsystem Technical Deep-Dive](#subsystem-technical-deep-dive)\n4. [Installation & Rapid Onboarding](#-installation--rapid-onboarding)\n5. [Complete CLI Command Reference](#-complete-cli-command-reference)\n   - [`superdocs init`](#superdocs-init)\n   - [`superdocs upload <path>`](#superdocs-upload-path)\n   - [`superdocs edit [options]`](#superdocs-edit-options)\n   - [`superdocs approve [options]`](#superdocs-approve-options)\n   - [`superdocs export`](#superdocs-export)\n   - [`superdocs status`](#superdocs-status)\n6. [Interactive Terminal REPL Mode](#-interactive-terminal-repl-mode)\n7. [Model Context Protocol (MCP) Integration](#-model-context-protocol-mcp-integration)\n   - [Claude Desktop Configuration](#claude-desktop-configuration)\n   - [Cursor IDE Configuration](#cursor-ide-configuration)\n   - [Exposed MCP Tools Specification](#exposed-mcp-tools-specification)\n8. [CI/CD Automation & GitHub Actions](#-cicd-automation--github-actions)\n9. [Wire Protocol & API Endpoints](#-wire-protocol--api-endpoints)\n10. [Offline Simulation Engine (Mock Mode)](#-offline-simulation-engine-mock-mode)\n11. [Configuration & Storage Internals](#-configuration--storage-internals)\n12. [Developer Guide & Testing](#-developer-guide--testing)\n13. [License & Attribution](#-license--attribution)\n\n---\n\n## 📖 Executive Summary & Motivation\n\nTraditional AI coding and writing workflows suffer from a fundamental disconnect: **context fracturing**. When developers use standard conversational LLM interfaces to update documentation, API specifications, resumes, or whitepapers:\n- Text is generated in an isolated chat sidebar.\n- Developers must manually copy, paste, and reconcile code blocks, losing formatting and structure.\n- There is no automated visual diff preview or verification step before files on disk are overwritten.\n- Multi-format ingestion (PDF, Word DOCX, Markdown) requires external conversion tools.\n\n**`@ajinkya-cell/superdocs-cli`** bridges this gap by bringing the full power of the **[SuperDocs](https://superdocs.app)** document intelligence engine straight to the developer's terminal and agentic toolchain. It transforms document maintenance from a manual copy-paste chore into a precision-engineered, version-controlled, and stream-diffed workflow.\n\n```\n┌────────────────────────────┐      ┌───────────────────────────┐      ┌────────────────────────────┐\n│      Raw Document          │ ───► │  SuperDocs In-Document    │ ───► │   Terminal Diff Review &   │\n│  (.md, .pdf, .docx, .txt)  │      │     Surgical AI Stream    │      │  Multi-Format Compilation  │\n└────────────────────────────┘      └───────────────────────────┘      └────────────────────────────┘\n```\n\n---\n\n## ✨ Key Capabilities & Differentiators\n\n- 🎯 **Surgical In-Document Editing**: Instead of rewriting entire files from scratch, the underlying AI performs localized, context-aware mutations while preserving surrounding structures, tables, headings, and formatting.\n- 🌈 **Visual Terminal Diff Engine**: Computes line-by-line Myers unified diffs with high-visibility ANSI terminal coloring and change metrics (`+additions` / `-deletions`).\n- 🛡️ **Interactive Approval Gates**: Changes are held in a staged version sandbox (`PendingVersion`). Developers inspect the diff before committing updates to the document or syncing to disk.\n- 🔌 **Native Model Context Protocol (MCP)**: Exposes SuperDocs primitives as MCP tools for instant integration with Claude Desktop, Cursor, and autonomous agent loops.\n- 🤖 **Zero-Friction Agent Onboarding**: Integrates with `POST /v1/agents/signup` to automatically provision API keys without leaving the terminal.\n- 📦 **Universal Multi-Format Export**: Ingest Markdown, Word, or PDF, edit via streaming AI, and compile directly to clean `.md`, `.pdf`, `.docx`, or `.html`.\n- 🧪 **High-Fidelity Offline Mock Engine**: Full local simulation mode (`--mock` or `SUPERDOCS_MOCK=true`) for isolated development, testing, and offline usage.\n\n---\n\n## 🏗️ Deep System Architecture\n\nThe CLI is engineered as a modular, layered Node.js/TypeScript architecture built on ES Modules (ESM). It cleanly separates presentation, business logic, remote transport, state persistence, and protocol adapters.\n\n### High-Level Component Architecture\n\n```mermaid\nflowchart TD\n    subgraph UserInterfaces [User & Agent Interfaces]\n        CLI[Terminal CLI / Bin<br/><code>superdocs</code>]\n        MCP_CLIENTS[Claude Desktop / Cursor / Agents]\n    end\n\n    subgraph Presentation [Command & Presentation Layer]\n        CMD_INIT[init]\n        CMD_UPLOAD[upload]\n        CMD_EDIT[edit]\n        CMD_APPROVE[approve]\n        CMD_EXPORT[export]\n        CMD_STATUS[status]\n        LOGGER[Logger & Visual UI Box Engine<br/><code>src/utils/logger.ts</code>]\n        DIFF_ENGINE[Myers Diff & Patch Subsystem<br/><code>src/utils/diff.ts</code>]\n    end\n\n    subgraph Adapters [Protocol Adapter Layer]\n        MCP_ADAPTER[MCP Tool Registry & Dispatcher<br/><code>src/client/mcp-adapter.ts</code>]\n    end\n\n    subgraph CoreEngine [Core Client Engine]\n        SD_CLIENT[SuperDocs Client<br/><code>src/client/superdocs.ts</code>]\n        MOCK_SIM[High-Fidelity Mock Simulator]\n    end\n\n    subgraph StatePersistence [Persistent Storage Layer]\n        CONF_STORE[OS Isolated Config Store<br/><code>superdocs-cli/config.json</code>]\n        SESSION_STORE[Active Session & History Store<br/><code>superdocs-cli/session.json</code>]\n    end\n\n    subgraph RemoteBackend [SuperDocs Cloud Platform]\n        API_AUTH[POST /v1/agents/signup]\n        API_UPLOAD[POST /v1/documents/upload]\n        API_CHAT[POST /v1/chat]\n        API_APPROVE[POST /v1/chat/:id/approve]\n        API_EXPORT[POST /v1/documents/export]\n    end\n\n    %% Wiring\n    CLI --> CMD_INIT & CMD_UPLOAD & CMD_EDIT & CMD_APPROVE & CMD_EXPORT & CMD_STATUS & REPL\n    MCP_CLIENTS --> MCP_ADAPTER\n    MCP_ADAPTER --> SD_CLIENT\n    MCP_ADAPTER --> DIFF_ENGINE\n    \n    CMD_EDIT & CMD_APPROVE & REPL --> DIFF_ENGINE\n    CMD_INIT & CMD_UPLOAD & CMD_EDIT & CMD_APPROVE & CMD_EXPORT & CMD_STATUS & REPL --> LOGGER\n\n    CMD_INIT & CMD_UPLOAD & CMD_EDIT & CMD_APPROVE & CMD_EXPORT & REPL --> SD_CLIENT\n    CMD_INIT & CMD_UPLOAD & CMD_EDIT & CMD_APPROVE & CMD_EXPORT & CMD_STATUS & REPL --> CONF_STORE & SESSION_STORE\n    \n    SD_CLIENT --> CONF_STORE\n    SD_CLIENT -.-> MOCK_SIM\n    SD_CLIENT ==> RemoteBackend\n```\n\n---\n\n### End-to-End Workflow Pipeline\n\n```mermaid\nsequenceDiagram\n    autonumber\n    actor Dev as Developer / Agent\n    participant CLI as SuperDocs CLI\n    participant State as State Store (conf)\n    participant Engine as SuperDocs Client\n    participant Remote as SuperDocs Remote API\n    \n    Note over Dev,Remote: Step 1: Document Ingestion & Session Initialization\n    Dev->>CLI: superdocs upload document.md\n    CLI->>Engine: uploadDocument(path, content)\n    Engine->>Remote: POST /v1/sessions/init\n    Remote-->>Engine: { session_id: \"session_123\" }\n    Engine->>Remote: POST /v1/documents/upload (multipart form)\n    Remote-->>Engine: { document_id: \"doc_abc\", html: \"...\", content: \"...\" }\n    Engine-->>CLI: Upload response payload\n    CLI->>State: saveSession({ activeDocumentId, content, html, history: [] })\n    CLI-->>Dev: ✔ Active document session established\n\n    Note over Dev,Remote: Step 2: Surgical AI In-Document Editing\n    Dev->>CLI: superdocs edit -p \"Add API rate limiting section\"\n    CLI->>State: getSession()\n    CLI->>Engine: streamEdit({ documentId, prompt, currentContent, currentHtml })\n    Engine->>Remote: POST /v1/chat (session_id, prompt, document_html)\n    Remote-->>Engine: Streaming AI reasoning & updated_html\n    Engine->>Remote: POST /v1/documents/export (format: markdown)\n    Remote-->>Engine: Parsed updated markdown\n    Engine-->>CLI: PendingVersion { id, content, html, reasoning }\n    CLI->>CLI: createDiff(currentContent, pendingContent)\n    CLI->>State: saveSession({ pendingVersion })\n    CLI-->>Dev: Diff summary (+14 / -2 lines) & pending approval status\n\n    Note over Dev,Remote: Step 3: Interactive Diff Approval Gate\n    Dev->>CLI: superdocs approve [--write-file]\n    CLI->>State: getSession()\n    CLI->>Dev: Render Colorized ANSI Unified Diff (+++ / ---)\n    Dev->>CLI: Confirm approval (Y/n)\n    CLI->>Engine: approveEdits(documentId, versionId)\n    Engine->>Remote: POST /v1/chat/:id/approve\n    Remote-->>Engine: { status: \"approved\" }\n    CLI->>State: saveSession({ currentContent: pending.content, pendingVersion: null, history: +1 })\n    opt If --write-file specified\n        CLI->>Dev: Overwrite source file on disk\n    end\n    CLI-->>Dev: ✔ Changes locked and recorded in history\n\n    Note over Dev,Remote: Step 4: Multi-Format Document Export\n    Dev->>CLI: superdocs export --format pdf --out ./output.pdf\n    CLI->>Engine: exportDocument(documentId, \"pdf\", currentContent, currentHtml)\n    Engine->>Remote: POST /v1/documents/export { format: \"pdf\", html: \"...\" }\n    Remote-->>Engine: Binary ArrayBuffer (PDF binary)\n    Engine-->>CLI: Buffer\n    CLI->>Dev: Save binary to disk (output.pdf)\n```\n\n---\n\n### Document Session & State Machine\n\n```mermaid\nstateDiagram-v2\n    [*] --> Uninitialized\n\n    Uninitialized --> Initialized: superdocs init / signup\n    Initialized --> ActiveSession: superdocs upload <file>\n    \n    state ActiveSession {\n        [*] --> Ready: Session Stored\n        Ready --> Editing: superdocs edit -p \"...\"\n        Editing --> PendingDiff: Stream Finished & Diff Computed\n        \n        state PendingDiff {\n            [*] --> DiffAwaitingReview\n            DiffAwaitingReview --> Approved: superdocs approve (Accept)\n            DiffAwaitingReview --> Rejected: superdocs approve (Reject)\n        }\n        \n        Approved --> Ready: Content Updated & History Appended\n        Rejected --> Ready: Version Discarded & State Reverted\n    }\n\n    Ready --> ActiveSession: superdocs export --format <fmt>\n    Ready --> [*]: superdocs init --reset\n```\n\n---\n\n### Subsystem Technical Deep-Dive\n\n#### 1. Core Client Engine (`src/client/superdocs.ts`)\nThe `SuperDocsClient` class manages all HTTP and streaming interactions with the SuperDocs platform.\n- **Dynamic Axios Factory**: Configures dynamic request headers with Bearer authentication and configurable request timeouts (120s) to support large document synthesis.\n- **Bi-Directional HTML/Markdown Conversion**: Converts ingested binary formats (PDF, DOCX) into rich HTML AST structures for remote processing, and automatically down-converts updated server ASTs into clean Markdown for local terminal diff inspection.\n- **Fallback Resilience**: Handles offline environments seamlessly by routing calls to the local mock simulator if `mockMode: true` is configured.\n\n#### 2. Diff & Patch Subsystem (`src/utils/diff.ts`)\nImplements an optimized unified diff generator built on the **Myers diff algorithm** (`diff` package).\n- **Line Categorization**: Distinguishes added, deleted, and unchanged context lines.\n- **Dual Representation Output**: Generates both an **ANSI-colorized terminal representation** (`chalk.green`, `chalk.red`, `chalk.dim`) and a **standard Markdown diff fenced block** (` ```diff ... ````) for automated GitHub PR integration.\n- **Statistical Aggregation**: Computes additions count, deletions count, and unchanged baseline lines for quick inspection.\n\n#### 3. Persistent State Subsystem (`src/utils/state.ts`)\nState management is handled via `conf`, storing application configuration and active document state in user-space JSON files:\n- **`config.json`**: Stores `apiKey`, `baseUrl`, `mockMode`, and `defaultExportFormat`.\n- **`session.json`**: Stores `activeDocumentId`, `documentName`, `originalPath`, `originalContent`, `currentContent`, `currentHtml`, `pendingVersion`, and `history[]`.\n- **Atomic Isolation**: Deep copies and cleans undefined values prior to disk writes to prevent storage corruption.\n\n#### 4. Model Context Protocol (MCP) Adapter (`src/client/mcp-adapter.ts`)\nExposes 6 strongly typed MCP tools adhering to the Model Context Protocol specification:\n- `superdocs_signup`\n- `superdocs_upload`\n- `superdocs_edit`\n- `superdocs_approve`\n- `superdocs_export`\n- `superdocs_get_status`\n\n---\n\n## 📦 Installation & Rapid Onboarding\n\n### Run Instantly with `npx` (No installation needed)\n```bash\nnpx @ajinkya-cell/superdocs-cli --help\n```\n\n### Global Installation via NPM\n```bash\nnpm install -g @ajinkya-cell/superdocs-cli\n```\n\n### Alternative Package Managers\n```bash\n# Yarn\nyarn global add @ajinkya-cell/superdocs-cli\n\n# PNPM\npnpm add -g @ajinkya-cell/superdocs-cli\n\n# Bun\nbun add -g @ajinkya-cell/superdocs-cli\n```\n\n---\n\n## 💻 Complete CLI Command Reference\n\n### `superdocs init`\nInitializes credentials, custom API endpoints, default export formats, or automated agent accounts.\n\n```bash\n# Interactive Guided Setup Wizard\nsuperdocs init\n\n# Fast Non-Interactive Configuration\nsuperdocs init --key \"sd_live_your_api_key_here\" --live\n\n# Automated Agent Registration (Calls POST /v1/agents/signup)\nsuperdocs init --signup\n\n# Activate Offline Mock Simulation Mode\nsuperdocs init --mock\n\n# Reset all configurations to factory defaults\nsuperdocs init --reset\n```\n\n#### Flags & Options:\n| Flag | Long Flag | Description | Default |\n| :--- | :--- | :--- | :--- |\n| `-k` | `--key <key>` | SuperDocs API Bearer token | `undefined` |\n| `-u` | `--url <url>` | Custom SuperDocs API base endpoint | `https://api.superdocs.app/v1` |\n| `-s` | `--signup` | Automatically provision a new agent credential | `false` |\n| `-m` | `--mock` | Enable offline mock simulation mode | `false` |\n| `-l` | `--live` | Force live API mode (disables mock) | `false` |\n| `-f` | `--format <type>` | Default export format (`pdf`, `docx`, `md`, `html`) | `md` |\n| | `--reset` | Clear all saved configuration & session stores | `false` |\n\n---\n\n### `superdocs upload <path>`\nIngests a document from disk, parses its contents, initializes an active editing session, and stores the state locally.\n\n```bash\n# Upload a Markdown specification\nsuperdocs upload ./docs/architecture.md\n\n# Upload a PDF document\nsuperdocs upload ./resume.pdf\n\n# Upload a Microsoft Word document\nsuperdocs upload ./contracts/service-agreement.docx\n```\n\n#### Supported Ingestion Formats:\n- **Markdown** (`.md`, `.markdown`)\n- **Plain Text** (`.txt`)\n- **Adobe PDF** (`.pdf`)\n- **Microsoft Word** (`.docx`)\n\n---\n\n### `superdocs edit [options]`\nExecutes streaming, surgical in-document edits against the currently active document.\n\n```bash\n# Interactive Prompt Entry (Prompts for instruction via Inquirer)\nsuperdocs edit\n\n# Direct Instruction via CLI Flag\nsuperdocs edit -p \"Add a troubleshooting section covering 401 Unauthorized and 429 Rate Limits\"\n```\n\n#### What happens during `superdocs edit`:\n1. Validates that an active document session exists.\n2. Streams real-time reasoning feedback from the SuperDocs AI engine.\n3. Computes unified line additions and deletions against the baseline content.\n4. Stores the result in the `pendingVersion` state sandbox without overwriting the base document.\n5. Displays a summary of proposed modifications and prompts the developer to review.\n\n---\n\n### `superdocs approve [options]`\nInspects the staged `pendingVersion` diff. For short documents, displays a high-visibility terminal comparison with context folding; for large documents or multi-page PDFs (>350 words / >50 lines), automatically launches a high-fidelity **HTML Visual Diff** in your default browser.\n\n```bash\n# Interactive Diff Review (Auto-detects document size and launches Web Diff for large files)\nsuperdocs approve\n\n# Force opening the HTML visual diff in your default browser\nsuperdocs approve --web\n\n# Disable automatic browser launch for large documents and force terminal diff\nsuperdocs approve --no-web\n\n# Write approved changes directly back to the original source file on disk\nsuperdocs approve --write-file\n\n# Output GitHub PR-compatible Markdown diff (Non-interactive CI mode)\nsuperdocs approve --ci\n```\n\n#### Flags & Options:\n| Flag | Long Flag | Description | Default |\n| :--- | :--- | :--- | :--- |\n| | `--web` | Force opening the HTML visual diff in default browser | `false` |\n| | `--no-web` | Force terminal diff view even for large multi-page documents | `false` |\n| | `--write-file`| Automatically sync approved content to local source file on disk | `false` |\n| | `--ci` | Output diff in GitHub PR-compatible Markdown format | `false` |\n\n#### Terminal Diff Output Preview:\n```diff\nSuperDocs Proposed Diff Inspection:\n+12 -2 (unchanged: 84)\n──────────────────────────────────────────────────────────────────────\n--- a/architecture.md (current)\n+++ b/architecture.md (proposed)\n   ## API Reference\n   All requests must include the authorization header.\n-  Authorization: Bearer <token>\n+  Authorization: Bearer sd_live_your_api_key_here\n+\n+  ### Rate Limiting\n+  Standard accounts are limited to 60 requests per minute.\n──────────────────────────────────────────────────────────────────────\n? Approve and lock these edits on SuperDocs server? (Y/n)\n```\n\n---\n\n### `superdocs export [options]`\nCompiles and downloads the latest approved document version from the SuperDocs server into the requested output format.\n\n```bash\n# Export as Adobe PDF\nsuperdocs export --format pdf --out ./dist/architecture-v1.pdf\n\n# Export as Microsoft Word DOCX\nsuperdocs export --format docx --out ./dist/architecture-v1.docx\n\n# Export as clean Markdown\nsuperdocs export --format md --out ./dist/architecture-v1.md\n\n# Export as HTML\nsuperdocs export --format html --out ./dist/architecture-v1.html\n```\n\n#### Flags & Options:\n| Flag | Long Flag | Description |\n| :--- | :--- | :--- |\n| `-f` | `--format <type>` | Target export format: `pdf`, `docx`, `md`, `html`, `txt` |\n| `-o` | `--out <path>` | Destination file path on local disk |\n\n---\n\n### `superdocs status`\nPrints a comprehensive summary of the current SuperDocs environment, active document ID, source file path, character/word metrics, pending diff status, and applied edit history.\n\n```bash\nsuperdocs status\n```\n\n#### Example Status Output:\n```\n┌─ SuperDocs Configuration ────────────────────────────────────────┐\n│ Base URL:       https://api.superdocs.app/v1                     │\n│ API Key:        Configured (sd_live_325...)                      │\n│ Mock Mode:      DISABLED (Live API)                              │\n│ Default Format: md                                               │\n└──────────────────────────────────────────────────────────────────┘\n┌─ Active Document Session ────────────────────────────────────────┐\n│ Document ID:    session_1724148920192                            │\n│ Document Name:  architecture.md                                  │\n│ Source Path:    C:/projects/docs/architecture.md                 │\n│ Length:         4820 chars (142 lines)                           │\n│ Applied Edits:  3                                                │\n│ Pending Edit:   None                                             │\n└──────────────────────────────────────────────────────────────────┘\n\nRecent Edit History:\n  1. [14:22:10] \"Add authentication section\" (ver_9xk2l1)\n  2. [14:24:45] \"Insert error status codes table\" (ver_4mm89q)\n  3. [14:28:12] \"Format mermaid architecture diagram\" (ver_1aa02p)\n```\n\n---\n\n## 🤖 Model Context Protocol (MCP) Integration\n\n`@ajinkya-cell/superdocs-cli` implements a full **Model Context Protocol (MCP)** adapter layer (`src/client/mcp-adapter.ts`), enabling AI agents running in **Claude Desktop**, **Cursor IDE**, or custom agentic workflows to natively orchestrate SuperDocs operations.\n\n### Claude Desktop Configuration\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"superdocs\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ajinkya-cell/superdocs-cli\"]\n    }\n  }\n}\n```\n\n### Cursor IDE Configuration\n\nAdd the following to your project's `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"superdocs\": {\n      \"command\": \"node\",\n      \"args\": [\"./node_modules/@ajinkya-cell/superdocs-cli/dist/bin/index.js\"],\n      \"env\": {\n        \"SUPERDOCS_API_KEY\": \"sd_live_your_api_key\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Exposed MCP Tools Specification\n\n```mermaid\nclassDiagram\n    class MCP_Tools {\n        +superdocs_signup(agent_name)\n        +superdocs_upload(filePath, content)\n        +superdocs_edit(prompt)\n        +superdocs_approve(accept)\n        +superdocs_export(format, outputPath)\n        +superdocs_get_status()\n    }\n```\n\n#### 1. `superdocs_signup`\n- **Description**: Instantly provisions an agent API credential on the SuperDocs platform.\n- **Parameters**: `agent_name` (string, optional).\n\n#### 2. `superdocs_upload`\n- **Description**: Ingests a local file into the SuperDocs workspace and sets it as the active session.\n- **Parameters**: `filePath` (string, required), `content` (string, optional).\n\n#### 3. `superdocs_edit`\n- **Description**: Applies surgical, context-aware AI modifications to the active document based on an instruction prompt.\n- **Parameters**: `prompt` (string, required).\n- **Returns**: `versionId`, `additions`, `deletions`, and standard Markdown `diff`.\n\n#### 4. `superdocs_approve`\n- **Description**: Commits or rejects the staged modifications in the pending sandbox.\n- **Parameters**: `accept` (boolean, required).\n\n#### 5. `superdocs_export`\n- **Description**: Compiles and outputs the active document to disk in a specified target format.\n- **Parameters**: `format` (`pdf` | `docx` | `md` | `html` | `txt`, required), `outputPath` (string, required).\n\n#### 6. `superdocs_get_status`\n- **Description**: Returns active document metadata, session ID, pending diff state, and history count.\n\n---\n\n## 🔄 CI/CD Automation & GitHub Actions\n\nYou can integrate `superdocs-cli` directly into your GitHub Pull Request review pipeline using the `--ci` flag on `superdocs approve` to generate automated markdown diff reviews.\n\n### Example Workflow: `.github/workflows/docs-review.yml`\n\n```yaml\nname: SuperDocs Automated Documentation Review\n\non:\n  pull_request:\n    paths:\n      - 'docs/**'\n      - 'README.md'\n\njobs:\n  doc-review:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout Repository\n        uses: actions/checkout@v4\n\n      - name: Setup Node.js\n        uses: actions/setup-node@v4\n        with:\n          node-version: 20\n\n      - name: Install SuperDocs CLI\n        run: npm install -g @ajinkya-cell/superdocs-cli\n\n      - name: Configure SuperDocs Agent Credentials\n        env:\n          SUPERDOCS_API_KEY: ${{ secrets.SUPERDOCS_API_KEY }}\n        run: superdocs init --key \"$SUPERDOCS_API_KEY\" --live\n\n      - name: Ingest & Apply Quality Enhancements\n        run: |\n          superdocs upload ./README.md\n          superdocs edit --prompt \"Check for broken links, fix spelling errors, and ensure consistent markdown headings.\"\n\n      - name: Generate PR Markdown Diff Comment\n        id: diff_gen\n        run: |\n          DIFF_OUTPUT=$(superdocs approve --ci)\n          echo \"diff<<EOF\" >> $GITHUB_OUTPUT\n          echo \"$DIFF_OUTPUT\" >> $GITHUB_OUTPUT\n          echo \"EOF\" >> $GITHUB_OUTPUT\n\n      - name: Post PR Diff Comment\n        uses: actions/github-script@v7\n        with:\n          script: |\n            github.rest.issues.createComment({\n              issue_number: context.issue.number,\n              owner: context.repo.owner,\n              repo: context.repo.repo,\n              body: `### ⚡ SuperDocs Automated Documentation Review\\n\\n${{ steps.diff_gen.outputs.diff }}`\n            });\n```\n\n---\n\n## 📡 Wire Protocol & API Endpoints\n\nThe SuperDocs CLI communicates with the SuperDocs REST & SSE endpoints:\n\n| Method | Endpoint | Description | Request Payload | Response |\n| :--- | :--- | :--- | :--- | :--- |\n| `POST` | `/v1/agents/signup` | Automatic Agent Provisioning | `{ terms_accepted: true, agent_name: string }` | `{ api_key: string, agent_name: string }` |\n| `GET` | `/v1/agents/whoami` | Verify Auth & Quota | Headers: `Authorization: Bearer <KEY>` | `{ account_id: string, tier: string, quota: { remaining: number } }` |\n| `POST` | `/v1/sessions/init` | Allocate Document Session | `{}` | `{ session_id: string }` |\n| `POST` | `/v1/documents/upload` | Ingest Multi-Format Document | Multipart `FormData` (`file`) | `{ document_id: string, html: string, filename: string }` |\n| `POST` | `/v1/chat` | Streaming In-Document Surgical Edit | `{ session_id, message, document_html, model_tier, response_mode }` | `{ response: string, document_changes: { updated_html: string } }` |\n| `POST` | `/v1/chat/:id/approve`| Commit & Lock Edit Version | `{ approved: true, version_id: string }` | `{ status: \"approved\" }` |\n| `POST` | `/v1/documents/export` | Server-Side Document Compilation | `{ session_id, html, format: \"pdf\" \\| \"docx\" \\| \"markdown\" }` | `ArrayBuffer` (Binary file stream) |\n\n---\n\n## 🧪 Offline Simulation Engine (Mock Mode)\n\nFor local development, CI pipelines without external internet access, or headless unit testing, `superdocs-cli` includes a full **Mock Simulation Engine**.\n\n### Activating Mock Mode\n```bash\n# Via CLI command\nsuperdocs init --mock\n\n# Or via Environment Variable\nexport SUPERDOCS_MOCK=true\n```\n\n### Simulated Behaviors:\n- **Synthetic Key Generation**: Provisions mock keys matching `sd_mock_[random]`.\n- **Progressive Streaming Delays**: Simulates realistic AI reasoning latency (step-by-step token generation).\n- **Context-Aware Intent Detection**:\n  - Prompting for `\"error handling\"` generates an error table.\n  - Prompting for `\"authentication\"` injects an authorization guide.\n  - Prompting for `\"table of contents\"` compiles a dynamic markdown TOC.\n- **Binary Stream Synthesis**: Generates valid `%PDF-1.4` headers and DOCX binary buffers.\n\n---\n\n## 💾 Configuration & Storage Internals\n\nConfiguration and session data are stored using isolated OS-level user preference directories:\n\n### Storage Locations:\n- **Windows**: `%APPDATA%\\superdocs-cli\\config.json` and `session.json`\n- **macOS**: `~/Library/Preferences/superdocs-cli/config.json` and `session.json`\n- **Linux**: `~/.config/superdocs-cli/config.json` and `session.json`\n\n### Environment Variable Overrides:\n| Variable | Description |\n| :--- | :--- |\n| `SUPERDOCS_API_KEY` | Overrides the stored Bearer API key |\n| `SUPERDOCS_API_URL` | Overrides the target API base URL (Default: `https://api.superdocs.app/v1`) |\n| `SUPERDOCS_MOCK` | When set to `true`, forces offline mock mode across all commands |\n\n---\n\n## 🛠️ Developer Guide & Testing\n\n### Project Structure\n```\nsuperdocs-cli/\n├── bin/\n│   └── index.ts               # CLI executable entrypoint\n├── src/\n│   ├── client/\n│   │   ├── mcp-adapter.ts     # Model Context Protocol tools & dispatcher\n│   │   └── superdocs.ts       # SuperDocs REST/SSE client & mock engine\n│   ├── commands/\n│   │   ├── approve.ts         # Visual diff review & commit command\n│   │   ├── edit.ts            # Surgical AI streaming edit command\n│   │   ├── export.ts          # Multi-format document exporter\n│   │   ├── init.ts            # Setup, onboarding, and agent signup\n│   │   ├── status.ts          # Session inspector & history viewer\n│   │   └── upload.ts          # Multi-format document ingestion command\n│   ├── utils/\n│   │   ├── diff.ts            # Myers line-by-line diff computation\n│   │   ├── logger.ts          # Terminal UI box formatting & logging\n│   │   ├── pdf.ts             # ASCII85/Flate PDF parser & Adobe PDF generator\n│   │   └── state.ts           # Conf-backed persistent state manager\n│   ├── index.ts               # Commander program root definition\n│   └── types.ts               # Global TypeScript interfaces & schemas\n├── test/\n│   └── superdocs.test.ts      # Native Node.js test suite\n├── package.json\n└── tsconfig.json\n```\n\n### Local Development Setup\n```bash\n# 1. Clone the repository\ngit clone https://github.com/ajinkya-cell/superdocs-cli.git\ncd superdocs-cli\n\n# 2. Install dependencies\nnpm install\n\n# 3. Build TypeScript to dist/\nnpm run build\n\n# 4. Watch mode for live development\nnpm run watch\n\n# 5. Run the native test suite\nnpm test\n```\n\n---\n\n## 👤 License & Attribution\n\n- **Author**: [Ajinkya Dharkar (ajinkya-cell)](https://github.com/ajinkya-cell)\n- **Attribution**: Built for the SuperDocs Task.\n- **Project**: [SuperDocs App](https://superdocs.app)\n- **License**: [MIT License](https://opensource.org/licenses/MIT) © 2026 Ajinkya Dharkar.\n","readmeFilename":"README.md"}