package
CLI tool for fuzzy searching npm scripts and JSON files with dot notation in monorepos
npm install fjsfGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Estimated unpacked size across 1 packages.
2.4 MB
Includes dependencies.
Stop typing full script names. Run fjsf init once, then just type npm run <TAB> and get an interactive tooltip with all your scripts. That's it.
No more:
npm run test....<you forgot>package.json to remember script namesType less. Run faster. Stay in flow.
You start here.
Lost. In a sea of monorepo workspaces trying to remember the script you need,
you type fjsf and...
graph TD
A[CLI Entry] --> B{Parse Mode}
B -->|scripts| C[Scripts Mode]
B -->|find| D[Find Mode]
B -->|path| E[Path Mode]
B -->|run| F[Run Mode]
B -->|init| G[Shell Integration]
B -->|help/quit| H[Exit]
C --> I[Discover package.json]
I --> J[Extract Scripts]
J --> K[Fuzzy Search UI]
K --> L[Execute Script]
D --> M[Find All Files]
M --> N[Flatten JSON]
N --> O[Cache with mtime]
O --> K
E --> P[Load Single File]
P --> N
F --> Q[Read JSON]
Q --> R[Validate Key]
R --> L
G --> S[Detect Shell]
S --> T[Add Autocomplete]
T --> U[Add Alias]You end here.
Just as lonely as before.
But you executed that npm script you needed lickety-split!
npm run <TAB> - fuzzy search scripts without leaving your terminalSetup once:
fjsf init # Supports bash, zsh, fish
# Restart your shellNow type npm run <TAB> for instant fuzzy search:
npm run <TAB>
# Interactive fuzzy search appears:
# ❯ dev
# build
# test
# lint
npm run t<TAB>
# Filters to:
# ❯ test
# test:e2e
# typecheck
bun run bui<TAB>
# Shows:
# ❯ build
# build:binary
# build:allWorks with npm, pnpm, yarn, and bun. Press Tab to search, arrow keys to navigate, Enter to run.
Using with fzf-tab? Run fjsf init --native instead.
Customize key binding: Edit ~/.fjsf/init.{zsh,bash,fish} and change the bindkey (default is Tab/^I).
Uninstall: rm -rf ~/.fjsf and remove the source line from your shell config.
fjsf # Search all scripts in current repo
fjsf ./package.json # Search scripts in specific filefjsf find package.json
# Type: "react"
# Shows: dependencies.react:[workspace-a] ^18.2.0
# dependencies.react:[workspace-b] ^18.0.0
# devDependencies.react:[workspace-c] ^17.0.2fjsf find tsconfig.json
# Type: "target"
# Shows: compilerOptions.target:[packages/api] ES2020
# compilerOptions.target:[packages/web] ES2022fjsf find package.json
# Type: "scripts.test"
# Shows: scripts.test:[workspace-a] jest
# scripts.test:[workspace-b] vitestfjsf path ./tsconfig.json
# Type: "strict"
# Shows: compilerOptions.strict: truefjsf run package.json scripts.build # Run build script
fjsf r package.json scripts.test # Run test (short form)# Scripts mode (default)
fjsf [file] # Search & execute scripts
# Find mode - search all files with name
fjsf find <filename> # fjsf find package.json
fjsf f <filename> # Short form
# Path mode - query single file
fjsf path <file> # fjsf path ./tsconfig.json
fjsf p <file> # Short form
# Run mode - run script directly
fjsf run <file> <key> # fjsf run package.json scripts.dev
fjsf r <file> <key> # Short form
# Shell integration
fjsf init # Setup Tab completion
fjsf init --native # For fzf-tab users
# Keyboard controls
# Type to search (fuzzy), ↑/↓ to navigate, Enter to execute, q/Esc/Ctrl+C to quitbun install -g fjsfbrew tap yowainwright/fjsf
brew install fjsfDownload the latest binary for your platform from the releases page:
fjsf-qjs-darwin-arm64fjsf-qjs-linux-x64Make the binary executable and move it to your PATH:
chmod +x fjsf-qjs-*
sudo mv fjsf-qjs-* /usr/local/bin/fjsfTab completions not working: Ensure completion files are loaded before compinit in your shell config. Clear cache with rm -rf ~/.zcompdump* and reload.
MIT