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
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

# Features

- [Improved CD Features](#improved-cd-features)
  - [Navigation](#navigation)
  - [Back Navigation](#back-navigation)
  - [Path History Navigation](#path-history-navigation)
- [New Lacy Features](#new-lacy-features)
  - [Skipping Directories](#skipping-directories)
  - [Multiple Results](#multiple-results)

To use lacy, you use the `y` command. (You can easily change the default key, see [FAQ](./faq.md))

## Improved CD Features

### Navigation

Lacy is `cd` compatible, meaning everything you can do with `cd`, you can do it the exact same way in lacy:

```bash
cd Desktop/foo/bar
y Desktop/foo/bar

cd /Users/tiimo
y /Users/tiimo

cd ~
y ~
```

But where `cd` is very strict about what you type, lacy isn't:

```bash
cd Desktop/foo/bar
y dskt/fooo/bar

cd /Users/tiimo
y / usrs/timoo
```

You can even write spaces instead of slashes if you want:

```bash
cd Desktop/foo/bar
y dskt fooo bar

cd /Users/tiimo
y / usrs  timoo
```

Lacy uses a custom fuzzy matching algorithm, specifically crafted for lazily writing paths
so you always find what you want!

### Back Navigation

Navigating back using `..` is also a feature that is improved.

```bash
cd ../..
y ../..
```

Instead of writing `../..` for each level, you can just type `...` (Some shells already have this functionality built in).

```bash
cd ../../..
y ....
```

### Path History Navigation

> This feature is currently WIP!

```bash
cd -1
y -1
```

## New Lacy Features

### Skipping Directories

If you ever know your target directory, but forgot whats between it, you can just skip it using `-`.

```bash
cd Desktop/foo/bar
y - foo bar
```

You can do that as many times as you want.

```bash
cd Desktop/foo/bar
y - - - foo bar
```

### Multiple Results

By now you probably have wondered what happens if lacy can't decide what your target
folder is and finds multiple results.

In that case, lacy opens a multiselect window where you can select your target

```text
? Multiple possibilities found! ›
❯ /Users/tiimo/Desktop/projects/lacy/devtools
  /Users/tiimo/Desktop/projects/lacy/docs
  /Users/tiimo/Desktop/projects/lacy/result
  /Users/tiimo/Desktop/projects/lacy/src
```

If you want, you can [easily swap out the default select](./setup.md#shell-options) with your own solution,
like for example `fzf`.