A fuzzy launcher
Find a file
2024-09-09 02:03:26 +01:00
q Fix Q_SCRIPT_DIR detection 2024-09-09 02:03:26 +01:00
q-random-number Initial version of q.sh 2024-09-09 02:03:22 +01:00
q-weight-convert Initial version of q.sh 2024-09-09 02:03:22 +01:00
README.md Initial version of q.sh 2024-09-09 02:03:22 +01:00

CLI to answer natural language questions

q.sh is a command-line tool that allows you to interact with your computer using natural language.

Example usage:

export Q_SCRIPT_DIR=`pwd`

./q 2.0 kg in pounds
4.41

./q 1 pounds in kg
0.45

./q random number 1-100
53

Extending q.sh

You can extend q.sh using any programming language. In order to do so, you need to place an executable file starting with q- in Q_SCRIPT_DIR (by default, ~/.config/q.sh).

When called without parameters, your script should return a newline-separated list of regular expressions that match strings it's interested in.

When called with an argument, this argument will always be what it expects to get as input. q.sh will take care of dispatching the calls properly.

To get an idea how it works, you can stury q-weight-convert and q-random-number that are located in this repository.

License

Distributed under the terms of the BSD License