FAQ

Short answers for setting up the Vizhi plugins. The Claude Console, Vizhi for Codex and Vizhi for ChatGPT guides have the long ones.

General

What do I need?

• An MX Creative Keypad and Logi Options+ 6.4 or newer.
• Claude Code (for Claude Console) or Codex CLI (for Vizhi for Codex), installed on the same computer. Sessions inside WSL are not visible.
• On a Mac: Apple Silicon and the built-in Terminal app.
• On Windows: Windows 10 or 11 and Windows Terminal.

Which terminal apps work?

Terminal on macOS and Windows Terminal on Windows. Every key press goes to one specific session, and these two apps let the plugin find it. Sessions in iTerm2, Ghostty or Warp do not show on the keys.

Does anything leave my computer?

No. Voice is transcribed on your computer, the plugins send no usage data, and this site has no tracking. The only download is the speech model, once. Claude Code and Codex themselves still talk to Anthropic and OpenAI as usual. See the privacy policy.

Is this an official Logitech, Anthropic or OpenAI product?

No. It started in Logitech's developer programme, and Logitech lent the hardware, but it is an independent project.

Why is the plugin about 17 MB?

It includes offline voice for both macOS and Windows, plus two small Windows helpers. The speech model is not included; it downloads the first time you use voice. Every Windows file is code-signed by the publisher Ravi Shankar S.

Does it work with Stream Deck?

No. Vizhi is made for the MX Creative Keypad.

Setting up

I installed the plugin and the keypad is empty.

That is normal. The plugin comes without a layout. To add one:

1. Download the layout for your computer from the keypad layouts page.
2. In Logi Options+, open your keypad, click the ⋯ button and choose Import Profile.

You only do this once. You can also drag the plugin's actions onto your own profile instead.

What permissions does it ask for?

On a Mac: Accessibility (so the keys can type into Terminal), Microphone (the first time you use voice) and Screen Recording (the first time you take a screenshot). On Windows: only microphone access, if you use voice.

Do I need to import the layout again after an update?

No. Updates never touch your layout. The release notes say so in the rare case a new layout is needed.

Can I keep my own Terminal profile?

Yes. Skip the import and drag the plugin's actions onto your profile.

Live status and answers

The Cost, Context, Activity and Session keys say “Set up”. (Claude Console)

Live status is off. It is off until you turn it on, because it adds a few entries to your Claude Code settings file (a backup is made first, and your own entries stay).

• Turn on: press Cost. On a Mac, choose Turn on. On Windows, press Cost again within 15 seconds.
• Turn off: hold Cost. On a Mac, choose Turn off. On Windows, hold it again within 15 seconds.

Running sessions pick it up by themselves.

Yes and No say “Off”. (Claude Console)

Live status is off, so the keypad cannot see Claude's questions. Turn it on as above.

Yes and No beep and do nothing.

They only answer a permission prompt the plugin can see. If the session is asking something else, such as a plain question, type your answer in the terminal. The keys refuse rather than guess.

I have several sessions open. Which one do the keys act on?

Each Session key shows one session. Press a Session key to select it; all other keys then act on that session. Press it again to let go.

• On a Mac, with nothing selected, the keys follow the Terminal tab you are looking at.
• On Windows, select a session first when more than one is open.
• Claude Console: if exactly one session is waiting for an answer, Yes and No go to it. Vizhi for Codex asks you to select one.

What do the amber and red dots mean?

Amber: the agent is waiting for you. Red on Yes: approving would do something risky, like git push or rm -rf. It is a hint only; the agent's own prompt still shows the full command.

Voice

How does voice work?

• Dictate: press, speak, press again. Your words are typed and sent.
• Voice Draft: the same, but not sent, so you can fix it first.
• Go to Project: say a project name to open it.

The first press asks for microphone access and downloads the speech model once (about 140 MB). After that, voice works with no internet at all.

What do the voice key messages mean?

• Starting (Windows): the microphone is getting ready. Speak when it changes.
• Model loading: the speech model is still downloading. Options+ tells you when it is ready.
• Mic denied: allow the microphone. Mac: System Settings → Privacy & Security → Microphone. Windows: allow microphone access for desktop apps.
• No speech: it heard nothing clear. Try again, a little louder.
• No target: no session to type into. Select a session, then try again. Your words are saved in the plugin log.
• Not typed: the words could not be typed, for example the terminal closed, or on Windows the session runs as administrator.
• No helper or No whisper: voice files are missing. Reinstall the plugin.

Can I skip the model download?

Yes. Put ggml-base.en.bin in ~/.claude/claude-console/whisper/ before you first use voice.

Go to Project says “No match”.

Say just the folder's name. The plugin looks for projects in your home folder and in folders where sessions are running. If your projects are somewhere else, list those folders, one per line, in ~/.claude/claude-console/project-roots.

Windows

The keys beep and Options+ asks for Windows Terminal.

Open Windows Terminal and run the agent in it, without administrator rights. To make Windows Terminal the default, go to Settings → System → For developers → Terminal and choose Windows Terminal.

Is there a Turn on dialog on Windows?

No. Pressing the same key again within 15 seconds does it, and the key tells you so.

What does not work on Windows?

Next Window and Previous Window, the Turn on dialog, and the Mac cleanup script. Everything else works, including the amber and red dots.

The keys say “Blocked”.

