forged-cli 0.8.1 → 0.8.2

package/README.md

@@ -2,10 +2,10 @@
 
 > Your dev environment, forged.
 
-[![npm version](https://img.shields.io/npm/v/forged-cli?color=00ff41&style=flat-square)](https://www.npmjs.com/package/forged-cli)
-[![downloads](https://img.shields.io/npm/dt/forged-cli?color=00ff41&style=flat-square)](https://www.npmjs.com/package/forged-cli)
-[![tests](https://img.shields.io/github/actions/workflow/status/bkness/forged-cli/test.yml?branch=main&label=tests&color=00ff41&style=flat-square)](https://github.com/bkness/forged-cli/actions/workflows/test.yml)
-[![license](https://img.shields.io/npm/l/forged-cli?color=00ff41&style=flat-square)](https://github.com/bkness/forged-cli)
+[![npm version](https://img.shields.io/npm/v/forged-cli?color=1a7f37&labelColor=161b22&style=flat-square)](https://www.npmjs.com/package/forged-cli)
+[![downloads](https://img.shields.io/npm/dt/forged-cli?color=1a7f37&labelColor=161b22&style=flat-square)](https://www.npmjs.com/package/forged-cli)
+[![tests](https://img.shields.io/github/actions/workflow/status/bkness/forged-cli/test.yml?branch=main&label=tests&color=1a7f37&labelColor=161b22&style=flat-square)](https://github.com/bkness/forged-cli/actions/workflows/test.yml)
+[![license](https://img.shields.io/npm/l/forged-cli?color=1a7f37&labelColor=161b22&style=flat-square)](https://github.com/bkness/forged-cli)
 
 **Forged** is a CLI toolkit for developers: a guided zsh setup, a dependency security scanner, a credential generator, and a README generator.
 
@@ -48,7 +48,7 @@ forged readme
 It's written for people new to the terminal. It shows the whole plan first, explains each step, and asks before doing it:
 
 1. **Homebrew on your PATH.** If Homebrew is installed but `brew` isn't found (the installer's last step is easy to miss), adds its `shellenv` line to `~/.zprofile`
-2. **Command-line tools.** Installs whichever of `git gh fzf eza bat fd zoxide starship` are missing, with Homebrew
+2. **Command-line tools.** Installs whichever of `git gh fzf eza bat fd zoxide starship ripgrep jq` are missing, with Homebrew
 3. **zinit**, the plugin manager, cloned to `~/.local/share/zinit`
 4. **The dotfiles**, cloned to `~/dev/dotfiles`
 5. **One line in `~/.zshrc`** that loads them. The file is backed up first, and nothing already in it is changed
@@ -63,6 +63,16 @@ Steps that are already done are skipped, so it's safe to run again after fixing
 
 Needs macOS or Linux. Without Homebrew (on Linux, say), init lists the missing tools for you to install yourself and does the rest.
 
+### After `forged init`
+
+Three things init can't do for you:
+
+1. **Log in to GitHub** for the Ctrl+G dashboard: `gh auth login`. Project boards also need `gh auth refresh -s project`
+2. **Install a Nerd Font** so file icons show instead of boxes: `brew install --cask font-jetbrains-mono-nerd-font`, then choose "JetBrainsMono Nerd Font" in your terminal's font settings
+3. **Linux only: make zsh your shell** with `chsh -s "$(which zsh)"`, then log out and back in. macOS already uses zsh
+
+Then run `exec zsh` (or open a new tab) to load it.
+
 ---
 
 ## 🔍 Security Scanner

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "forged-cli",
-  "version": "0.8.1",
-  "description": "A complete dev environment toolkit \u2014 shell, workflows, and project scaffolding in one install.",
+  "version": "0.8.2",
+  "description": "A complete dev environment toolkit — shell, workflows, and project scaffolding in one install.",
   "keywords": [
     "cli",
     "devtools",

package/src/commands/init.js

@@ -22,8 +22,14 @@ export const TOOLS = {
   fd:       'a faster `find`',
   zoxide:   'jump to folders you visit often (Ctrl+J)',
   starship: 'the prompt',
+  rg:       'fast code search behind the code finder',
+  jq:       'reads JSON, for project settings',
 };
 
+// Package names that differ from the command they install
+export const PACKAGES = { rg: 'ripgrep' };
+export const packageFor = (tool) => PACKAGES[tool] ?? tool;
+
 export const DOTFILES_REPO = 'https://github.com/bkness/dotfiles.git';
 export const ZINIT_REPO    = 'https://github.com/zdharma-continuum/zinit.git';
 export const HOOK_MARKER   = '# forged: load the Forged shell';
@@ -150,11 +156,11 @@ function apply(step, home, run) {
     }
     case 'tools': {
       if (!step.brewAvailable) {
-        console.log(`  ${yellow}Homebrew isn't installed, so install these yourself:${reset} ${bold}${step.missing.join(' ')}${reset}`);
+        console.log(`  ${yellow}Homebrew isn't installed, so install these yourself:${reset} ${bold}${step.missing.map(packageFor).join(' ')}${reset}`);
         console.log(`  ${dim}On a Mac, get Homebrew from https://brew.sh and run forged init again. On Linux, use your package manager.${reset}`);
         return 'manual';
       }
-      return run(step.brew, ['install', ...step.missing]);
+      return run(step.brew, ['install', ...step.missing.map(packageFor)]);
     }
     case 'zinit':
       return run('git', ['clone', '--depth', '1', ZINIT_REPO, step.dir]);
@@ -237,6 +243,8 @@ export async function initCommand(args, { home = homedir(), env = realEnv(home),
   console.log(`  ${green}${bold}All set.${reset} Next:`);
   console.log(`    ${bold}exec zsh${reset}          load the new shell in this window`);
   console.log(`    ${bold}gh auth login${reset}     connect GitHub, for the Ctrl+G dashboard`);
+  console.log(`    ${bold}a Nerd Font${reset}       for file icons: ${bold}brew install --cask font-jetbrains-mono-nerd-font${reset},`);
+  console.log(`                      then pick it in your terminal's font settings`);
   console.log(`    ${bold}Ctrl+P${reset}            browse every command\n`);
   return 0;
 }