Skip to content
/ thwack Public

Command-line version of Go to file utility, similar to the one on GitHub

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

yykamei/thwack

Repository files navigation

thwack

GitHub Actions workflow status Crates.io

thwack is a Command-line utility similar to "Go to file" on GitHub. You can search for a file in a directory and invoke an arbitrary command on it.

thwack on iTerm2

Why is this useful?

In many cases, we know the name of a file when we want to open it, but we may not be sure where it's located. In this case, we can search it with our file explorer. However, if we're in a terminal console, it's cumbersome to switch to another application. There might be few command-line tools to support this functionality, but they require us to combine some commands with pipes to get things done.

thwack is the solution! You can find and open a file quickly with it 🚀

Installation

If you have a Rust environment set up, you can use the cargo install command:

cargo install thwack

Note we consider providing easier ways to install thwack. This should be used without the knowledge of Rust.

Getting Started

Just run this command and type the name of the file you'd like to find. By hitting the Enter key on the file you wanted in the list of the results, you can execute an arbitrary command on it.

thwack

Run thwack --help for more options.

Shortcuts

Action Shortcuts
Move selection up Ctrl+p or ⬆️
Move selection down Ctrl+n or ⬇️
Execute command with selection Enter
Copy relative path of selection Ctrl+d
Copy absolute path of selection Ctrl+y
Exit Esc or Ctrl+c

Contributing

Thank you for considering contributing!

This project is so immature that you may wonder how to contribute. Currently, all actions are welcome! Open issues if you want to comment or ask something. Open pull requests directly if you have any ideas. There are many chances to improve this project, so don't hesitate to do something here 😄

Take a look at the CONTRIBUTING.md, too.

License

Copyright © 2021, Yutaka Kamei.

thwack is available under the terms of either the Apache License 2.0 or the MIT License, at your option.

See LICENSE-APACHE, LICENSE-MIT for details.