nils-fzf-cli 0.6.5

CLI crate for nils-fzf-cli in the nils-cli workspace.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

# fzf-cli

## Overview

fzf-cli is a Rust CLI that provides interactive pickers for files, Git metadata, processes, ports,
and shell definitions, all powered by `fzf`.

## Usage

```text
Usage:
  fzf-cli <command> [args]

Commands:
  file         Search and preview files
  directory    Browse directories and pick files
  git-status   Interactive git status viewer
  git-commit   Browse commits and open changed files
  git-checkout Pick and checkout a previous commit
  git-branch   Browse and checkout branches
  git-tag      Browse and checkout tags
  process      Browse and kill running processes
  port         Browse listening ports and owners
  history      Search command history
  env          Browse environment variables
  alias        Browse shell aliases
  function     Browse shell functions
  def          Browse env, alias, and function definitions
  help         Display help message

Help:
  fzf-cli help
  fzf-cli --help
```

## Commands

### file

- `file [--vi|--vscode] [-- <query...>]`: Search files with preview and open the selection.

### directory

- `directory [--vi|--vscode] [-- <query...>]`: Pick a directory, then pick a file to open. Use
  `ctrl-d` to emit `cd <path>` to stdout.

### git-status

- `git-status [query...]`: Interactive `git status -s` viewer with diff previews.

### git-commit

- `git-commit [--snapshot] [query...]`: Browse commits and open changed files. `--snapshot` opens
  file snapshots from the selected commit by default.

### git-checkout

- `git-checkout [query...]`: Pick a commit and checkout (prompts before checkout).

### git-branch

- `git-branch [query...]`: Browse branches and checkout (prompts before checkout).

### git-tag

- `git-tag [query...]`: Browse tags and checkout (prompts before checkout).

### process

- `process [-k|--kill] [-9|--force] [query...]`: Browse processes and optionally kill selected PIDs.

### port

- `port [-k|--kill] [-9|--force] [query...]`: Browse listening ports and optionally kill owning PIDs.

### history

- `history [query...]`: Browse shell history and print the selected command to stdout.

### env

- `env [query...]`: Browse environment variables.

### alias

- `alias [query...]`: Browse shell aliases.

### function

- `function [query...]`: Browse shell functions.

### def

- `def [query...]`: Browse env, alias, and function definitions.

## Environment

- `FZF_FILE_OPEN_WITH`: Default opener for `file`, `directory`, `git-commit` (`vi` or `vscode`).
- `FZF_FILE_MAX_DEPTH`: Max directory depth for `file` and `directory` (default: `10`).
- `FZF_PREVIEW_WINDOW`: Preview window layout for `directory` (default: `right:50%:wrap`).
- `FZF_DEF_DELIM` and `FZF_DEF_DELIM_END`: Required delimiters for `env`, `alias`, `function`, `def`.
- `FZF_DEF_DOC_CACHE_ENABLED`: Enable definition doc caching.
- `FZF_DEF_DOC_CACHE_EXPIRE_MINUTES`: Cache TTL in minutes (default: `10`).
- `FZF_DEF_DOC_SEPARATOR_PAD`: Padding lines between definition docs (default: `2`).

## Dependencies

- `fzf` is required for all commands.
- `git` is required for `git-*` commands.
- `lsof` is optional for `port` (falls back to `netstat`).
- `code` is required for `--vscode` (falls back to `vi`).

## Docs

- [Docs index](docs/README.md)