@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,949 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install gitego - a Git identity manager and automatic profile switcher.
5
- *
6
- * gitego eliminates the risk of committing to a repository with the wrong user
7
- * identity. It allows you to define separate profiles for work, personal projects,
8
- * and clients, then automatically switches between them based on your working
9
- * directory.
10
- *
11
- * Key features include:
12
- * - Automatic profile switching based on directory
13
- * - Unified identity management (user.name, email, SSH keys, PAT)
14
- * - Secure credential storage using native keychains
15
- * - Cross-platform support (macOS, Windows, Linux)
16
- *
17
- * gitego uses Git's `includeIf` directive for identity switching and acts as
18
- * a Git credential helper for HTTPS authentication.
19
- *
20
- * Prerequisites:
21
- * - Git must be installed
22
- * - Go 1.24 or later is required (gitego is installed via `go install`)
23
- *
24
- * @module installs/gitego
25
- * @see https://github.com/bgreenwell/gitego
26
- */
27
-
28
- const os = require('../utils/common/os');
29
- const shell = require('../utils/common/shell');
30
- const brew = require('../utils/macos/brew');
31
- const apt = require('../utils/ubuntu/apt');
32
- const choco = require('../utils/windows/choco');
33
- const winget = require('../utils/windows/winget');
34
-
35
- /**
36
- * The Go package path for gitego installation via `go install`.
37
- * @constant {string}
38
- */
39
- const GITEGO_PACKAGE = 'github.com/bgreenwell/gitego@latest';
40
-
41
- /**
42
- * Minimum required Go version for building gitego.
43
- * @constant {string}
44
- */
45
- const MIN_GO_VERSION = '1.24';
46
-
47
- /**
48
- * Checks if Go is installed and returns version information.
49
- *
50
- * @returns {Promise<{ installed: boolean, version: string|null, meetsMinimum: boolean }>}
51
- */
52
- async function checkGoInstallation() {
53
- const isInstalled = shell.commandExists('go');
54
- if (!isInstalled) {
55
- return { installed: false, version: null, meetsMinimum: false };
56
- }
57
-
58
- // Get the installed Go version
59
- const result = await shell.exec('go version');
60
- if (result.code !== 0) {
61
- return { installed: true, version: null, meetsMinimum: false };
62
- }
63
-
64
- // Parse version from output like "go version go1.24.0 darwin/arm64"
65
- const versionMatch = result.stdout.match(/go(\d+\.\d+)/);
66
- if (!versionMatch) {
67
- return { installed: true, version: null, meetsMinimum: false };
68
- }
69
-
70
- const version = versionMatch[1];
71
- const meetsMinimum = compareVersions(version, MIN_GO_VERSION) >= 0;
72
-
73
- return { installed: true, version, meetsMinimum };
74
- }
75
-
76
- /**
77
- * Compares two semantic version strings.
78
- *
79
- * @param {string} version1 - First version (e.g., "1.24")
80
- * @param {string} version2 - Second version (e.g., "1.24")
81
- * @returns {number} - Negative if v1 < v2, positive if v1 > v2, zero if equal
82
- */
83
- function compareVersions(version1, version2) {
84
- const parts1 = version1.split('.').map(Number);
85
- const parts2 = version2.split('.').map(Number);
86
-
87
- for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
88
- const part1 = parts1[i] || 0;
89
- const part2 = parts2[i] || 0;
90
- if (part1 !== part2) {
91
- return part1 - part2;
92
- }
93
- }
94
- return 0;
95
- }
96
-
97
- /**
98
- * Checks if gitego is already installed by looking for the command.
99
- *
100
- * @returns {boolean} - True if gitego command exists in PATH
101
- */
102
- function isGitegoInstalled() {
103
- return shell.commandExists('gitego');
104
- }
105
-
106
- /**
107
- * Installs gitego using `go install`.
108
- *
109
- * This function assumes Go is already installed and configured with
110
- * the Go bin directory in PATH.
111
- *
112
- * @returns {Promise<{ success: boolean, output: string }>}
113
- */
114
- async function installGitegoViaGo() {
115
- console.log('Installing gitego via go install...');
116
- const result = await shell.exec(`go install ${GITEGO_PACKAGE}`);
117
- return {
118
- success: result.code === 0,
119
- output: result.stdout || result.stderr
120
- };
121
- }
122
-
123
- /**
124
- * Configures Git to use gitego as the credential helper.
125
- *
126
- * This clears any existing credential helpers and sets gitego as the
127
- * primary credential helper for HTTPS operations.
128
- *
129
- * @returns {Promise<{ success: boolean, output: string }>}
130
- */
131
- async function configureGitCredentialHelper() {
132
- console.log('Configuring Git to use gitego as credential helper...');
133
-
134
- // Clear existing credential helpers first
135
- const clearResult = await shell.exec('git config --global credential.helper ""');
136
- if (clearResult.code !== 0) {
137
- return {
138
- success: false,
139
- output: `Failed to clear credential helper: ${clearResult.stderr}`
140
- };
141
- }
142
-
143
- // Add gitego as the credential helper
144
- const addResult = await shell.exec('git config --global --add credential.helper "!gitego credential"');
145
- return {
146
- success: addResult.code === 0,
147
- output: addResult.stdout || addResult.stderr
148
- };
149
- }
150
-
151
- /**
152
- * Verifies the gitego installation by running gitego --version.
153
- *
154
- * @returns {Promise<boolean>} - True if verification succeeds
155
- */
156
- async function verifyInstallation() {
157
- const result = await shell.exec('gitego --version');
158
- return result.code === 0;
159
- }
160
-
161
- /**
162
- * Install gitego on macOS using Homebrew.
163
- *
164
- * macOS installation steps:
165
- * 1. Verify Homebrew is available
166
- * 2. Install Go via Homebrew if not present
167
- * 3. Ensure Go bin directory is in PATH
168
- * 4. Install gitego via `go install`
169
- * 5. Configure Git credential helper
170
- *
171
- * @returns {Promise<void>}
172
- */
173
- async function install_macos() {
174
- // Check if gitego is already installed
175
- if (isGitegoInstalled()) {
176
- console.log('gitego is already installed, skipping...');
177
- return;
178
- }
179
-
180
- // Check if Homebrew is available - required for installing Go
181
- if (!brew.isInstalled()) {
182
- console.log('Homebrew is not installed. Please install Homebrew first.');
183
- console.log('Run: dev install homebrew');
184
- return;
185
- }
186
-
187
- // Check if Go is installed and meets minimum version requirement
188
- let goStatus = await checkGoInstallation();
189
-
190
- if (!goStatus.installed) {
191
- // Install Go via Homebrew
192
- console.log('Go is not installed. Installing Go via Homebrew...');
193
- const goInstallResult = await brew.install('go');
194
- if (!goInstallResult.success) {
195
- console.log('Failed to install Go via Homebrew.');
196
- console.log(goInstallResult.output);
197
- return;
198
- }
199
- console.log('Go installed successfully.');
200
-
201
- // Recheck Go installation after installing
202
- goStatus = await checkGoInstallation();
203
- }
204
-
205
- if (!goStatus.meetsMinimum) {
206
- console.log(`Go version ${goStatus.version || 'unknown'} is installed, but gitego requires Go ${MIN_GO_VERSION} or later.`);
207
- console.log('Please upgrade Go: brew upgrade go');
208
- return;
209
- }
210
-
211
- // Install gitego via go install
212
- const installResult = await installGitegoViaGo();
213
- if (!installResult.success) {
214
- console.log('Failed to install gitego via go install.');
215
- console.log(installResult.output);
216
- console.log('');
217
- console.log('Troubleshooting: Ensure ~/go/bin is in your PATH:');
218
- console.log(' echo \'export PATH="$PATH:$HOME/go/bin"\' >> ~/.zshrc && source ~/.zshrc');
219
- return;
220
- }
221
-
222
- // Configure Git credential helper
223
- const configResult = await configureGitCredentialHelper();
224
- if (!configResult.success) {
225
- console.log('Warning: Failed to configure Git credential helper.');
226
- console.log(configResult.output);
227
- console.log('You can configure it manually:');
228
- console.log(' git config --global credential.helper ""');
229
- console.log(' git config --global --add credential.helper "!gitego credential"');
230
- }
231
-
232
- // Verify the installation
233
- const verified = await verifyInstallation();
234
- if (!verified) {
235
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
236
- console.log('Add ~/go/bin to your PATH:');
237
- console.log(' echo \'export PATH="$PATH:$HOME/go/bin"\' >> ~/.zshrc && source ~/.zshrc');
238
- return;
239
- }
240
-
241
- console.log('gitego installed successfully.');
242
- console.log('');
243
- console.log('Next steps:');
244
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
245
- console.log(' gitego use personal');
246
- }
247
-
248
- /**
249
- * Install gitego on Ubuntu/Debian using APT.
250
- *
251
- * Ubuntu installation steps:
252
- * 1. Check if gitego is already installed
253
- * 2. Download and install Go from official source (APT version often outdated)
254
- * 3. Configure PATH to include Go directories
255
- * 4. Install gitego via `go install`
256
- * 5. Install libsecret for secure credential storage
257
- * 6. Configure Git credential helper
258
- *
259
- * @returns {Promise<void>}
260
- */
261
- async function install_ubuntu() {
262
- // Check if gitego is already installed
263
- if (isGitegoInstalled()) {
264
- console.log('gitego is already installed, skipping...');
265
- return;
266
- }
267
-
268
- // Check if Git is installed (required for gitego)
269
- if (!shell.commandExists('git')) {
270
- console.log('Git is not installed. Please install Git first.');
271
- console.log('Run: dev install git');
272
- return;
273
- }
274
-
275
- // Check if Go is installed and meets minimum version requirement
276
- let goStatus = await checkGoInstallation();
277
-
278
- if (!goStatus.installed || !goStatus.meetsMinimum) {
279
- // Go version in APT is often outdated, so we download directly from go.dev
280
- console.log('Installing Go from official source...');
281
-
282
- // Ensure wget is available (needed for downloading Go)
283
- if (!shell.commandExists('wget')) {
284
- console.log('Installing wget...');
285
- // Update package lists first (required for fresh containers)
286
- const updateResult = await apt.update();
287
- if (!updateResult.success) {
288
- console.log('Warning: Failed to update package lists.');
289
- console.log(updateResult.output);
290
- }
291
- const wgetResult = await apt.install('wget');
292
- if (!wgetResult.success) {
293
- console.log('Failed to install wget.');
294
- console.log(wgetResult.output);
295
- return;
296
- }
297
- }
298
-
299
- // Download Go tarball
300
- const downloadResult = await shell.exec(
301
- 'wget -q https://go.dev/dl/go1.24.0.linux-amd64.tar.gz -O /tmp/go.tar.gz'
302
- );
303
- if (downloadResult.code !== 0) {
304
- console.log('Failed to download Go.');
305
- console.log(downloadResult.stderr);
306
- return;
307
- }
308
-
309
- // Remove existing Go installation and extract new version
310
- const extractResult = await shell.exec(
311
- 'sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf /tmp/go.tar.gz'
312
- );
313
- if (extractResult.code !== 0) {
314
- console.log('Failed to extract Go.');
315
- console.log(extractResult.stderr);
316
- return;
317
- }
318
-
319
- // Clean up the downloaded archive
320
- await shell.exec('rm -f /tmp/go.tar.gz');
321
-
322
- console.log('Go installed successfully.');
323
- console.log('');
324
- console.log('Important: Add Go to your PATH by running:');
325
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
326
- console.log('');
327
-
328
- // Update PATH for the current session so we can continue installation
329
- process.env.PATH = `${process.env.PATH}:/usr/local/go/bin:${process.env.HOME}/go/bin`;
330
-
331
- // Verify Go is now available
332
- goStatus = await checkGoInstallation();
333
- if (!goStatus.installed) {
334
- console.log('Go installation completed, but go command not found.');
335
- console.log('Please add Go to your PATH and run this installer again.');
336
- return;
337
- }
338
- }
339
-
340
- // Install gitego via go install
341
- const installResult = await installGitegoViaGo();
342
- if (!installResult.success) {
343
- console.log('Failed to install gitego via go install.');
344
- console.log(installResult.output);
345
- return;
346
- }
347
-
348
- // Install libsecret for secure credential storage
349
- console.log('Installing libsecret for secure credential storage...');
350
- const libsecretResult = await apt.install('libsecret-1-0');
351
- if (!libsecretResult.success) {
352
- console.log('Warning: Failed to install libsecret. PAT storage may not work.');
353
- console.log('You can install it manually: sudo apt-get install -y libsecret-1-0');
354
- }
355
-
356
- // Configure Git credential helper
357
- const configResult = await configureGitCredentialHelper();
358
- if (!configResult.success) {
359
- console.log('Warning: Failed to configure Git credential helper.');
360
- console.log(configResult.output);
361
- }
362
-
363
- // Verify the installation
364
- const verified = await verifyInstallation();
365
- if (!verified) {
366
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
367
- console.log('Add the Go bin directories to your PATH:');
368
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
369
- return;
370
- }
371
-
372
- console.log('gitego installed successfully.');
373
- console.log('');
374
- console.log('Next steps:');
375
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
376
- console.log(' gitego use personal');
377
- }
378
-
379
- /**
380
- * Install gitego on Ubuntu running in WSL (Windows Subsystem for Linux).
381
- *
382
- * WSL installation follows the same process as native Ubuntu, with additional
383
- * configuration for credential storage since WSL does not have a native
384
- * secret service running by default.
385
- *
386
- * @returns {Promise<void>}
387
- */
388
- async function install_ubuntu_wsl() {
389
- // Check if gitego is already installed
390
- if (isGitegoInstalled()) {
391
- console.log('gitego is already installed, skipping...');
392
- return;
393
- }
394
-
395
- // Use the same installation process as Ubuntu
396
- await install_ubuntu();
397
-
398
- // If installation succeeded, provide WSL-specific guidance
399
- if (isGitegoInstalled()) {
400
- console.log('');
401
- console.log('WSL Note: For secure PAT storage, you may need to configure pass:');
402
- console.log(' sudo apt-get install -y pass gnupg');
403
- console.log(' gpg --gen-key');
404
- console.log(' pass init "your-gpg-key-id"');
405
- }
406
- }
407
-
408
- /**
409
- * Install gitego on Raspberry Pi OS using APT.
410
- *
411
- * Raspberry Pi installation follows the same process as Ubuntu, but uses
412
- * the appropriate ARM architecture Go binary (arm64 for 64-bit, armv6l
413
- * for 32-bit).
414
- *
415
- * Note: Compilation on Raspberry Pi may take several minutes due to
416
- * limited processing power.
417
- *
418
- * @returns {Promise<void>}
419
- */
420
- async function install_raspbian() {
421
- // Check if gitego is already installed
422
- if (isGitegoInstalled()) {
423
- console.log('gitego is already installed, skipping...');
424
- return;
425
- }
426
-
427
- // Check if Git is installed (required for gitego)
428
- if (!shell.commandExists('git')) {
429
- console.log('Git is not installed. Please install Git first.');
430
- console.log('Run: dev install git');
431
- return;
432
- }
433
-
434
- // Detect the architecture to download the correct Go binary
435
- const arch = os.getArch();
436
- let goArch;
437
- if (arch === 'arm64') {
438
- goArch = 'arm64';
439
- } else if (arch === 'arm') {
440
- goArch = 'armv6l';
441
- } else {
442
- console.log(`Unsupported architecture for Raspberry Pi: ${arch}`);
443
- return;
444
- }
445
-
446
- // Check if Go is installed and meets minimum version requirement
447
- let goStatus = await checkGoInstallation();
448
-
449
- if (!goStatus.installed || !goStatus.meetsMinimum) {
450
- console.log(`Installing Go for ${goArch} from official source...`);
451
-
452
- // Ensure wget is available (needed for downloading Go)
453
- if (!shell.commandExists('wget')) {
454
- console.log('Installing wget...');
455
- // Update package lists first (required for fresh containers)
456
- const updateResult = await apt.update();
457
- if (!updateResult.success) {
458
- console.log('Warning: Failed to update package lists.');
459
- console.log(updateResult.output);
460
- }
461
- const wgetResult = await apt.install('wget');
462
- if (!wgetResult.success) {
463
- console.log('Failed to install wget.');
464
- console.log(wgetResult.output);
465
- return;
466
- }
467
- }
468
-
469
- // Download Go tarball for the appropriate ARM architecture
470
- const downloadResult = await shell.exec(
471
- `wget -q https://go.dev/dl/go1.24.0.linux-${goArch}.tar.gz -O /tmp/go.tar.gz`
472
- );
473
- if (downloadResult.code !== 0) {
474
- console.log('Failed to download Go.');
475
- console.log(downloadResult.stderr);
476
- return;
477
- }
478
-
479
- // Remove existing Go installation and extract new version
480
- const extractResult = await shell.exec(
481
- 'sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf /tmp/go.tar.gz'
482
- );
483
- if (extractResult.code !== 0) {
484
- console.log('Failed to extract Go.');
485
- console.log(extractResult.stderr);
486
- return;
487
- }
488
-
489
- // Clean up the downloaded archive
490
- await shell.exec('rm -f /tmp/go.tar.gz');
491
-
492
- console.log('Go installed successfully.');
493
- console.log('');
494
- console.log('Important: Add Go to your PATH by running:');
495
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
496
- console.log('');
497
-
498
- // Update PATH for the current session
499
- process.env.PATH = `${process.env.PATH}:/usr/local/go/bin:${process.env.HOME}/go/bin`;
500
-
501
- goStatus = await checkGoInstallation();
502
- if (!goStatus.installed) {
503
- console.log('Go installation completed, but go command not found.');
504
- console.log('Please add Go to your PATH and run this installer again.');
505
- return;
506
- }
507
- }
508
-
509
- // Install gitego via go install
510
- // Note: This may take several minutes on Raspberry Pi
511
- console.log('Installing gitego (this may take several minutes on Raspberry Pi)...');
512
- const installResult = await installGitegoViaGo();
513
- if (!installResult.success) {
514
- console.log('Failed to install gitego via go install.');
515
- console.log(installResult.output);
516
- console.log('');
517
- console.log('If you see out-of-memory errors, try increasing swap space:');
518
- console.log(' sudo fallocate -l 2G /swapfile');
519
- console.log(' sudo chmod 600 /swapfile');
520
- console.log(' sudo mkswap /swapfile');
521
- console.log(' sudo swapon /swapfile');
522
- return;
523
- }
524
-
525
- // Install libsecret for secure credential storage
526
- console.log('Installing libsecret for secure credential storage...');
527
- const libsecretResult = await apt.install('libsecret-1-0');
528
- if (!libsecretResult.success) {
529
- console.log('Warning: Failed to install libsecret. PAT storage may not work.');
530
- }
531
-
532
- // Configure Git credential helper
533
- const configResult = await configureGitCredentialHelper();
534
- if (!configResult.success) {
535
- console.log('Warning: Failed to configure Git credential helper.');
536
- console.log(configResult.output);
537
- }
538
-
539
- // Verify the installation
540
- const verified = await verifyInstallation();
541
- if (!verified) {
542
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
543
- console.log('Add the Go bin directories to your PATH:');
544
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
545
- return;
546
- }
547
-
548
- console.log('gitego installed successfully.');
549
- console.log('');
550
- console.log('Next steps:');
551
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
552
- console.log(' gitego use personal');
553
- }
554
-
555
- /**
556
- * Install gitego on Amazon Linux using DNF or YUM.
557
- *
558
- * Amazon Linux installation steps:
559
- * 1. Check if gitego is already installed
560
- * 2. Download and install Go from official source
561
- * 3. Install gitego via `go install`
562
- * 4. Optionally install libsecret for credential storage
563
- * 5. Configure Git credential helper
564
- *
565
- * @returns {Promise<void>}
566
- */
567
- async function install_amazon_linux() {
568
- // Check if gitego is already installed
569
- if (isGitegoInstalled()) {
570
- console.log('gitego is already installed, skipping...');
571
- return;
572
- }
573
-
574
- // Check if Git is installed (required for gitego)
575
- if (!shell.commandExists('git')) {
576
- console.log('Git is not installed. Please install Git first.');
577
- console.log('Run: dev install git');
578
- return;
579
- }
580
-
581
- // Detect the platform to determine which package manager to use
582
- const platform = os.detect();
583
- const packageManager = platform.packageManager;
584
-
585
- // Check if Go is installed and meets minimum version requirement
586
- let goStatus = await checkGoInstallation();
587
-
588
- if (!goStatus.installed || !goStatus.meetsMinimum) {
589
- console.log('Installing Go from official source...');
590
-
591
- // Check if wget is available, install if not
592
- if (!shell.commandExists('wget')) {
593
- console.log('Installing wget...');
594
- const wgetCommand = packageManager === 'dnf'
595
- ? 'sudo dnf install -y wget'
596
- : 'sudo yum install -y wget';
597
- const wgetResult = await shell.exec(wgetCommand);
598
- if (wgetResult.code !== 0) {
599
- console.log('Failed to install wget.');
600
- return;
601
- }
602
- }
603
-
604
- // Download Go tarball
605
- const downloadResult = await shell.exec(
606
- 'wget -q https://go.dev/dl/go1.24.0.linux-amd64.tar.gz -O /tmp/go.tar.gz'
607
- );
608
- if (downloadResult.code !== 0) {
609
- console.log('Failed to download Go.');
610
- console.log(downloadResult.stderr);
611
- return;
612
- }
613
-
614
- // Remove existing Go installation and extract new version
615
- const extractResult = await shell.exec(
616
- 'sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf /tmp/go.tar.gz'
617
- );
618
- if (extractResult.code !== 0) {
619
- console.log('Failed to extract Go.');
620
- console.log(extractResult.stderr);
621
- return;
622
- }
623
-
624
- // Clean up the downloaded archive
625
- await shell.exec('rm -f /tmp/go.tar.gz');
626
-
627
- console.log('Go installed successfully.');
628
- console.log('');
629
- console.log('Important: Add Go to your PATH by running:');
630
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
631
- console.log('');
632
-
633
- // Update PATH for the current session
634
- process.env.PATH = `${process.env.PATH}:/usr/local/go/bin:${process.env.HOME}/go/bin`;
635
-
636
- goStatus = await checkGoInstallation();
637
- if (!goStatus.installed) {
638
- console.log('Go installation completed, but go command not found.');
639
- console.log('Please add Go to your PATH and run this installer again.');
640
- return;
641
- }
642
- }
643
-
644
- // Install gitego via go install
645
- const installResult = await installGitegoViaGo();
646
- if (!installResult.success) {
647
- console.log('Failed to install gitego via go install.');
648
- console.log(installResult.output);
649
- return;
650
- }
651
-
652
- // Install libsecret for secure credential storage (optional on headless servers)
653
- console.log('Installing libsecret for secure credential storage...');
654
- const libsecretCommand = packageManager === 'dnf'
655
- ? 'sudo dnf install -y libsecret'
656
- : 'sudo yum install -y libsecret';
657
- const libsecretResult = await shell.exec(libsecretCommand);
658
- if (libsecretResult.code !== 0) {
659
- console.log('Note: libsecret installation failed. This is expected on headless servers.');
660
- console.log('gitego will still work for identity switching, but PAT storage may require alternative configuration.');
661
- }
662
-
663
- // Configure Git credential helper
664
- const configResult = await configureGitCredentialHelper();
665
- if (!configResult.success) {
666
- console.log('Warning: Failed to configure Git credential helper.');
667
- console.log(configResult.output);
668
- }
669
-
670
- // Verify the installation
671
- const verified = await verifyInstallation();
672
- if (!verified) {
673
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
674
- console.log('Add the Go bin directories to your PATH:');
675
- console.log(' echo \'export PATH="$PATH:/usr/local/go/bin:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
676
- return;
677
- }
678
-
679
- console.log('gitego installed successfully.');
680
- console.log('');
681
- console.log('Next steps:');
682
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
683
- console.log(' gitego use personal');
684
- }
685
-
686
- /**
687
- * Install gitego on Windows using Chocolatey or winget.
688
- *
689
- * Windows installation steps:
690
- * 1. Check if gitego is already installed
691
- * 2. Verify Chocolatey or winget is available
692
- * 3. Install Go via the available package manager
693
- * 4. Install gitego via `go install`
694
- * 5. Configure Git credential helper
695
- *
696
- * Note: After installation, a new terminal window must be opened for
697
- * PATH changes to take effect.
698
- *
699
- * @returns {Promise<void>}
700
- */
701
- async function install_windows() {
702
- // Check if gitego is already installed
703
- if (isGitegoInstalled()) {
704
- console.log('gitego is already installed, skipping...');
705
- return;
706
- }
707
-
708
- // Check if Git is installed (required for gitego)
709
- if (!shell.commandExists('git')) {
710
- console.log('Git is not installed. Please install Git first.');
711
- console.log('Run: dev install git');
712
- return;
713
- }
714
-
715
- // Determine which package manager to use (prefer winget, fall back to Chocolatey)
716
- const hasWinget = winget.isInstalled();
717
- const hasChoco = choco.isInstalled();
718
-
719
- if (!hasWinget && !hasChoco) {
720
- console.log('Neither winget nor Chocolatey is installed.');
721
- console.log('Please install Chocolatey first: dev install chocolatey');
722
- return;
723
- }
724
-
725
- // Check if Go is installed and meets minimum version requirement
726
- let goStatus = await checkGoInstallation();
727
-
728
- if (!goStatus.installed || !goStatus.meetsMinimum) {
729
- console.log('Installing Go...');
730
-
731
- let goInstallResult;
732
- if (hasChoco) {
733
- goInstallResult = await choco.install('golang');
734
- } else {
735
- goInstallResult = await winget.install('GoLang.Go');
736
- }
737
-
738
- if (!goInstallResult.success) {
739
- console.log('Failed to install Go.');
740
- console.log(goInstallResult.output);
741
- return;
742
- }
743
-
744
- console.log('Go installed successfully.');
745
- console.log('');
746
- console.log('Important: Close and reopen your terminal for PATH changes to take effect.');
747
- console.log('Then run this installer again to complete gitego installation.');
748
- return;
749
- }
750
-
751
- // Install gitego via go install
752
- const installResult = await installGitegoViaGo();
753
- if (!installResult.success) {
754
- console.log('Failed to install gitego via go install.');
755
- console.log(installResult.output);
756
- console.log('');
757
- console.log('Troubleshooting: Ensure the Go bin directory is in your PATH.');
758
- console.log('The Go bin directory is typically at: %USERPROFILE%\\go\\bin');
759
- return;
760
- }
761
-
762
- // Configure Git credential helper
763
- const configResult = await configureGitCredentialHelper();
764
- if (!configResult.success) {
765
- console.log('Warning: Failed to configure Git credential helper.');
766
- console.log(configResult.output);
767
- console.log('You can configure it manually in PowerShell:');
768
- console.log(' git config --global credential.helper ""');
769
- console.log(' git config --global --add credential.helper "!gitego credential"');
770
- }
771
-
772
- // Verify the installation
773
- const verified = await verifyInstallation();
774
- if (!verified) {
775
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
776
- console.log('Close and reopen your terminal, then verify with: gitego --version');
777
- return;
778
- }
779
-
780
- console.log('gitego installed successfully.');
781
- console.log('');
782
- console.log('Note: Close and reopen your terminal for PATH changes to take effect.');
783
- console.log('');
784
- console.log('Next steps:');
785
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
786
- console.log(' gitego use personal');
787
- }
788
-
789
- /**
790
- * Install gitego on Git Bash (Windows).
791
- *
792
- * Git Bash runs on Windows, so gitego installation follows the Windows
793
- * process. The gitego binary installed on Windows will be available
794
- * in Git Bash since Git Bash inherits the Windows PATH.
795
- *
796
- * @returns {Promise<void>}
797
- */
798
- async function install_gitbash() {
799
- // Check if gitego is already installed
800
- if (isGitegoInstalled()) {
801
- console.log('gitego is already installed, skipping...');
802
- return;
803
- }
804
-
805
- // Check if Go is available
806
- const goStatus = await checkGoInstallation();
807
- if (!goStatus.installed) {
808
- console.log('Go is not installed. Please install Go on Windows first.');
809
- console.log('');
810
- console.log('From an Administrator PowerShell, run:');
811
- console.log(' choco install golang -y');
812
- console.log('');
813
- console.log('Or with winget:');
814
- console.log(' winget install --id GoLang.Go --silent');
815
- console.log('');
816
- console.log('Then restart Git Bash and run this installer again.');
817
- return;
818
- }
819
-
820
- if (!goStatus.meetsMinimum) {
821
- console.log(`Go version ${goStatus.version} is installed, but gitego requires Go ${MIN_GO_VERSION} or later.`);
822
- console.log('Please upgrade Go and try again.');
823
- return;
824
- }
825
-
826
- // Install gitego via go install
827
- const installResult = await installGitegoViaGo();
828
- if (!installResult.success) {
829
- console.log('Failed to install gitego via go install.');
830
- console.log(installResult.output);
831
- console.log('');
832
- console.log('Troubleshooting: Ensure ~/go/bin is in your PATH:');
833
- console.log(' echo \'export PATH="$PATH:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
834
- return;
835
- }
836
-
837
- // Configure Git credential helper
838
- const configResult = await configureGitCredentialHelper();
839
- if (!configResult.success) {
840
- console.log('Warning: Failed to configure Git credential helper.');
841
- console.log(configResult.output);
842
- }
843
-
844
- // Verify the installation
845
- const verified = await verifyInstallation();
846
- if (!verified) {
847
- console.log('Installation may have succeeded, but gitego command not found in PATH.');
848
- console.log('Add ~/go/bin to your PATH:');
849
- console.log(' echo \'export PATH="$PATH:$HOME/go/bin"\' >> ~/.bashrc && source ~/.bashrc');
850
- return;
851
- }
852
-
853
- console.log('gitego installed successfully.');
854
- console.log('');
855
- console.log('Next steps:');
856
- console.log(' gitego add personal --name "Your Name" --email "you@example.com"');
857
- console.log(' gitego use personal');
858
- }
859
-
860
- /**
861
- * Check if gitego is currently installed on the system.
862
- *
863
- * This function checks if the gitego command exists in PATH.
864
- * gitego is installed via `go install` on all platforms.
865
- *
866
- * @returns {Promise<boolean>} True if gitego is installed, false otherwise
867
- */
868
- async function isInstalled() {
869
- return isGitegoInstalled();
870
- }
871
-
872
- /**
873
- * Check if this installer is supported on the current platform.
874
- * gitego is supported on all major platforms via Go.
875
- * @returns {boolean} True if installation is supported on this platform
876
- */
877
- function isEligible() {
878
- const platform = os.detect();
879
- return ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'fedora', 'rhel', 'windows', 'gitbash'].includes(platform.type);
880
- }
881
-
882
- /**
883
- * Main installation entry point - detects platform and runs appropriate installer.
884
- *
885
- * This function detects the current operating system and dispatches to the
886
- * appropriate platform-specific installer function. gitego is supported on
887
- * all major platforms through Go's cross-platform compilation.
888
- *
889
- * Supported platforms:
890
- * - macOS (via Homebrew for Go, then go install)
891
- * - Ubuntu/Debian (via official Go tarball, then go install)
892
- * - Ubuntu on WSL (same as Ubuntu, with WSL-specific guidance)
893
- * - Raspberry Pi OS (via ARM Go tarball, then go install)
894
- * - Amazon Linux/RHEL (via official Go tarball, then go install)
895
- * - Windows (via Chocolatey/winget for Go, then go install)
896
- * - Git Bash (uses Windows Go installation)
897
- *
898
- * @returns {Promise<void>}
899
- */
900
- async function install() {
901
- const platform = os.detect();
902
-
903
- // Map platform types to their corresponding installer functions
904
- // Multiple platform types can map to the same installer (e.g., debian and ubuntu)
905
- const installers = {
906
- 'macos': install_macos,
907
- 'ubuntu': install_ubuntu,
908
- 'debian': install_ubuntu,
909
- 'wsl': install_ubuntu_wsl,
910
- 'raspbian': install_raspbian,
911
- 'amazon_linux': install_amazon_linux,
912
- 'fedora': install_amazon_linux,
913
- 'rhel': install_amazon_linux,
914
- 'windows': install_windows,
915
- 'gitbash': install_gitbash,
916
- };
917
-
918
- // Look up the installer for the detected platform
919
- const installer = installers[platform.type];
920
-
921
- // If no installer exists for this platform, inform the user gracefully
922
- if (!installer) {
923
- console.log(`gitego is not available for ${platform.type}.`);
924
- return;
925
- }
926
-
927
- // Run the platform-specific installer
928
- await installer();
929
- }
930
-
931
- module.exports = {
932
- install,
933
- isInstalled,
934
- isEligible,
935
- install_macos,
936
- install_ubuntu,
937
- install_ubuntu_wsl,
938
- install_raspbian,
939
- install_amazon_linux,
940
- install_windows,
941
- install_gitbash,
942
- };
943
-
944
- if (require.main === module) {
945
- install().catch(err => {
946
- console.error(err.message);
947
- process.exit(1);
948
- });
949
- }