Repository navigation
FAQ
English · Español
Quick answers to the most common questions, and what to do when something isn't working.
On this page: Privacy and tokens · The icon and accounts · Notifications and permissions · Voice and keys · Claupet Terminal · Updates · Other · How to get help
Looking at your usage, your sessions' activity, the history and the other agents costs no tokens: it all
comes from files on your computer and from the same request /usage makes in Claude Code. What does use
tokens, like any message, is questions that go to the cloud (the chat, the island, creating a theme) and
whatever the sessions you open do. To save, see Who answers each question.
- It reads what Claude Code already keeps on your computer. It doesn't store passwords and doesn't touch your credentials: it only reads them.
- Your settings, the history (numbers only) and the Console's chat conversations stay on your computer.
- "No AI" answers don't leave your computer, except the weather (Open-Meteo and, if your city is automatic, ipwho.is for the location by IP).
- To look for new versions it checks GitHub, without signing in.
- Copy diagnostics doesn't include emails or tokens.
| System | Folder |
|---|---|
| Windows | %APPDATA%\Claupet |
| macOS and Linux | ~/.config/Claupet |
Notes you ask it to save go, on Windows, to Documents\Claupet\Notas, one .md per note.
- Windows 11 puts new icons under the ^ arrow on the taskbar. Drag it out.
- macOS: it's in the menu bar, top right, not in the Dock.
- Linux with GNOME: it needs the AppIndicator extension (Ubuntu ships with it).
- Check that Claude Code is signed in with that account.
- If you use
CLAUDE_CONFIG_DIR, add that folder with + in the Usage view (see Getting started). - macOS: Claude Code keeps its credentials in the Keychain. When macOS asks whether Claupet can read "Claude Code-credentials", choose Always Allow.
Note
Claupet needs Claude Code. If you only use Claude Desktop or claude.ai, there's nothing for it to read.
That account's access expired because it went unused for hours. Press Refresh in the icon's menu: Claupet asks Claude Code to renew it and checks again.
Anthropic limits usage requests heavily (the ones /usage makes in Claude Code count too). Claupet asks at
most once a minute per account and, if it's told to wait, shows the last good data: the window's footer says
what time it's from. It catches up on its own.
Claupet follows HTTPS_PROXY or, on Windows, the manual proxy in Internet Options, and passes it on to
Claude Code. Automatic configuration (PAC) isn't read.
- Check that Settings › Alerts › Notifications is on.
- In Claupet Console, use Settings › System › Permission notifications (hook) › Set up… and apply.
- If nothing changes, use Copy diagnostics and look in the result for:
| It says | What it means |
|---|---|
| "credentials no" | Claupet can't see that account and doesn't read its sessions. |
| "no sessions folder" | That version of Claude Code doesn't record its sessions' state. |
| "no hook" | The hook is missing: there won't be any permission notifications. |
Turn on Settings › Island › Island permissions and questions › Set up…. It works in sessions opened afterward. If Claupet is closed or nobody answers in time, Claude Code asks in the terminal as usual.
Claupet tells you if the microphone is muted or gives no sound at all. Check:
- Windows: Settings › System › Sound › Input: that the selected microphone is the right one and isn't muted (or unmute it with the microphone key). If it says it can't find it, check Settings › Privacy › Microphone.
- macOS: System Settings › Sound and Privacy & Security › Microphone.
- Linux: that the system input is the right one and isn't muted.
Tip
A virtual input (from a gaming or streaming program, for example) may give no sound at all. Pick your real microphone as the default input.
- macOS: give Claupet the Input Monitoring permission in Privacy & Security.
- Linux with Wayland: the key is only seen while focus is on an X11 app. Talk with the island's microphone button instead.
- Windows: if another app uses the same shortcut, Keyboard shortcuts marks it "in use". Record another one.
With background noise, Whisper sometimes "hears" phrases nobody said. Get closer to the microphone, or use the push-to-talk key only while you're speaking.
They need to be installed and on the PATH. Check by typing their name in a terminal.
Run the command it shows once in a terminal (gemini, copilot login…), sign in and type in the session
again. Claupet Terminal explains it.
That's by design: when you close Claupet Console, no agent is left running. If you want a session to keep going, leave the Console open (you can minimize it).
Shells in blocks need Windows 10 (1809) or newer. They're not available on macOS and Linux yet.
- Check that Settings › System › Check for updates is on. It checks once a day.
- Versions before 2.3.0 don't check on their own: install the latest one by hand from Releases.
If the signature or the file don't match, Claupet deletes the download and installs nothing: it's a safeguard. Try again later or download the version by hand. If it says "This copy of Claupet can't replace itself", install the new version by hand.
Claupet isn't signed by Microsoft. Choose More info › Run anyway.
It only changes on a laptop screen: external monitors are adjusted with their own buttons. On macOS it can't be changed.
Claupet puts the event together and opens it in your calendar app: it takes one click to save it.
With Wayland, the island only sees the cursor while it's over an X11 app, and may not peek out when you move the cursor close.
- In Settings › System, press Copy diagnostics.
- Open an issue on GitHub and paste the result, along with what happened and your system.
Important
Diagnostics don't include emails or tokens, but check them before pasting: the repository is public.
Este manual se genera desde docs/manual: para corregirlo, cámbielo allí. · This guide is generated from docs/manual: to fix it, change it there.
Español