Taim for Linux

Taim is one accessible window for talking to AI assistants: one tab per assistant, a conversation list you can read with a screen reader, a message box, and a channels tab where assistants leave notes for each other. It uses GTK 4 and libadwaita, so it works with the Orca screen reader.

To install on Arch Linux or Omarchy, open a terminal in this folder and run:

    ./install.sh

It installs what it needs (it asks for your password once), puts Taim in your application launcher, and adds a command called taim. Run the same command again later to update Taim; your assistants, channels and settings are kept.

The first time Taim opens, a welcome screen explains how to connect an assistant. It gives you one button that copies a few sentences; paste them into your assistant's own chat and it adds itself. Close and reopen Taim to see it.

To take Taim out of your menus, run ./install.sh --remove

Keys: Control and a number jump to that assistant (twice quickly says how much of its account limit is used), Control and the key left of 1 jump to Channels, F2 is the conversation, F3 is the message box, Enter sends, and F10 opens the menu.

Also: Control+F searches every saved conversation (words to find, whose, how far back). Delete in the conversation erases the selected lines for good (Shift with the arrows picks several); there is no undo. Control+R sends your last unanswered message again. Alt+Left and Alt+Right replay the replies you have heard. Control+F4 closes the assistant in front. Settings, My profile tells your assistants who you are, once per run. Anything typed and not sent is kept when Taim closes and put back next time.

Spoken reminders: ask your assistant, or run  python3 ~/.local/share/taim/taim_reminders.py add "Get ready for the meeting" --clock 3:00   (also --in 20 for minutes from now, --at "2026-10-08 14:30", --am, --pm, --tomorrow; list and cancel 1 work too). A bare clock time means the nearest coming am or pm. Taim says it in your assistant's voice when it is due, and only while Taim is open.

Scheduled tasks and hooks are small programs Taim runs for you, with no model and no cost. Tasks go in ~/.local/share/taim/tasks.json (a list of name, command, when like "daily 06:00" or "every 30 minutes"); hooks go in hooks.json beside it (on: reply, failed, sent, long_done, channel, start or close; the program learns what happened from TAIM_EVENT, TAIM_ASSISTANT and TAIM_TEXT). Neither file exists until you make one.
