@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,811 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Gemini CLI - Google's AI coding assistant CLI tool.
5
- *
6
- * Gemini CLI is an open-source AI agent developed by Google that brings the
7
- * power of Gemini directly into your terminal. It provides interactive
8
- * conversations, code assistance, file operations, shell command execution,
9
- * and web search directly from the command line.
10
- *
11
- * Gemini CLI is distinct from Google's web-based Gemini interface. It runs
12
- * a ReAct (reason and act) agent loop that can decide when to use built-in
13
- * tools versus when to respond directly.
14
- *
15
- * Prerequisites:
16
- * - Google Account (required for authentication, personal accounts provide free tier)
17
- * - Node.js 20 or higher (for npm-based installation on Linux platforms)
18
- * - Internet connection (required for authentication and all AI processing)
19
- *
20
- * Free tier benefits:
21
- * - 60 requests per minute
22
- * - 1,000 requests per day
23
- * - Access to Gemini 2.5 Pro with 1 million token context window
24
- *
25
- * @module installs/gemini-cli
26
- * @see https://github.com/google-gemini/gemini-cli
27
- * @see https://geminicli.com/docs/get-started/installation/
28
- */
29
-
30
- const os = require('../utils/common/os');
31
- const shell = require('../utils/common/shell');
32
- const brew = require('../utils/macos/brew');
33
- const apt = require('../utils/ubuntu/apt');
34
- const winget = require('../utils/windows/winget');
35
- const choco = require('../utils/windows/choco');
36
-
37
- /**
38
- * The command name used to verify Gemini CLI installation.
39
- * @constant {string}
40
- */
41
- const GEMINI_COMMAND = 'gemini';
42
-
43
- /**
44
- * The Homebrew formula name for Gemini CLI on macOS.
45
- * Note: Gemini CLI is installed as a formula (CLI tool), not a cask (GUI app).
46
- * @constant {string}
47
- */
48
- const HOMEBREW_FORMULA_NAME = 'gemini-cli';
49
-
50
- /**
51
- * The npm package name for Gemini CLI.
52
- * This is the primary installation method for Linux platforms.
53
- * @constant {string}
54
- */
55
- const NPM_PACKAGE_NAME = '@google/gemini-cli';
56
-
57
- /**
58
- * The winget package ID for Node.js LTS on Windows.
59
- * Used to ensure Node.js is installed before npm-based installation.
60
- * @constant {string}
61
- */
62
- const WINGET_NODEJS_ID = 'OpenJS.NodeJS.LTS';
63
-
64
- /**
65
- * The Chocolatey package name for Node.js LTS on Windows.
66
- * Used as fallback when winget is not available.
67
- * @constant {string}
68
- */
69
- const CHOCO_NODEJS_PACKAGE = 'nodejs-lts';
70
-
71
- /**
72
- * The minimum required Node.js major version for Gemini CLI.
73
- * Gemini CLI requires Node.js 20 or higher.
74
- * @constant {number}
75
- */
76
- const MIN_NODE_VERSION = 20;
77
-
78
- /**
79
- * Checks if Gemini CLI is already installed on the system.
80
- * Uses the shell utility to search for the 'gemini' command in PATH.
81
- *
82
- * @returns {boolean} True if Gemini CLI is installed and accessible via PATH
83
- */
84
- function isGeminiCliInstalled() {
85
- return shell.commandExists(GEMINI_COMMAND);
86
- }
87
-
88
- /**
89
- * Gets the installed version of Gemini CLI.
90
- * Runs 'gemini --version' and parses the output.
91
- *
92
- * @returns {Promise<string|null>} The version string (e.g., "0.22.5") or null if not installed
93
- */
94
- async function getInstalledVersion() {
95
- if (!isGeminiCliInstalled()) {
96
- return null;
97
- }
98
-
99
- const result = await shell.exec('gemini --version');
100
- if (result.code === 0 && result.stdout) {
101
- // Output format is typically just the version number: "0.22.5"
102
- const version = result.stdout.trim();
103
- // Handle various output formats, extract first numeric version pattern
104
- const match = version.match(/(\d+\.\d+\.?\d*)/);
105
- return match ? match[1] : version;
106
- }
107
- return null;
108
- }
109
-
110
- /**
111
- * Checks if Node.js is installed and meets the minimum version requirement.
112
- * Gemini CLI requires Node.js 20 or later.
113
- *
114
- * @returns {Promise<{ installed: boolean, version: string|null, meetsMinimum: boolean }>}
115
- * Object containing Node.js installation status, version, and whether it meets minimum requirements
116
- */
117
- async function checkNodeVersion() {
118
- const isNodeInstalled = shell.commandExists('node');
119
- if (!isNodeInstalled) {
120
- return { installed: false, version: null, meetsMinimum: false };
121
- }
122
-
123
- const result = await shell.exec('node --version');
124
- if (result.code === 0 && result.stdout) {
125
- // Output format: "v22.0.0"
126
- const version = result.stdout.trim().replace(/^v/, '');
127
- const majorVersion = parseInt(version.split('.')[0], 10);
128
- return {
129
- installed: true,
130
- version: version,
131
- meetsMinimum: majorVersion >= MIN_NODE_VERSION
132
- };
133
- }
134
-
135
- return { installed: true, version: null, meetsMinimum: false };
136
- }
137
-
138
- /**
139
- * Checks if npm is installed and available.
140
- *
141
- * @returns {boolean} True if npm command is available in PATH
142
- */
143
- function isNpmInstalled() {
144
- return shell.commandExists('npm');
145
- }
146
-
147
- /**
148
- * Configures npm to use a user-level global directory.
149
- * This prevents permission issues when installing global packages without sudo.
150
- *
151
- * Creates ~/.npm-global directory and sets npm prefix to use it.
152
- * This follows npm's recommended best practice for global installations.
153
- *
154
- * @returns {Promise<{ success: boolean, binPath: string }>}
155
- * Object containing success status and the path to the npm global bin directory
156
- */
157
- async function configureNpmGlobalDirectory() {
158
- const homeDir = os.getHomeDir();
159
- const npmGlobalDir = `${homeDir}/.npm-global`;
160
- const npmGlobalBin = `${npmGlobalDir}/bin`;
161
-
162
- // Create the npm global directory if it doesn't exist
163
- await shell.exec(`mkdir -p ${npmGlobalDir}`);
164
-
165
- // Set npm prefix to use the user directory
166
- const configResult = await shell.exec(`npm config set prefix ${npmGlobalDir}`);
167
-
168
- return {
169
- success: configResult.code === 0,
170
- binPath: npmGlobalBin
171
- };
172
- }
173
-
174
- /**
175
- * Installs Gemini CLI via npm.
176
- * This is a helper function used by multiple platform installers.
177
- *
178
- * @param {Object} [options] - Installation options
179
- * @param {boolean} [options.showPathInstructions=true] - Whether to show PATH update instructions
180
- * @returns {Promise<boolean>} True if installation succeeded, false otherwise
181
- */
182
- async function installViaNpm(options = {}) {
183
- const showPathInstructions = options.showPathInstructions !== false;
184
-
185
- // Step 1: Check Node.js version
186
- const nodeInfo = await checkNodeVersion();
187
-
188
- if (!nodeInfo.installed) {
189
- console.log('Node.js is required for Gemini CLI but is not installed.');
190
- console.log('Please install Node.js 20 or later first.');
191
- console.log('Run: dev install node');
192
- return false;
193
- }
194
-
195
- if (!nodeInfo.meetsMinimum) {
196
- console.log(`Node.js ${nodeInfo.version} is installed but Gemini CLI requires Node.js ${MIN_NODE_VERSION}+.`);
197
- console.log('Please upgrade Node.js to version 20 or later.');
198
- return false;
199
- }
200
-
201
- // Step 2: Check npm is available
202
- if (!isNpmInstalled()) {
203
- console.log('npm is not available. Please ensure Node.js is installed correctly.');
204
- return false;
205
- }
206
-
207
- // Step 3: Configure npm to use user directory (avoids sudo requirement)
208
- console.log('Configuring npm for user-level global installs...');
209
- const npmConfig = await configureNpmGlobalDirectory();
210
-
211
- if (!npmConfig.success) {
212
- console.log('Failed to configure npm global directory.');
213
- return false;
214
- }
215
-
216
- // Step 4: Install Gemini CLI via npm
217
- console.log('Installing Gemini CLI via npm...');
218
- const installResult = await shell.exec(`npm install -g ${NPM_PACKAGE_NAME}`, {
219
- timeout: 300000, // 5 minute timeout for download and installation
220
- env: {
221
- ...process.env,
222
- PATH: `${npmConfig.binPath}:${process.env.PATH}`
223
- }
224
- });
225
-
226
- if (installResult.code !== 0) {
227
- console.log('Failed to install Gemini CLI via npm.');
228
- console.log(installResult.stderr || installResult.stdout);
229
- return false;
230
- }
231
-
232
- // Step 5: Provide PATH instructions if requested
233
- if (showPathInstructions) {
234
- console.log('Gemini CLI installed successfully via npm.');
235
- console.log(`Ensure ${npmConfig.binPath} is in your PATH.`);
236
- console.log('Add this to your shell profile if not already present:');
237
- console.log(` export PATH="${npmConfig.binPath}:$PATH"`);
238
- console.log('');
239
- console.log('Then run "gemini" to start and authenticate with your Google account.');
240
- }
241
-
242
- return true;
243
- }
244
-
245
- /**
246
- * Install Gemini CLI on macOS using Homebrew.
247
- *
248
- * This function installs Gemini CLI via the Homebrew formula. Homebrew must be
249
- * installed first. The installation is idempotent - if Gemini CLI is already
250
- * installed, the function will skip installation and return early.
251
- *
252
- * Homebrew handles Node.js as a dependency automatically.
253
- *
254
- * @returns {Promise<void>}
255
- */
256
- async function install_macos() {
257
- // Step 1: Check if Gemini CLI is already installed
258
- if (isGeminiCliInstalled()) {
259
- const version = await getInstalledVersion();
260
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
261
- return;
262
- }
263
-
264
- // Step 2: Verify Homebrew is available
265
- if (!brew.isInstalled()) {
266
- console.log('Homebrew is not installed. Please install Homebrew first.');
267
- console.log('Run: dev install homebrew');
268
- return;
269
- }
270
-
271
- // Step 3: Install Gemini CLI via Homebrew formula
272
- // Note: Using install() not installCask() because gemini-cli is a CLI tool formula
273
- console.log('Installing Gemini CLI via Homebrew...');
274
- const installResult = await brew.install(HOMEBREW_FORMULA_NAME);
275
-
276
- if (!installResult.success) {
277
- console.log('Failed to install Gemini CLI via Homebrew.');
278
- console.log(installResult.output);
279
- return;
280
- }
281
-
282
- // Step 4: Verify the installation succeeded
283
- // Note: We need to re-check since brew may have added new entries to PATH
284
- const verifyResult = await shell.exec('gemini --version');
285
- if (verifyResult.code !== 0) {
286
- console.log('Installation completed but Gemini CLI command is not in PATH.');
287
- console.log('Try opening a new terminal window or run: source ~/.zshrc');
288
- return;
289
- }
290
-
291
- console.log('Gemini CLI installed successfully.');
292
- console.log('Run "gemini" to start, then authenticate with your Google account.');
293
- }
294
-
295
- /**
296
- * Install Gemini CLI on Ubuntu/Debian using npm.
297
- *
298
- * This function installs Node.js from the NodeSource repository if needed,
299
- * then installs Gemini CLI via npm. The installation is idempotent - if
300
- * Gemini CLI is already installed, it will skip installation.
301
- *
302
- * Important: Do NOT use sudo with npm install -g. Instead, configure npm
303
- * to use a user-level global directory to avoid permission issues.
304
- *
305
- * @returns {Promise<void>}
306
- */
307
- async function install_ubuntu() {
308
- // Step 1: Check if Gemini CLI is already installed
309
- if (isGeminiCliInstalled()) {
310
- const version = await getInstalledVersion();
311
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
312
- return;
313
- }
314
-
315
- // Step 2: Verify curl is available for potential NodeSource installation
316
- if (!shell.commandExists('curl')) {
317
- console.log('curl is required but not installed. Installing curl...');
318
- const curlResult = await apt.install('curl');
319
- if (!curlResult.success) {
320
- console.log('Failed to install curl. Please install it manually.');
321
- return;
322
- }
323
- }
324
-
325
- // Step 3: Check Node.js version and install/upgrade if needed
326
- const nodeInfo = await checkNodeVersion();
327
-
328
- if (!nodeInfo.installed || !nodeInfo.meetsMinimum) {
329
- console.log('Installing Node.js 22 (LTS) from NodeSource...');
330
-
331
- // Install Node.js from NodeSource repository
332
- const nodeSourceResult = await shell.exec(
333
- 'curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -',
334
- { timeout: 120000 } // 2 minute timeout
335
- );
336
-
337
- if (nodeSourceResult.code !== 0) {
338
- console.log('Failed to add NodeSource repository.');
339
- console.log(nodeSourceResult.stderr || nodeSourceResult.stdout);
340
- return;
341
- }
342
-
343
- const nodeInstallResult = await shell.exec(
344
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nodejs',
345
- { timeout: 180000 } // 3 minute timeout
346
- );
347
-
348
- if (nodeInstallResult.code !== 0) {
349
- console.log('Failed to install Node.js.');
350
- console.log(nodeInstallResult.stderr || nodeInstallResult.stdout);
351
- return;
352
- }
353
-
354
- // Verify Node.js was installed correctly
355
- const newNodeInfo = await checkNodeVersion();
356
- if (!newNodeInfo.meetsMinimum) {
357
- console.log('Node.js installation completed but version is still below required minimum.');
358
- console.log(`Installed: ${newNodeInfo.version}, Required: ${MIN_NODE_VERSION}+`);
359
- return;
360
- }
361
- }
362
-
363
- // Step 4: Install Gemini CLI via npm
364
- console.log('Installing Gemini CLI via npm...');
365
- const success = await installViaNpm({ showPathInstructions: true });
366
-
367
- if (success) {
368
- console.log('');
369
- console.log('Run "source ~/.bashrc" or open a new terminal to update your PATH.');
370
- }
371
- }
372
-
373
- /**
374
- * Install Gemini CLI on Raspberry Pi OS using npm.
375
- *
376
- * Gemini CLI works on Raspberry Pi with 64-bit Raspberry Pi OS (aarch64).
377
- * The 32-bit version (armv7l) is NOT supported.
378
- *
379
- * Requirements:
380
- * - 64-bit Raspberry Pi OS (aarch64 architecture required)
381
- * - Raspberry Pi 4 or later with 4GB+ RAM recommended
382
- *
383
- * @returns {Promise<void>}
384
- */
385
- async function install_raspbian() {
386
- // Step 1: Check if Gemini CLI is already installed
387
- if (isGeminiCliInstalled()) {
388
- const version = await getInstalledVersion();
389
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
390
- return;
391
- }
392
-
393
- // Step 2: Verify architecture is 64-bit (Gemini CLI requires aarch64)
394
- const archResult = await shell.exec('uname -m');
395
- const architecture = archResult.stdout.trim();
396
- if (architecture !== 'aarch64') {
397
- console.log('Gemini CLI requires 64-bit Raspberry Pi OS (aarch64).');
398
- console.log(`Current architecture: ${architecture}`);
399
- console.log('Please install 64-bit Raspberry Pi OS from https://www.raspberrypi.com/software/');
400
- return;
401
- }
402
-
403
- // Step 3: Verify curl is available
404
- if (!shell.commandExists('curl')) {
405
- console.log('curl is required but not installed. Installing curl...');
406
- const curlResult = await apt.install('curl');
407
- if (!curlResult.success) {
408
- console.log('Failed to install curl. Please install it manually.');
409
- return;
410
- }
411
- }
412
-
413
- // Step 4: Check Node.js version and install/upgrade if needed
414
- const nodeInfo = await checkNodeVersion();
415
-
416
- if (!nodeInfo.installed || !nodeInfo.meetsMinimum) {
417
- console.log('Installing Node.js 22 (LTS) from NodeSource...');
418
-
419
- // Install Node.js from NodeSource repository
420
- const nodeSourceResult = await shell.exec(
421
- 'curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -',
422
- { timeout: 120000 } // 2 minute timeout
423
- );
424
-
425
- if (nodeSourceResult.code !== 0) {
426
- console.log('Failed to add NodeSource repository.');
427
- console.log(nodeSourceResult.stderr || nodeSourceResult.stdout);
428
- return;
429
- }
430
-
431
- const nodeInstallResult = await shell.exec(
432
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nodejs',
433
- { timeout: 180000 } // 3 minute timeout
434
- );
435
-
436
- if (nodeInstallResult.code !== 0) {
437
- console.log('Failed to install Node.js.');
438
- console.log(nodeInstallResult.stderr || nodeInstallResult.stdout);
439
- return;
440
- }
441
- }
442
-
443
- // Step 5: Install Gemini CLI via npm (recommended for Raspberry Pi)
444
- console.log('Installing Gemini CLI via npm (recommended for Raspberry Pi)...');
445
- const success = await installViaNpm({ showPathInstructions: true });
446
-
447
- if (success) {
448
- console.log('');
449
- console.log('Run "source ~/.bashrc" or open a new terminal to update your PATH.');
450
- console.log('');
451
- console.log('Note: Raspberry Pi has limited resources. For best performance:');
452
- console.log(' - Close other applications when using Gemini CLI');
453
- console.log(' - Use a Raspberry Pi 4 or later with 4GB+ RAM');
454
- }
455
- }
456
-
457
- /**
458
- * Install Gemini CLI on Amazon Linux/RHEL using npm.
459
- *
460
- * This function installs Node.js from the NodeSource repository if needed,
461
- * then installs Gemini CLI via npm. Works on Amazon Linux 2023, Amazon Linux 2,
462
- * RHEL 8+, CentOS Stream 8+, and Fedora.
463
- *
464
- * Amazon Linux is typically used as a server OS. Gemini CLI works well in
465
- * headless environments - use API key authentication for non-interactive use.
466
- *
467
- * @returns {Promise<void>}
468
- */
469
- async function install_amazon_linux() {
470
- // Step 1: Check if Gemini CLI is already installed
471
- if (isGeminiCliInstalled()) {
472
- const version = await getInstalledVersion();
473
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
474
- return;
475
- }
476
-
477
- // Step 2: Determine package manager (dnf for AL2023/RHEL8+, yum for AL2)
478
- const platform = os.detect();
479
- const packageManager = platform.packageManager || 'yum';
480
-
481
- // Step 3: Verify curl is available
482
- if (!shell.commandExists('curl')) {
483
- console.log('curl is required but not installed. Installing curl...');
484
- const curlCommand = packageManager === 'dnf'
485
- ? 'sudo dnf install -y curl'
486
- : 'sudo yum install -y curl';
487
-
488
- const curlResult = await shell.exec(curlCommand);
489
- if (curlResult.code !== 0) {
490
- console.log('Failed to install curl. Please install it manually.');
491
- return;
492
- }
493
- }
494
-
495
- // Step 4: Check Node.js version and install/upgrade if needed
496
- const nodeInfo = await checkNodeVersion();
497
-
498
- if (!nodeInfo.installed || !nodeInfo.meetsMinimum) {
499
- console.log('Installing Node.js 22 (LTS) from NodeSource...');
500
-
501
- // Install Node.js from NodeSource repository (works for both dnf and yum)
502
- const nodeSourceResult = await shell.exec(
503
- 'curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -',
504
- { timeout: 120000 } // 2 minute timeout
505
- );
506
-
507
- if (nodeSourceResult.code !== 0) {
508
- console.log('Failed to add NodeSource repository.');
509
- console.log(nodeSourceResult.stderr || nodeSourceResult.stdout);
510
- return;
511
- }
512
-
513
- // Install Node.js using the appropriate package manager
514
- const nodeInstallCommand = packageManager === 'dnf'
515
- ? 'sudo dnf install -y nodejs'
516
- : 'sudo yum install -y nodejs';
517
-
518
- const nodeInstallResult = await shell.exec(nodeInstallCommand, {
519
- timeout: 180000 // 3 minute timeout
520
- });
521
-
522
- if (nodeInstallResult.code !== 0) {
523
- console.log('Failed to install Node.js.');
524
- console.log(nodeInstallResult.stderr || nodeInstallResult.stdout);
525
- return;
526
- }
527
- }
528
-
529
- // Step 5: Install Gemini CLI via npm
530
- console.log('Installing Gemini CLI via npm...');
531
- const success = await installViaNpm({ showPathInstructions: true });
532
-
533
- if (success) {
534
- console.log('');
535
- console.log('Run "source ~/.bashrc" or open a new terminal to update your PATH.');
536
- console.log('');
537
- console.log('Note: For headless/SSH environments, use API key authentication:');
538
- console.log(' export GEMINI_API_KEY="YOUR_API_KEY_HERE"');
539
- console.log(' Get your API key from: https://aistudio.google.com/');
540
- }
541
- }
542
-
543
- /**
544
- * Install Gemini CLI on Windows using winget (preferred) or Chocolatey.
545
- *
546
- * This function first ensures Node.js is installed via winget or Chocolatey,
547
- * then installs Gemini CLI via npm. The installation is idempotent - if
548
- * Gemini CLI is already installed, it will skip installation.
549
- *
550
- * @returns {Promise<void>}
551
- */
552
- async function install_windows() {
553
- // Step 1: Check if Gemini CLI is already installed
554
- if (isGeminiCliInstalled()) {
555
- const version = await getInstalledVersion();
556
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
557
- return;
558
- }
559
-
560
- // Step 2: Check Node.js version
561
- const nodeInfo = await checkNodeVersion();
562
-
563
- // Step 3: Install Node.js if needed
564
- if (!nodeInfo.installed || !nodeInfo.meetsMinimum) {
565
- console.log('Installing Node.js LTS...');
566
-
567
- let nodeInstalled = false;
568
-
569
- // Try winget first (preferred, pre-installed on Windows 10/11)
570
- if (winget.isInstalled()) {
571
- console.log('Installing Node.js via winget...');
572
- const wingetResult = await winget.install(WINGET_NODEJS_ID);
573
- nodeInstalled = wingetResult.success;
574
-
575
- if (!nodeInstalled) {
576
- console.log('winget installation failed, trying Chocolatey...');
577
- }
578
- }
579
-
580
- // Try Chocolatey as fallback
581
- if (!nodeInstalled && choco.isInstalled()) {
582
- console.log('Installing Node.js via Chocolatey...');
583
- const chocoResult = await choco.install(CHOCO_NODEJS_PACKAGE);
584
- nodeInstalled = chocoResult.success;
585
- }
586
-
587
- if (!nodeInstalled) {
588
- console.log('Failed to install Node.js.');
589
- console.log('Please install Node.js 20+ manually from https://nodejs.org/');
590
- return;
591
- }
592
-
593
- console.log('Node.js installed. Please close and reopen your terminal,');
594
- console.log('then run this installer again to complete Gemini CLI installation.');
595
- return;
596
- }
597
-
598
- // Step 4: Check npm is available
599
- if (!isNpmInstalled()) {
600
- console.log('npm is not available. Please ensure Node.js is installed correctly.');
601
- console.log('Try closing and reopening your terminal.');
602
- return;
603
- }
604
-
605
- // Step 5: Install Gemini CLI via npm
606
- console.log('Installing Gemini CLI via npm...');
607
- const installResult = await shell.exec(`npm install -g ${NPM_PACKAGE_NAME}`, {
608
- timeout: 300000 // 5 minute timeout
609
- });
610
-
611
- if (installResult.code !== 0) {
612
- console.log('Failed to install Gemini CLI via npm.');
613
- console.log(installResult.stderr || installResult.stdout);
614
- return;
615
- }
616
-
617
- // Step 6: Verify installation
618
- console.log('Gemini CLI installed successfully.');
619
- console.log('Open a new terminal window, then run "gemini" to start.');
620
- console.log('You will be prompted to authenticate with your Google account.');
621
- }
622
-
623
- /**
624
- * Install Gemini CLI on Ubuntu running in WSL (Windows Subsystem for Linux).
625
- *
626
- * Gemini CLI runs natively within WSL. This function uses the same process
627
- * as Ubuntu - installing Node.js from NodeSource and Gemini CLI via npm.
628
- *
629
- * Important: Install only within WSL for the best experience. Authentication
630
- * will open a browser in Windows.
631
- *
632
- * @returns {Promise<void>}
633
- */
634
- async function install_ubuntu_wsl() {
635
- // Step 1: Check if Gemini CLI is already installed
636
- if (isGeminiCliInstalled()) {
637
- const version = await getInstalledVersion();
638
- console.log(`Gemini CLI is already installed${version ? ` (version ${version})` : ''}, skipping installation.`);
639
- return;
640
- }
641
-
642
- // Step 2: Verify curl is available
643
- if (!shell.commandExists('curl')) {
644
- console.log('curl is required but not installed. Installing curl...');
645
- const curlResult = await apt.install('curl');
646
- if (!curlResult.success) {
647
- console.log('Failed to install curl. Please install it manually.');
648
- return;
649
- }
650
- }
651
-
652
- // Step 3: Update package lists
653
- console.log('Updating package lists...');
654
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
655
-
656
- // Step 4: Check Node.js version and install/upgrade if needed
657
- const nodeInfo = await checkNodeVersion();
658
-
659
- if (!nodeInfo.installed || !nodeInfo.meetsMinimum) {
660
- console.log('Installing Node.js 22 (LTS) from NodeSource...');
661
-
662
- const nodeSourceResult = await shell.exec(
663
- 'curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -',
664
- { timeout: 120000 }
665
- );
666
-
667
- if (nodeSourceResult.code !== 0) {
668
- console.log('Failed to add NodeSource repository.');
669
- console.log(nodeSourceResult.stderr || nodeSourceResult.stdout);
670
- return;
671
- }
672
-
673
- const nodeInstallResult = await shell.exec(
674
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nodejs',
675
- { timeout: 180000 }
676
- );
677
-
678
- if (nodeInstallResult.code !== 0) {
679
- console.log('Failed to install Node.js.');
680
- console.log(nodeInstallResult.stderr || nodeInstallResult.stdout);
681
- return;
682
- }
683
- }
684
-
685
- // Step 5: Install Gemini CLI via npm
686
- console.log('Installing Gemini CLI in WSL via npm...');
687
- const success = await installViaNpm({ showPathInstructions: false });
688
-
689
- if (success) {
690
- const homeDir = os.getHomeDir();
691
- console.log('Gemini CLI installed successfully in WSL.');
692
- console.log('Run "source ~/.bashrc" or open a new terminal to update your PATH.');
693
- console.log('Then run "gemini" to start and authenticate with your Google account.');
694
- console.log('');
695
- console.log('Notes for WSL:');
696
- console.log(' - Authentication will open a browser window in Windows');
697
- console.log(' - For best performance, keep projects in the WSL filesystem');
698
- console.log(' (e.g., ~/projects/) rather than /mnt/c/ paths');
699
- }
700
- }
701
-
702
- /**
703
- * Install Gemini CLI on Git Bash (Windows).
704
- *
705
- * Git Bash can execute Windows commands, so this function delegates to the
706
- * Windows installer. The same Windows npm installation works for both
707
- * PowerShell and Git Bash.
708
- *
709
- * @returns {Promise<void>}
710
- */
711
- async function install_gitbash() {
712
- // Git Bash uses the same Windows binaries, so delegate to Windows installer
713
- console.log('Installing Gemini CLI for Git Bash (using Windows installation)...');
714
- await install_windows();
715
- }
716
-
717
- /**
718
- * Check if Gemini CLI is currently installed on the system.
719
- *
720
- * This function checks for Gemini CLI installation across all supported platforms:
721
- * - macOS: Checks for gemini-cli via Homebrew formula or gemini command
722
- * - Other platforms: Checks if gemini command exists in PATH
723
- *
724
- * @returns {Promise<boolean>} True if Gemini CLI is installed, false otherwise
725
- */
726
- async function isInstalled() {
727
- const platform = os.detect();
728
-
729
- if (platform.type === 'macos') {
730
- // Check if Gemini CLI formula is installed via Homebrew
731
- const formulaInstalled = await brew.isFormulaInstalled(HOMEBREW_FORMULA_NAME);
732
- if (formulaInstalled) {
733
- return true;
734
- }
735
- // Also check if gemini command exists
736
- return isGeminiCliInstalled();
737
- }
738
-
739
- // All other platforms: Check if gemini command exists
740
- return isGeminiCliInstalled();
741
- }
742
-
743
- /**
744
- * Check if this installer is supported on the current platform.
745
- * Gemini CLI is supported on all major platforms via npm.
746
- * @returns {boolean} True if installation is supported on this platform
747
- */
748
- function isEligible() {
749
- const platform = os.detect();
750
- return ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'].includes(platform.type);
751
- }
752
-
753
- /**
754
- * Main installation entry point - detects platform and runs appropriate installer.
755
- *
756
- * This function uses the OS detection utility to determine the current platform
757
- * and dispatches to the appropriate platform-specific installer. If the platform
758
- * is not supported, it displays a friendly message and returns without error.
759
- *
760
- * @returns {Promise<void>}
761
- */
762
- async function install() {
763
- const platform = os.detect();
764
-
765
- /**
766
- * Map of platform types to their installer functions.
767
- * Each key corresponds to a platform.type value from os.detect().
768
- */
769
- const installers = {
770
- 'macos': install_macos,
771
- 'ubuntu': install_ubuntu,
772
- 'debian': install_ubuntu, // Debian uses same process as Ubuntu
773
- 'wsl': install_ubuntu_wsl, // WSL detection from os.detect()
774
- 'raspbian': install_raspbian,
775
- 'amazon_linux': install_amazon_linux,
776
- 'rhel': install_amazon_linux, // RHEL uses same process as Amazon Linux
777
- 'fedora': install_amazon_linux, // Fedora also uses npm installation
778
- 'windows': install_windows,
779
- 'gitbash': install_gitbash,
780
- };
781
-
782
- const installer = installers[platform.type];
783
-
784
- if (!installer) {
785
- // Platform not supported - return gracefully without error
786
- console.log(`Gemini CLI is not available for ${platform.type}.`);
787
- return;
788
- }
789
-
790
- await installer();
791
- }
792
-
793
- module.exports = {
794
- install,
795
- isInstalled,
796
- isEligible,
797
- install_macos,
798
- install_ubuntu,
799
- install_ubuntu_wsl,
800
- install_raspbian,
801
- install_amazon_linux,
802
- install_windows,
803
- install_gitbash,
804
- };
805
-
806
- if (require.main === module) {
807
- install().catch(err => {
808
- console.error(err.message);
809
- process.exit(1);
810
- });
811
- }