Security software on your PC removed or blocked the plugin's helper, claude-console-hook.exe. Options+ shows a message naming the file. Ask IT to allow the publisher Ravi Shankar S, or restore the file. The keys fix themselves at the next prompt. (Claude Console 2.3.2 and Vizhi for Codex 1.6.2 or newer.)

A Session key says “Selecting”. (Vizhi for Codex)

Windows Terminal takes about a second to bring the tab to the front. Keys pressed during that second are ignored, so they cannot go to the wrong session. Press again once the key shows the session.

A Session key does not switch to its tab.

If you renamed that tab in Windows Terminal, clear the custom name.

Vizhi for Codex

Codex says “Hooks need review — 7 hooks are new or changed”.

These are Vizhi's hooks. They let Codex tell the keypad what it is doing. Choose Review hooks, then Trust all and continue. Codex asks again only when an update changes them (1.6.2 does, on Windows). Missed it? Type /hooks in Codex. Never turn off hook checking.

The keys say “Run /hooks”.

Send a prompt first: Codex only starts talking to the keypad after your first prompt. If the keys still say Run /hooks, type /hooks in Codex and trust the seven Vizhi entries.

Do Yes and No light up on Windows?

Yes, since 1.6.0, the same as on a Mac.

Yes and No say “Select session”.

More than one Codex session is open. Press the Session key you mean, then Yes or No. With one session, they just work.

With two Codex sessions, can an answer go to the wrong one?

No. If the plugin cannot tell which session a question belongs to, it does not light any key. Answer in the terminal instead. (1.6.2 or newer.)

Where do New Tab and New Codex open?

In the selected session's folder. If none is selected, in the first folder listed in ~/.claude/claude-console/project-roots, otherwise your home folder. (1.6.2 or newer.)

Can I use Claude Console and Vizhi for Codex together?

Yes. Install both and import each one's layout.

Where is the Cost key?

There isn't one. Codex does not report cost, and the keypad never shows a number it did not get.

Vizhi for ChatGPT

What is Vizhi for ChatGPT, and how is it different from Vizhi for Codex?

Vizhi for ChatGPT drives the ChatGPT desktop app on Mac and Windows, in both its ChatGPT and Codex modes. Vizhi for Codex drives Codex CLI in Terminal. They are separate plugins and can be installed together. It was called Vizhi Desktop until version 1.1.3. See the Vizhi for ChatGPT guide.

How do I get Vizhi for ChatGPT?

Install it from the Logi Marketplace in Logi Options+. It is available for Mac and Windows. Questions: support@rshankar.com.

Does Vizhi for ChatGPT work on Windows?

Yes, since 1.1.0, on Windows 10 or 11 with the ChatGPT app from the Microsoft Store. On a Mac it needs Apple Silicon.

Do I need to import a layout for Vizhi for ChatGPT?

No. It adds its own keypad profile, Vizhi Home, for the ChatGPT app. When an update changes the default layout, it updates your Home and Tools pages only if you haven't customised either of them, and keeps a backup of your profile first. If you have deleted Vizhi Home and want it back, download it from the keypad layouts page and import it in Options+ with Vizhi for ChatGPT selected.

Why do the Vizhi for ChatGPT keys disappear when I switch apps?

The profile belongs to the ChatGPT app, so Options+ shows it only while ChatGPT is in front. Switch back to ChatGPT and the keys return.

Deny and Approve are always red and green. Is something waiting?

Only when they carry a dot. Amber means a request is waiting; red means it looks risky, so read it first. Without a dot there is nothing to answer. They turn grey when the plugin can't read the ChatGPT window.

Why do I have to press Approve twice?

The first press shows Press again; the second one answers. It stops a stray press from approving anything. Approve only ever chooses “Allow once”, never “Always allow”.

Does Vizhi for ChatGPT read my conversations?

It reads what the ChatGPT window shows so the keys can show it: chat titles, button labels and whether an answer is running. It reads an answer's text only when you press Copy Reply. It stores and logs none of it and sends nothing anywhere. See the privacy policy.

Where did Continue, Scheduled, Plugins, Explore and Quick Chat go?

Continue is in Tools → More, so Prompts fits on one page. Scheduled, Plugins, Explore and Quick Chat open screens that need a mouse or typing, so they are no longer on the default keys. You can still drag them onto a key in Options+.

Uninstall and support

How do I uninstall?

1. Claude Console only: turn live status off first (hold Cost, then Turn off).
2. In Options+, right-click the plugin, choose Uninstall, and delete the imported profile.
3. On a Mac, remove Claude Console's leftover files with:

   bash ~/.claude/claude-console/scripts/uninstall.sh

Forgot step 1? Nothing breaks. On a Mac and on Windows (Claude Console 2.3.1 or newer) the plugin's entries clean themselves up. For Vizhi for Codex, the Vizhi guide lists the files to delete; the Claude Console guide has the full details.

Where do I report a problem?

On the issue tracker, or email support@rshankar.com. Please attach the plugin log:

• macOS~/Library/Application Support/Logi/LogiPluginService/Logs/plugin_logs/ClaudeConsole.log
• Windows%LOCALAPPDATA%\Logi\LogiPluginService\Logs\plugin_logs\ClaudeConsole.log

For Vizhi for Codex, the file is VizhiCodex.log in the same folder.