# Projectr

[![builds.sr.ht status](https://builds.sr.ht/~tobyvin/projectr/commits/main.svg)](https://builds.sr.ht/~tobyvin/projectr/commits/main?)
[![Crates.io](https://img.shields.io/crates/v/projectr)](https://crates.io/crates/projectr)
[![docs.rs](https://img.shields.io/docsrs/projectr/0.4.1)](https://docs.rs/projectr)

A contextual, MRU sorted, project finder.

`projectr` is project discovery tool that produces a MRU sorted list of project
directories using provided contexts and filters.

## Installation

### Using Cargo

```sh
cargo install --git=https://git.sr.ht/~tobyvin/projectr
```

### Building from source

Provided you have [Rust installed](https://www.rust-lang.org/tools/install),
projectr can be built using Cargo.

```sh
$ git clone https://git.sr.ht/~tobyvin/projectr
$ cd projectr
$ cargo build --release
$ ./target/release/projectr --version
projectr 0.4.1
```

## Usage

To list all available options run `projectr -h`.

For a working example, see [tmux-projectr].

## Releases

A list of changes in each release can be found in [CHANGELOG.md].

Subscribe to release announcements on [~tobyvin/projectr-announce@lists.sr.ht].

## Troubleshooting

Ask for support or follow general discussions in
[~tobyvin/projectr-discuss@lists.sr.ht].

For bug reports and feature requests see [Submitting bug reports and feature
requests] section in [CONTRIBUTING.md].

## Maintainer

[tobyvin](https://tobyvin.dev)

## Contribution

Anyone is welcome to contribute to projectr. Please refer to [CONTRIBUTING.md].

## License

projectr is licensed under the [MIT].

[~tobyvin/projectr-announce@lists.sr.ht]:
  https://lists.sr.ht/~tobyvin/projectr-announce
[~tobyvin/projectr-discuss@lists.sr.ht]:
  https://lists.sr.ht/~tobyvin/projectr-discuss
[tmux-projectr]:
  https://git.sr.ht/~tobyvin/projectr/tree/v0.4.1/item/bin/tmux-projectr
[MIT]: https://git.sr.ht/~tobyvin/projectr/tree/v0.4.1/item/LICENSE
[CHANGELOG.md]:
  https://git.sr.ht/~tobyvin/projectr/tree/v0.4.1/item/CHANGELOG.md
[CONTRIBUTING.md]:
  https://git.sr.ht/~tobyvin/projectr/tree/v0.4.1/item/CONTRIBUTING.md
[Submitting bug reports and feature requests]:
  https://git.sr.ht/~tobyvin/projectr/tree/v0.4.1/item/CONTRIBUTING.md#submitting-bug-reports-and-feature-requests