@fredlackey/devutils 0.0.18 → 0.0.19

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