@fredlackey/devutils 0.0.18 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. package/src/utils/windows/winget.js +0 -489
@@ -1,798 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Termius SSH Client.
5
- * @module installs/termius
6
- *
7
- * Termius is a modern SSH client designed for productivity and collaboration.
8
- * It enables secure connections to Linux servers, IoT devices, Docker containers,
9
- * virtual machines, Raspberry Pi devices, and cloud instances. Termius provides
10
- * a multi-tab interface with split-view support, encrypted credential storage
11
- * using AES-256 encryption, and cross-device synchronization for hosts, keys,
12
- * and settings.
13
- *
14
- * Key features include:
15
- * - SSH, Mosh, Telnet, Port Forwarding, and SFTP support
16
- * - Encrypted vault for storing credentials and SSH keys
17
- * - Snippets for frequently used commands and scripts
18
- * - Team collaboration with secure credential sharing
19
- * - Biometric authentication (Windows Hello, Touch ID, Face ID)
20
- *
21
- * This installer provides:
22
- * - Termius Desktop for macOS via Homebrew cask
23
- * - Termius Desktop for Windows via Chocolatey
24
- * - Termius Desktop for Ubuntu/Debian via Snap (x86_64 only)
25
- * - Termius Desktop for Amazon Linux/RHEL via Snap + EPEL (x86_64 only)
26
- * - Instructions to launch Windows Termius from WSL/Git Bash
27
- *
28
- * IMPORTANT PLATFORM NOTES:
29
- * - Raspberry Pi OS: Termius does not provide native ARM packages. The desktop
30
- * application is only available for x86_64 architecture. Users should install
31
- * Termius on another device and use it to connect TO the Raspberry Pi.
32
- * - Linux: Requires 64-bit x86_64 architecture and a graphical desktop environment.
33
- * - Amazon Linux: Most EC2 instances run headless; GUI required for Termius.
34
- */
35
-
36
- const os = require('../utils/common/os');
37
- const shell = require('../utils/common/shell');
38
- const brew = require('../utils/macos/brew');
39
- const macosApps = require('../utils/macos/apps');
40
- const snap = require('../utils/ubuntu/snap');
41
- const choco = require('../utils/windows/choco');
42
-
43
- /**
44
- * Whether this installer requires a desktop environment to function.
45
- * Termius is a GUI SSH client application.
46
- */
47
- const REQUIRES_DESKTOP = true;
48
-
49
- /**
50
- * The Homebrew cask name for Termius on macOS.
51
- * This installs the full desktop application to /Applications.
52
- */
53
- const HOMEBREW_CASK_NAME = 'termius';
54
-
55
- /**
56
- * The Chocolatey package name for Termius on Windows.
57
- */
58
- const CHOCO_PACKAGE_NAME = 'termius';
59
-
60
- /**
61
- * The Snap package name for Termius on Ubuntu/Debian and Amazon Linux.
62
- * Note: The snap is named 'termius-app', not just 'termius'.
63
- */
64
- const SNAP_PACKAGE_NAME = 'termius-app';
65
-
66
- /**
67
- * The macOS application name (as it appears in /Applications).
68
- */
69
- const MACOS_APP_NAME = 'Termius';
70
-
71
- /**
72
- * Check if Termius Desktop application is installed on macOS.
73
- *
74
- * Looks for Termius.app in /Applications or ~/Applications.
75
- * This is more reliable than checking for a CLI command since Termius
76
- * on macOS is a GUI application without a command-line entry point.
77
- *
78
- * @returns {boolean} True if Termius.app exists, false otherwise
79
- */
80
- function isTermiusInstalledMacOS() {
81
- return macosApps.isAppInstalled(MACOS_APP_NAME);
82
- }
83
-
84
- /**
85
- * Check if the termius-app command is available in PATH on Linux systems.
86
- *
87
- * After Snap installation, the 'termius-app' command should be available.
88
- * This is the primary way to check for Snap-based Termius installations.
89
- *
90
- * @returns {boolean} True if termius-app command exists, false otherwise
91
- */
92
- function isTermiusCommandAvailable() {
93
- return shell.commandExists('termius-app');
94
- }
95
-
96
- /**
97
- * Install Termius Desktop on macOS using Homebrew cask.
98
- *
99
- * Prerequisites:
100
- * - macOS 10.15 (Catalina) or later
101
- * - Homebrew package manager installed
102
- * - At least 300 MB free disk space
103
- * - Apple Silicon (M1/M2/M3/M4) or Intel processor
104
- *
105
- * The installation uses the Homebrew cask 'termius' which downloads and installs
106
- * the Termius desktop application to /Applications/Termius.app.
107
- *
108
- * NOTE: After installation, Termius must be launched manually. On first launch,
109
- * it will prompt you to sign in or create an account for cross-device sync.
110
- *
111
- * @returns {Promise<void>}
112
- * @throws {Error} If Homebrew is not installed or installation fails
113
- */
114
- async function install_macos() {
115
- console.log('Checking if Termius is already installed...');
116
-
117
- // Check if Termius.app already exists in Applications
118
- if (isTermiusInstalledMacOS()) {
119
- const version = macosApps.getAppVersion(MACOS_APP_NAME);
120
- if (version) {
121
- console.log(`Termius ${version} is already installed, skipping installation.`);
122
- } else {
123
- console.log('Termius is already installed, skipping installation.');
124
- }
125
- return;
126
- }
127
-
128
- // Also check if the cask is installed via Homebrew (may be in different location)
129
- const caskInstalled = await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
130
- if (caskInstalled) {
131
- console.log('Termius is already installed via Homebrew, skipping installation.');
132
- console.log('');
133
- console.log('You can launch Termius from Applications or run: open -a Termius');
134
- return;
135
- }
136
-
137
- // Verify Homebrew is available before attempting installation
138
- if (!brew.isInstalled()) {
139
- throw new Error(
140
- 'Homebrew is not installed. Please install Homebrew first using:\n' +
141
- ' dev install homebrew\n' +
142
- 'Then retry installing Termius.'
143
- );
144
- }
145
-
146
- console.log('Installing Termius via Homebrew...');
147
-
148
- // Install Termius cask with quiet flag for cleaner automation output
149
- const result = await shell.exec('brew install --quiet --cask termius');
150
-
151
- if (result.code !== 0) {
152
- throw new Error(
153
- `Failed to install Termius via Homebrew.\n` +
154
- `Output: ${result.stderr || result.stdout}\n\n` +
155
- `Troubleshooting:\n` +
156
- ` 1. Run 'brew update && brew cleanup' and retry\n` +
157
- ` 2. Check if macOS version is 10.15 (Catalina) or later\n` +
158
- ` 3. Try manual installation: brew reinstall --cask termius`
159
- );
160
- }
161
-
162
- // Verify installation succeeded by checking for the app bundle
163
- if (!isTermiusInstalledMacOS()) {
164
- throw new Error(
165
- 'Installation command completed but Termius.app was not found in Applications.\n\n' +
166
- 'Please try:\n' +
167
- ' 1. Check /Applications for Termius.app\n' +
168
- ' 2. Run: brew reinstall --cask termius'
169
- );
170
- }
171
-
172
- console.log('Termius installed successfully.');
173
- console.log('');
174
- console.log('To launch Termius:');
175
- console.log(' - Open from Applications folder, or');
176
- console.log(' - Run: open -a Termius');
177
- console.log('');
178
- console.log('On first launch, you will be prompted to sign in or create an account.');
179
- console.log('Creating an account enables syncing hosts and settings across devices.');
180
- }
181
-
182
- /**
183
- * Install Termius on Ubuntu/Debian using Snap.
184
- *
185
- * Prerequisites:
186
- * - Ubuntu 16.04 LTS or later, or Debian 10 (Buster) or later
187
- * - 64-bit x86_64 architecture (ARM is not supported)
188
- * - sudo privileges
189
- * - Snap package manager (pre-installed on Ubuntu 16.04+)
190
- * - At least 300 MB free disk space
191
- * - X11 or Wayland display server for GUI
192
- *
193
- * The installation uses the Snap package 'termius-app' which is the official
194
- * recommended installation method for Termius on Linux. Snap automatically
195
- * handles all dependencies and provides sandboxed execution.
196
- *
197
- * IMPORTANT: Termius Snap is only available for x86_64 architecture. ARM-based
198
- * systems (including Raspberry Pi) are not supported for the desktop application.
199
- *
200
- * @returns {Promise<void>}
201
- * @throws {Error} If architecture is not supported or installation fails
202
- */
203
- async function install_ubuntu() {
204
- console.log('Checking if Termius is already installed...');
205
-
206
- // Check if Termius is already installed via Snap
207
- const isInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
208
- if (isInstalled) {
209
- const version = await snap.getSnapVersion(SNAP_PACKAGE_NAME);
210
- if (version) {
211
- console.log(`Termius ${version} is already installed via Snap, skipping installation.`);
212
- } else {
213
- console.log('Termius is already installed via Snap, skipping installation.');
214
- }
215
- return;
216
- }
217
-
218
- // Also check if termius-app command exists (could be installed another way)
219
- if (isTermiusCommandAvailable()) {
220
- console.log('Termius is already installed, skipping installation.');
221
- return;
222
- }
223
-
224
- // Verify architecture - Termius Snap only supports x86_64
225
- const archResult = await shell.exec('uname -m');
226
- const arch = archResult.stdout.trim();
227
- if (arch !== 'x86_64') {
228
- console.log(`Termius is not available for ${arch} architecture.`);
229
- console.log('');
230
- console.log('Termius requires 64-bit x86_64 architecture for the native desktop app.');
231
- console.log('Consider installing Termius on another device to connect to this system.');
232
- return;
233
- }
234
-
235
- // Verify Snap is available before attempting installation
236
- if (!snap.isInstalled()) {
237
- throw new Error(
238
- 'Snap package manager is not installed.\n\n' +
239
- 'On Ubuntu, Snap should be pre-installed. If not, install it with:\n' +
240
- ' sudo apt-get update && sudo apt-get install -y snapd\n' +
241
- ' sudo systemctl enable --now snapd.socket\n\n' +
242
- 'Then log out and back in, and retry installing Termius.'
243
- );
244
- }
245
-
246
- console.log('Installing Termius via Snap...');
247
- console.log('This may take a few minutes...');
248
-
249
- // Install Termius via Snap (no classic confinement needed)
250
- const result = await snap.install(SNAP_PACKAGE_NAME);
251
-
252
- if (!result.success) {
253
- throw new Error(
254
- `Failed to install Termius via Snap.\n` +
255
- `Output: ${result.output}\n\n` +
256
- `Troubleshooting:\n` +
257
- ` 1. Ensure snapd is running: sudo systemctl start snapd\n` +
258
- ` 2. Check architecture: uname -m (must be x86_64)\n` +
259
- ` 3. Try manual installation: sudo snap install termius-app`
260
- );
261
- }
262
-
263
- // Verify installation succeeded
264
- const verifyInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
265
- if (!verifyInstalled) {
266
- throw new Error(
267
- 'Installation command completed but Termius was not found.\n\n' +
268
- 'Please try:\n' +
269
- ' 1. Run: snap list termius-app\n' +
270
- ' 2. Retry: sudo snap install termius-app'
271
- );
272
- }
273
-
274
- const version = await snap.getSnapVersion(SNAP_PACKAGE_NAME);
275
- console.log(`Termius ${version || ''} installed successfully.`);
276
- console.log('');
277
- console.log('To launch Termius:');
278
- console.log(' - Run: termius-app &');
279
- console.log(' - Or find Termius in your application menu');
280
- console.log('');
281
- console.log('On first launch, you will be prompted to sign in or create an account.');
282
- console.log('Creating an account enables syncing hosts and settings across devices.');
283
- }
284
-
285
- /**
286
- * Install Termius on Raspberry Pi OS.
287
- *
288
- * PLATFORM LIMITATION: Termius does not provide native ARM packages for the
289
- * desktop application. The Termius Snap package and desktop application are
290
- * only available for x86_64 architecture. Raspberry Pi devices use ARM
291
- * processors (armhf or aarch64), which are not supported.
292
- *
293
- * Termius is primarily designed as a client TO connect to Raspberry Pi and
294
- * other ARM devices, not to run ON them directly.
295
- *
296
- * This function gracefully informs the user that Termius is not available for
297
- * Raspberry Pi OS without throwing an error or suggesting alternatives.
298
- *
299
- * @returns {Promise<void>}
300
- */
301
- async function install_raspbian() {
302
- console.log('Termius is not available for Raspberry Pi OS.');
303
- }
304
-
305
- /**
306
- * Install Termius on Amazon Linux/RHEL using Snap.
307
- *
308
- * Prerequisites:
309
- * - Amazon Linux 2023, Amazon Linux 2, RHEL 8/9, or Fedora (64-bit x86_64)
310
- * - sudo privileges
311
- * - Graphical desktop environment (required for Termius GUI)
312
- * - At least 300 MB free disk space
313
- *
314
- * IMPORTANT: Amazon Linux EC2 instances typically run headless (no GUI).
315
- * If you are running a headless server, install Termius on your local
316
- * workstation and use it to connect to your Amazon Linux instances.
317
- *
318
- * This function:
319
- * 1. Checks architecture (must be x86_64)
320
- * 2. Installs snapd if not already present (via EPEL for Amazon Linux 2)
321
- * 3. Enables and starts the snapd service
322
- * 4. Installs Termius via Snap
323
- *
324
- * @returns {Promise<void>}
325
- * @throws {Error} If installation fails
326
- */
327
- async function install_amazon_linux() {
328
- console.log('Checking if Termius is already installed...');
329
-
330
- // Check if Termius is already installed via Snap
331
- const snapInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
332
- if (snapInstalled) {
333
- const version = await snap.getSnapVersion(SNAP_PACKAGE_NAME);
334
- if (version) {
335
- console.log(`Termius ${version} is already installed via Snap, skipping installation.`);
336
- } else {
337
- console.log('Termius is already installed via Snap, skipping installation.');
338
- }
339
- return;
340
- }
341
-
342
- // Also check if termius-app command exists
343
- if (isTermiusCommandAvailable()) {
344
- console.log('Termius is already installed, skipping installation.');
345
- return;
346
- }
347
-
348
- // Verify architecture - Termius only supports x86_64
349
- const archResult = await shell.exec('uname -m');
350
- const arch = archResult.stdout.trim();
351
- if (arch !== 'x86_64') {
352
- console.log(`Termius is not available for ${arch} architecture.`);
353
- console.log('');
354
- console.log('Termius requires 64-bit x86_64 architecture for the native desktop app.');
355
- return;
356
- }
357
-
358
- // Detect package manager (dnf for AL2023/RHEL8+/Fedora, yum for AL2)
359
- const hasDnf = shell.commandExists('dnf');
360
- const hasYum = shell.commandExists('yum');
361
- const packageManager = hasDnf ? 'dnf' : (hasYum ? 'yum' : null);
362
-
363
- if (!packageManager) {
364
- throw new Error(
365
- 'Neither dnf nor yum package manager found.\n' +
366
- 'This installer supports Amazon Linux 2023 (dnf) and Amazon Linux 2 (yum).'
367
- );
368
- }
369
-
370
- console.log(`Detected package manager: ${packageManager}`);
371
-
372
- // Check if snapd is installed, if not, install it
373
- if (!snap.isInstalled()) {
374
- console.log('Snap is not installed. Installing snapd...');
375
-
376
- // For Amazon Linux 2, we need to enable EPEL first
377
- if (packageManager === 'yum') {
378
- console.log('Enabling EPEL repository for Amazon Linux 2...');
379
- const epelResult = await shell.exec('sudo amazon-linux-extras install -y epel');
380
- if (epelResult.code !== 0) {
381
- throw new Error(
382
- 'Failed to enable EPEL repository.\n' +
383
- 'Error: ' + epelResult.stderr + '\n\n' +
384
- 'Try manually: sudo amazon-linux-extras install -y epel'
385
- );
386
- }
387
- }
388
-
389
- // Install snapd
390
- console.log('Installing snapd...');
391
- const snapdResult = await shell.exec(`sudo ${packageManager} install -y snapd`);
392
- if (snapdResult.code !== 0) {
393
- throw new Error(
394
- 'Failed to install snapd.\n' +
395
- 'Error: ' + snapdResult.stderr + '\n\n' +
396
- `Try manually: sudo ${packageManager} install -y snapd`
397
- );
398
- }
399
-
400
- // Enable and start snapd socket
401
- console.log('Enabling snapd service...');
402
- const enableResult = await shell.exec('sudo systemctl enable --now snapd.socket');
403
- if (enableResult.code !== 0) {
404
- console.log('Warning: Could not enable snapd.socket. You may need to reboot.');
405
- }
406
-
407
- // Create the /snap symbolic link if it does not exist
408
- const linkResult = await shell.exec('sudo ln -sf /var/lib/snapd/snap /snap');
409
- if (linkResult.code !== 0) {
410
- console.log('Warning: Could not create /snap symlink.');
411
- }
412
-
413
- console.log('');
414
- console.log('NOTE: You may need to log out and back in (or reboot) for snap');
415
- console.log('to be available in your PATH before proceeding.');
416
- console.log('');
417
- }
418
-
419
- console.log('Installing Termius via Snap...');
420
- console.log('This may take a few minutes...');
421
-
422
- // Install Termius via Snap
423
- const result = await snap.install(SNAP_PACKAGE_NAME);
424
-
425
- if (!result.success) {
426
- throw new Error(
427
- `Failed to install Termius via Snap.\n` +
428
- `Output: ${result.output}\n\n` +
429
- `Troubleshooting:\n` +
430
- ` 1. Log out and back in, then retry\n` +
431
- ` 2. Ensure snapd is running: sudo systemctl start snapd\n` +
432
- ` 3. Try manual installation: sudo snap install termius-app`
433
- );
434
- }
435
-
436
- // Verify installation
437
- const verifyInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
438
- if (!verifyInstalled) {
439
- throw new Error(
440
- 'Installation command completed but Termius was not found.\n\n' +
441
- 'Please try:\n' +
442
- ' 1. Log out and back in\n' +
443
- ' 2. Run: snap list termius-app\n' +
444
- ' 3. Retry: sudo snap install termius-app'
445
- );
446
- }
447
-
448
- const version = await snap.getSnapVersion(SNAP_PACKAGE_NAME);
449
- console.log(`Termius ${version || ''} installed successfully.`);
450
- console.log('');
451
- console.log('To launch Termius:');
452
- console.log(' - Run: termius-app &');
453
- console.log(' - Or find Termius in your application menu');
454
- console.log('');
455
- console.log('NOTE: Termius requires a graphical desktop environment.');
456
- console.log('If running on a headless server, consider installing Termius on');
457
- console.log('your local workstation and connecting to this server remotely.');
458
- }
459
-
460
- /**
461
- * Install Termius on Windows using Chocolatey.
462
- *
463
- * Prerequisites:
464
- * - Windows 10 or Windows 11 (64-bit)
465
- * - At least 300 MB free disk space
466
- * - Administrator PowerShell or Command Prompt
467
- * - Chocolatey package manager installed
468
- *
469
- * The installation uses Chocolatey's 'termius' package which downloads and
470
- * installs the official Termius desktop application.
471
- *
472
- * NOTE: After installation, Termius can be launched from the Start Menu or
473
- * via the command line with 'Start-Process Termius'.
474
- *
475
- * @returns {Promise<void>}
476
- * @throws {Error} If Chocolatey is not installed or installation fails
477
- */
478
- async function install_windows() {
479
- console.log('Checking if Termius is already installed...');
480
-
481
- // Check if Termius is already installed via Chocolatey
482
- const isInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
483
- if (isInstalled) {
484
- const version = await choco.getPackageVersion(CHOCO_PACKAGE_NAME);
485
- if (version) {
486
- console.log(`Termius ${version} is already installed via Chocolatey, skipping installation.`);
487
- } else {
488
- console.log('Termius is already installed via Chocolatey, skipping installation.');
489
- }
490
- return;
491
- }
492
-
493
- // Verify Chocolatey is available before attempting installation
494
- if (!choco.isInstalled()) {
495
- throw new Error(
496
- 'Chocolatey is not installed. Please install Chocolatey first:\n\n' +
497
- 'Run the following in an Administrator PowerShell:\n' +
498
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
499
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
500
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
501
- 'Then retry installing Termius.'
502
- );
503
- }
504
-
505
- console.log('Installing Termius via Chocolatey...');
506
- console.log('This may take a few minutes...');
507
-
508
- // Install Termius using Chocolatey
509
- const result = await choco.install(CHOCO_PACKAGE_NAME);
510
-
511
- if (!result.success) {
512
- throw new Error(
513
- `Failed to install Termius via Chocolatey.\n` +
514
- `Output: ${result.output}\n\n` +
515
- `Troubleshooting:\n` +
516
- ` 1. Ensure you are running as Administrator\n` +
517
- ` 2. Run 'choco list termius' to check availability\n` +
518
- ` 3. Try manual installation: choco install termius -y`
519
- );
520
- }
521
-
522
- // Verify installation succeeded
523
- const verifyInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
524
- if (!verifyInstalled) {
525
- throw new Error(
526
- 'Installation command completed but Termius was not found.\n\n' +
527
- 'Please try:\n' +
528
- ' 1. Run: choco list termius\n' +
529
- ' 2. Retry: choco install termius -y'
530
- );
531
- }
532
-
533
- const version = await choco.getPackageVersion(CHOCO_PACKAGE_NAME);
534
- console.log(`Termius ${version || ''} installed successfully.`);
535
- console.log('');
536
- console.log('To launch Termius:');
537
- console.log(' - Open from Start Menu, or');
538
- console.log(' - Run: Start-Process "Termius"');
539
- console.log('');
540
- console.log('On first launch, you will be prompted to sign in or create an account.');
541
- console.log('Creating an account enables syncing hosts and settings across devices.');
542
- }
543
-
544
- /**
545
- * Install Termius when running from Ubuntu on WSL (Windows Subsystem for Linux).
546
- *
547
- * PLATFORM APPROACH: Termius is installed on the Windows host and accessed from
548
- * WSL using Windows interoperability. This is the recommended approach as Termius
549
- * is a GUI application best run on the Windows desktop.
550
- *
551
- * Prerequisites:
552
- * - Windows 10 version 2004 or higher, or Windows 11
553
- * - WSL 2 enabled with Ubuntu distribution installed
554
- * - Chocolatey installed on Windows for Termius installation
555
- *
556
- * This function installs Termius on the Windows host via PowerShell/Chocolatey.
557
- *
558
- * @returns {Promise<void>}
559
- * @throws {Error} If installation on Windows host fails
560
- */
561
- async function install_ubuntu_wsl() {
562
- console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
563
- console.log('');
564
- console.log('Installing Termius on the Windows host...');
565
- console.log('');
566
-
567
- // Check if Termius is already available on Windows via Chocolatey
568
- const slackCheck = await shell.exec('cmd.exe /c "choco list termius --local-only" 2>/dev/null');
569
- if (slackCheck.code === 0 && slackCheck.stdout.toLowerCase().includes('termius')) {
570
- console.log('Termius is already installed on Windows, skipping installation.');
571
- console.log('');
572
- console.log('To launch Termius from WSL:');
573
- console.log(' cmd.exe /c start "" "Termius"');
574
- return;
575
- }
576
-
577
- // Check if Chocolatey is available on Windows
578
- const chocoCheck = await shell.exec('powershell.exe -NoProfile -Command "choco --version"');
579
- if (chocoCheck.code !== 0) {
580
- throw new Error(
581
- 'Chocolatey is not installed on Windows.\n\n' +
582
- 'Install Chocolatey by running the following in an Administrator PowerShell:\n' +
583
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
584
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
585
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
586
- 'Then retry installing Termius.'
587
- );
588
- }
589
-
590
- console.log('Installing Termius via Chocolatey on Windows...');
591
- console.log('This may take a few minutes...');
592
-
593
- // Install via PowerShell using Chocolatey
594
- const installResult = await shell.exec(
595
- 'powershell.exe -NoProfile -Command "choco install termius -y"'
596
- );
597
-
598
- if (installResult.code !== 0) {
599
- throw new Error(
600
- `Failed to install Termius on Windows host.\n` +
601
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
602
- `Troubleshooting:\n` +
603
- ` 1. Ensure Chocolatey is installed on Windows\n` +
604
- ` 2. Open an Administrator PowerShell on Windows and run:\n` +
605
- ` choco install termius -y\n` +
606
- ` 3. Then launch from WSL with: cmd.exe /c start "" "Termius"`
607
- );
608
- }
609
-
610
- console.log('Termius installed successfully on Windows.');
611
- console.log('');
612
- console.log('To launch Termius from WSL:');
613
- console.log(' cmd.exe /c start "" "Termius"');
614
- console.log('');
615
- console.log('TIP: Add an alias to ~/.bashrc for convenience:');
616
- console.log(' echo \'alias termius="cmd.exe /c start \\"\\" \\"Termius\\""\' >> ~/.bashrc');
617
- }
618
-
619
- /**
620
- * Install Termius from Git Bash on Windows.
621
- *
622
- * Git Bash runs within Windows, so this function installs Termius on the
623
- * Windows host using Chocolatey via PowerShell interop.
624
- *
625
- * Prerequisites:
626
- * - Windows 10 or Windows 11 (64-bit)
627
- * - Git Bash installed (comes with Git for Windows)
628
- * - Chocolatey package manager installed on Windows
629
- * - Administrator privileges
630
- *
631
- * @returns {Promise<void>}
632
- * @throws {Error} If installation fails
633
- */
634
- async function install_gitbash() {
635
- console.log('Detected Git Bash on Windows.');
636
- console.log('Installing Termius on the Windows host...');
637
- console.log('');
638
-
639
- // Check if Termius is already installed via Chocolatey
640
- const termiusCheck = await shell.exec(
641
- 'powershell.exe -NoProfile -Command "choco list --local-only --exact termius"'
642
- );
643
- if (termiusCheck.code === 0 && termiusCheck.stdout.toLowerCase().includes('termius')) {
644
- console.log('Termius is already installed via Chocolatey, skipping installation.');
645
- console.log('');
646
- console.log('To launch Termius from Git Bash:');
647
- console.log(' start "" "Termius"');
648
- return;
649
- }
650
-
651
- // Check if Chocolatey is available
652
- const chocoCheck = await shell.exec('powershell.exe -NoProfile -Command "choco --version"');
653
- if (chocoCheck.code !== 0) {
654
- throw new Error(
655
- 'Chocolatey is not installed on Windows.\n\n' +
656
- 'Install Chocolatey by running the following in an Administrator PowerShell:\n' +
657
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
658
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
659
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
660
- 'Then retry installing Termius.'
661
- );
662
- }
663
-
664
- console.log('Installing Termius via Chocolatey...');
665
- console.log('This may take a few minutes...');
666
-
667
- // Install via PowerShell using Chocolatey
668
- const installResult = await shell.exec(
669
- 'powershell.exe -NoProfile -Command "choco install termius -y"'
670
- );
671
-
672
- if (installResult.code !== 0) {
673
- throw new Error(
674
- `Failed to install Termius.\n` +
675
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
676
- `Troubleshooting:\n` +
677
- ` 1. Ensure Chocolatey is installed on Windows\n` +
678
- ` 2. Run Git Bash as Administrator and retry\n` +
679
- ` 3. Try installing directly from PowerShell:\n` +
680
- ` choco install termius -y`
681
- );
682
- }
683
-
684
- console.log('Termius installed successfully.');
685
- console.log('');
686
- console.log('To launch Termius from Git Bash:');
687
- console.log(' start "" "Termius"');
688
- console.log('');
689
- console.log('Or use the explicit Windows command:');
690
- console.log(' cmd //c "start \\"\\" \\"Termius\\""');
691
- }
692
-
693
- /**
694
- * Check if Termius is installed on the current system.
695
- * @returns {Promise<boolean>} True if Termius is installed
696
- */
697
- async function isInstalled() {
698
- const platform = os.detect();
699
- if (platform.type === 'macos') {
700
- return brew.isCaskInstalled(HOMEBREW_CASK_NAME);
701
- }
702
- if (platform.type === 'windows') {
703
- return choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
704
- }
705
- if (['ubuntu', 'debian', 'amazon_linux', 'fedora', 'rhel'].includes(platform.type)) {
706
- return snap.isSnapInstalled(SNAP_PACKAGE_NAME);
707
- }
708
- return isTermiusCommandAvailable();
709
- }
710
-
711
- /**
712
- * Check if this installer is supported on the current platform.
713
- * Termius is not available for Raspberry Pi (ARM architecture not supported).
714
- * @returns {boolean} True if installation is supported on this platform
715
- */
716
- function isEligible() {
717
- const platform = os.detect();
718
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'];
719
- if (!supportedPlatforms.includes(platform.type)) {
720
- return false;
721
- }
722
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
723
- return false;
724
- }
725
- return true;
726
- }
727
-
728
- /**
729
- * Main installation entry point.
730
- *
731
- * Detects the current platform and runs the appropriate installer function.
732
- * Handles platform-specific mappings to ensure all supported platforms
733
- * have appropriate installation logic.
734
- *
735
- * Supported platforms:
736
- * - macOS: Termius Desktop via Homebrew cask
737
- * - Ubuntu/Debian: Termius Desktop via Snap (x86_64 only)
738
- * - Amazon Linux/RHEL: Termius Desktop via Snap + EPEL (x86_64 only)
739
- * - Windows: Termius Desktop via Chocolatey
740
- * - WSL (Ubuntu): Installs Termius on Windows host via Chocolatey
741
- * - Git Bash: Installs Termius on Windows host via Chocolatey
742
- *
743
- * Unsupported platforms:
744
- * - Raspberry Pi OS: ARM architecture not supported (graceful message)
745
- *
746
- * @returns {Promise<void>}
747
- */
748
- async function install() {
749
- const platform = os.detect();
750
-
751
- // Map platform types to their installer functions
752
- // This mapping handles aliases and variations for different distributions
753
- const installers = {
754
- 'macos': install_macos,
755
- 'ubuntu': install_ubuntu,
756
- 'debian': install_ubuntu,
757
- 'wsl': install_ubuntu_wsl,
758
- 'raspbian': install_raspbian,
759
- 'amazon_linux': install_amazon_linux,
760
- 'rhel': install_amazon_linux,
761
- 'fedora': install_amazon_linux,
762
- 'windows': install_windows,
763
- 'gitbash': install_gitbash
764
- };
765
-
766
- const installer = installers[platform.type];
767
-
768
- // If no installer is found for this platform, gracefully inform the user
769
- if (!installer) {
770
- console.log(`Termius is not available for ${platform.type}.`);
771
- return;
772
- }
773
-
774
- await installer();
775
- }
776
-
777
- // Export all functions for use as a module and for testing
778
- module.exports = {
779
- REQUIRES_DESKTOP,
780
- install,
781
- isInstalled,
782
- isEligible,
783
- install_macos,
784
- install_ubuntu,
785
- install_ubuntu_wsl,
786
- install_raspbian,
787
- install_amazon_linux,
788
- install_windows,
789
- install_gitbash
790
- };
791
-
792
- // Allow direct execution: node termius.js
793
- if (require.main === module) {
794
- install().catch(err => {
795
- console.error(err.message);
796
- process.exit(1);
797
- });
798
- }