lacy 0.7.0

Fast magical cd alternative for lazy terminal navigators
Documentation 
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

# Set Up

After you [installed](./install.md) lacy, you have to add it's shell configuration to your shell.

## Shell Setup

For more shell options, see `lacy init --help`.

### Zsh

```bash
# ~/.zshrc
eval "$(lacy init zsh)"
```

### Bash

```bash
# ~/.bashrc
eval "$(lacy init bash)"
```

### Fish

```bash
# ~/.config/fish/config.fish
lacy init fish | source
```

### Nushell

You can't set the lacy alias (`--cmd`) to `cd`. More infos at [`--cmd`](#--cmd).

```bash
# $nu.config-path
mkdir ($nu.data-dir | path join "vendor/autoload")
lacy init nu | save -f ($nu.data-dir | path join "vendor/autoload/lacy.nu")
```

### PowerShell

```powershell
# $PROFILE
lacy init powershell | Out-String | iex
```

### Other shells

Feel free to contribute the init script for your preferred shell.

## Shell Options

You can customize the shell script that gets generated by using these options:

### `--cd-cmd`

Define the command to be used instead of `cd`. (e.g. `--cd-cmd=z`)

Default:

- Bash, ZSH, Fish: `builtin cd`
- Nushell: `cd`
- PowerShell: `Set-Location`

### `--cmd`

The name of the main lacy command you use for navigating. (e.g. `--cmd=cd`)

Default: `y`

> [!WARNING]
> Nushell doesn't have a `builtin cd` option,
> so setting it `--cmd=cd` will cause a loop.
> It should be possible to bypass this with some tinkering ([issue in nushell repo](https://github.com/nushell/nushell/issues/3792)). Feel free to open a PR if you have a good solution!

### `--custom-fuzzy`

Configure this to disable lacy's built in UI selector and replace it with your own command. (e.g. `--custom-fuzzy=fzf`)

Default: *none*