Repository navigation
Chatmon 0.7.0
New
- Chats remember the whole conversation. Follow-ups and questions about anything said earlier work however long a chat gets, with every brain alike. A brain gets the latest turns word for word, a summary of the earlier part (made once, by the brain you're asking, and kept with the chat), and the earlier turns that bear on your question, word for word. How much is sent is up to you (
[chats] context_tokens), and never more than the model can take: a model server's own limit is asked for, and a brain that says a question was too long is asked again, with less. - Instructions for every chat, and instructions for one chat (its menu, under Chats): how to answer, what you do, what language. Every brain gets them with every question.
- Memory. Remember that I use Arch, and every brain you ask knows it, in every chat. What do you remember lists it; forget that … takes it out. Only what you say, in so many words: nothing is picked out of your chats.
- Settings, in a window. Settings… in the menu (or settings in the chat): the name, companion, size, walking, bubble style, the brain, chats, your instructions and memory, breaks and focus, and the heads-up thresholds, without editing a file. What you set there is kept, and wins over the settings file, which still works.
- Ask about what you attached, later. Text you attach is kept with its chat (readable by you alone), so you can come back to it after Chatmon restarts. It goes only to the brain you gave it to.
Changes
- Break reminders and focus alerts can be turned off, in Settings or by saying breaks off or focus alerts off (and … on to bring them back). Turned off, your break interval is kept for when you turn them on again.
- Walk around in the menu is remembered after a restart, as Settings remembers it.
- The chatmon stops walking while the pointer is over it, so it's easy to click, and carries on when the pointer leaves.
- Linux: the app's entry has Bring out Chatmon and Quit Chatmon in the launcher and dock.
- Linux: in power-saver mode, the chatmon draws less often.
- Linux: waiting updates are counted through PackageKit on systems whose package manager Chatmon doesn't ask itself.
- Hyprland: the screen locking counts as a break with hyprlock too, which doesn't tell logind.
- Wayland: where the chatmon is an overlay (Hyprland, Sway, KDE...), Chatmon's own windows, Settings and dialogs, are Wayland windows, sharp at any scale, no longer drawn through XWayland.
- Wayland: files, pictures and text dragged onto the open chat are attached, on Hyprland, Sway and other compositors with the overlay, as they are elsewhere.
- Linux: attaching files and saving a chat use your desktop's own file chooser (through its portal), on Hyprland and Sway too.
- Windows 11: bubbles wait while Focus is on, as they do for a full-screen app or a presentation.
- Windows: nothing is drawn while the screen is locked or the display is off, and in Energy Saver (battery saver) the chatmon draws less often, as it does in Linux's power-saver mode.
- Windows: attachments dragged out of Outlook, files out of a zip folder, and pictures out of a browser attach when dropped on the chat or pasted into it, as files on disk do.
- macOS: bubbles wait while a full-screen app is over the chatmon, as they do on Windows and Linux, and come once you're back. Something that needs you waits too: macOS lets only apps signed with an Apple Developer ID send notifications.
- macOS: Start when I log in makes Chatmon one of your Login Items, listed by name in System Settings › General › Login Items, and turning it off there shows in the menu too. Started at login by an older version, it moves over by itself.
- macOS: the menu bar icon is the companion's silhouette, drawn in the menu bar's own colour, light or dark.
Fixes
- Privacy: Codex and Muse Code no longer keep a session of each question you ask them through Chatmon, and OpenAI's and xAI's APIs are asked not to store your questions (they keep them 30 days otherwise). Anthropic's API reads a chat's earlier turns from its cache, at a fraction of the price.
- Linux: something that needs you, under a full-screen app, reaches you as a notification on every desktop, with or without a tray. With no tray (GNOME, out of the box), Chatmon says once where its menu is.
- Linux: a laptop with two batteries gets its battery warnings for both together, as the desktop's battery icon shows them, not for the first alone.
- Windows: the file dialogs for attaching files and saving a chat open above the chatmon, never under it.
- Windows: an update's signature is checked by Windows itself, without PowerShell, so updates install on PCs where PowerShell is blocked.
- macOS: hooks and the
chatmoncommand reach Chatmon whatever the length of your user name; past about 37 characters, its socket's address was too long for macOS. - macOS: Chatmon says it needs macOS 13 or later, and says why when macOS asks whether it may reach a model server on your network.
Install or update
Chatmon 0.6.0 and later update themselves (Help & updates in the menu); coming from 0.5 or earlier, install this one by hand, once. Download the installer for your computer below; SHA256SUMS.txt lists each file's checksum, and SHA256SUMS.txt.sig is its signature by Chatmon's release key.
pipx install --force git+https://github.com/RandyNorthrup/chatmon