# ea: Making CLI Outputs Actionable

`ea` remembers file paths from CLI output for later use.

## Intro

CLI programs like `find`, `rg`, `clang` etc, print out file paths (and line/columns). `ea` lets you act on
them. Here's how:

![Aliasing In Action](demo.gif)

By running your command through `ea`, each path in its output get marked with a number in the front. This
number can be used to retrieve its corresponding path later for your purposes. Combined with some shell
configurations, this can provide a powerful experience.

## Install

#### Via a package manager

`ea` is available in the following package managers.

| Manager / OS | Command                          |
| ------------ | -------------------------------- |
| Cargo        | `cargo install ea-command`       |
| Homebrew     | `brew install dduan/formulae/ea` |
| AUR / Arch   | `yay -S ea-command`              |
| Nix flake    | Use `github:dduan/ea`            |

### Pre-built executable

Choose an pre-built executable from the [release page][] that fits your
platform to download. Unpack it somewhere you'd like to run it from.

[release page]: https://github.com/dduan/ea/releases

## Documentation

* [User Manual](docs/UserManual.md)
    * [Tutorial](docs/UserManual.md#description)
    * [Formats](docs/UserManual.md#formats)
    * [Shell Integration](docs/UserManual.md#shell-integration)
* [Editor Alias](docs/ShellIntegrations.md#editor-alias)
* [Note to packagers](docs/Packaging.md)
* [Developing ea](docs/Developing.md)

## Credits

`ea` is inspired by [keith/tag][], which was inspired by [aykamko/tag][].

[keith/tag]: https://github.com/keith/tag
[aykamko/tag]: https://github.com/aykamko/tag

## LICENSE

See `LICENSE.txt`.