Everything Takumi can do is a command you can run yourself. You never need to: every command is also a row in the Palette, and the Palette runs the command when you press Enter. But if you like a terminal, or want to script your computer, nothing is hidden from you.
Open a terminal with Super+Return.
How a command is written
A command is two words after takumi: a group, then a name.
takumi wifi join "Corner Café"
takumi theme set ember
takumi audio volume 40
Some groups are a command by themselves, such as takumi update or takumi doctor. tk is a shorter name for takumi, so tk wifi list works too.
Finding your way
takumi # every group, with what it is for
takumi wifi # the commands in one group
takumi wifi join --help # one command: what it does, how to use it, examples, its risk tier
takumi --version # Takumi's version
-h works in place of --help. takumi --manifest prints every command as JSON, which is what the Palette and the assistant read.
Every command describes itself
The first lines of each command say what it is: one line saying what it does, how to use it, an example or two, and how risky it is. Help comes from those lines, and so does the Palette’s row for it, the words that find the row, and what the assistant knows about the command. A command without them is not a command, so the help is never missing or out of date.
A few commands are hidden: they are run by Takumi itself (the login screen, the Core’s notices, the password helper) rather than by people. They do not show in the listings or the Palette.
Risk tiers
Every command declares one of three tiers:
| Tier | Means | In the Palette |
| 0 | reversible, only on this computer, no password | runs on Enter |
| 1 | installs software or changes a system service | asks first, in place |
| 2 | touches the system itself, the disk or how the computer starts | asks first, in place |
The assistant follows the same rule: it runs tier 0 on its own and asks once before anything higher (The assistant).
Passwords
A command that changes the system asks for your password. In the Palette it asks in the Core, never in a terminal; at the command line it asks in the terminal. Help says “(needs sudo)” beside the risk tier for these commands, and the group listings mark them “(sudo)”. The command asks for it itself: there is no need to type sudo in front.
From the Palette to the command
Every row in the Palette is one of these commands. The row’s label is the command’s own plain title: Change your password is takumi password, Check this computer is takumi doctor, Go back to the previous system is takumi rollback. Most run as a short conversation in the Core. A few that need a terminal, such as Collect a debug report, open one.
The groups and commands below are read from Takumi itself.
app
Apps: get, remove, defaults, web apps, Windows
takumi app close-allrisk 1-
Close every window, as each one's close button would; asks first
takumi app default [<browser|mail|terminal|editor|pdf|images|video|music|files> [app]] [--json]-
Show or choose the default apps: browser, mail, terminal, editor, PDFs, images, video, music and files
takumi app default browser chromiumtakumi app default
takumi app get [name]</span></code>risk 1</dt> -
Get an app from the Shelf: from Flathub, just for you, or a site as a web app
takumi app get org.videolan.VLC VLC
takumi app login [ on|off]</span></code></dt> -
Choose the apps that open when you log in
takumi app login Spotify on
takumi app open <browser|mail|terminal|editor|pdf|images|video|music|files> [file, link or command...]-
Open the browser, files, terminal or another app you chose, in a new window
takumi app open browsertakumi app open terminal btop
takumi app quit [ [--restart]]</span></code>risk 1</dt> -
Force a stuck app to quit, or quit it and open it again; with no app, list the apps that have windows
takumi app quit Spotifytakumi app quit firefox --restart
takumi app remove <app id, package or name>risk 1-
Remove an app: one from Flathub, a web app, Windows, or an app installed apart from Takumi
takumi app remove com.spotify.Client
takumi app web [name]</span></code></dt> -
Make a web app: a site in its own window, with its own icon, found in the Core like any app
takumi app web https://web.whatsapp.com WhatsApp
takumi app web-remove </span></code>risk 1</dt> -
Remove a web app made with takumi app web
takumi app web-remove whatsapp
</dl> </section> audio
Sound: outputs, volume, microphone, media keys, quality, speaker tuning
takumi audio app <0-100|mute|unmute></span></code></dt> -
Set one app's own volume, or mute it
takumi audio app 57 50
takumi audio codec-
How a Bluetooth headset's sound travels, in words: "AirPods Pro · AAC · good quality"
takumi audio input <name|id|next>-
Use a microphone: built-in, headset, USB; next goes round them
takumi audio input "Headset microphone"takumi audio input next
takumi audio media <play-pause|next|previous|forward|back|pause-all>-
Play, pause, skip or seek in the app the media keys control
takumi audio media play-pause
takumi audio mic <mute|unmute|toggle>-
Mute or unmute the microphone in use; with no word, the other of the two
takumi audio mic mute
takumi audio output <name|id|next>-
Send sound to an output: speakers, headphones, HDMI, Bluetooth; next goes round them
takumi audio output Headphonestakumi audio output next
takumi audio player <next|previous|name>-
Which app the media keys control: the next, the previous or one by name, remembered
takumi audio player nexttakumi audio player spotify
takumi audio quality <studio|balanced>-
Sound: Studio quality or Balanced, at once and kept; with no word, the one in use
takumi audio quality studio
takumi audio tuning <on|off|list|default|run> [] [--for