Skip to content

instantASSIST

Required skills

INFO

instantASSIST has been rewritten in Rust and is now powered by ins assist (instantCLI). The legacy bash version is still shipping for instantWM, but other window managers use the Rust version.

instantOS comes with instantASSIST, a collection of small utilities that can be accessed using only a few keystrokes.

Access it using super+a. This will pop up a menu showing all available keystrokes. Press h to see a description of all available assists. Press one of them to activate the corresponding section. Some assists will have multiple options available. They will be displayed in the same menu. Press the key again to go with the default one, press one of the keys listed to execute the corresponding variant. These key chords are called assists.

For example: The w-assist consists of pressing super+a to activate the menu and then typing in w. The w-assist is responsible for quickly changing your wallpaper. It will list some other options. Press w again to execute the default action which is generating a new wallpaper from a random source.

The h-assist will list all available assists and their purposes.

When you are inside a group (like screenshots), press h to show help for that group (for example sh, not available on the legacy bash version).

Some assists rely on extra packages. If a dependency is missing, ins assist will prompt to install it before running the action.

Assist catalog

Single-key assists

KeyAction
hHelp: show all available assists
bBrightness: adjust display brightness
cCaffeine: keep system awake
aVolume: adjust audio volume
mMusic: play or pause music
pPassword Manager: open password manager
qQR Encode Clipboard: generate QR code from clipboard
eEmoji Picker: open emoji picker
kColor Picker: pick color from screen

Info assists (i)

KeyAction
iaAsk Claude: ask Claude AI about clipboard content
icAsk ChatGPT: ask ChatGPT about clipboard content
igAsk Gemini: ask Google Gemini about clipboard content
imMan Pages: search and view man pages

Jokes assists (j)

KeyAction
jbBruh: display a bruh moment
jcCMatrix: run the Matrix rain
jqAsciiquarium: launch the terminal aquarium

Screenshot assists (s)

KeyAction
sfFullscreen to Pictures: fullscreen screenshot to Pictures folder
saScreenshot and Annotate: take a screenshot with flameshot
scScreenshot to Clipboard: capture area to clipboard
siScreenshot to Imgur: capture area and upload to Imgur
smFullscreen to Clipboard: fullscreen screenshot to clipboard
spArea to Pictures: selected area screenshot to Pictures folder
sqQR Code Scanner: scan QR code from selected area
srOCR Text Recognition: extract text from selected area

Tools assists (t)

KeyAction
tmMouse Speed: adjust mouse sensitivity

Media navigation assists (v)

KeyAction
vcControl Media: select player to play or pause
vnNext Track: go to next track
vpPrevious Track: go to previous track

Using ins assist from the terminal

You can run assists without the menu:

bash
ins assist run sc
ins assist run ia

List all assists and key sequences:

bash
ins assist list

Use the instantmenu frontend instead of the built-in chord UI:

bash
ins assist --instantmenu