4 4
5Codex Micro is a limited-run collaboration between Codex and Work Louder. It5Codex Micro is a limited-run collaboration between Codex and Work Louder. It
6works with the ChatGPT desktop app, giving you a quick way to check on chats,6works with the ChatGPT desktop app, giving you a quick way to check on chats,
7jump between them, use push-to-talk, and trigger common actions or skills7jump between them, use voice input, and trigger common actions or skills without
8without leaving the keyboard.8leaving the keyboard.
9 9
10 10
11 11
24## Set up Codex Micro24## Set up Codex Micro
25 25
261. Open the ChatGPT desktop app.261. Open the ChatGPT desktop app.
272. Connect Codex Micro to your computer with a USB-C cable or Bluetooth, then272. Press the rear button once to turn on Codex Micro.
28 follow the setup that appears when ChatGPT detects it.283. Connect it with a USB-C cable or [pair it with Bluetooth](#pair-with-bluetooth),
293. On macOS, allow **Input Monitoring** when prompted so ChatGPT can respond to29 then follow the setup that appears when ChatGPT detects it.
304. On macOS, allow **Input Monitoring** when prompted so ChatGPT can respond to
30 key presses.31 key presses.
314. Open **Settings > Codex Micro** to choose which chats the Agent Keys follow,325. Open **Settings > Codex Micro** to choose what the Agent Keys follow or
32 assign actions to the Command Keys and analog directions, and adjust the33 trigger, customize the Command Keys, analog stick, and dial, and adjust
33 lighting.34 lighting and voice controls.
34 35
35To open these settings again, press and hold the dial for 500 milliseconds or36By default, press and hold the dial for a short while to open these settings. You
36select the Codex Micro icon beside your account name at the bottom of ChatGPT.37can also select the Micro icon beside your account name at the bottom of ChatGPT.
38A custom dial assignment can replace the press-and-hold shortcut.
37 39
38You'll see **Codex Micro** in Settings after ChatGPT detects the device for the40The device settings remain available after ChatGPT detects a supported Micro for
39first time. If you want to use the device outside ChatGPT, customize those41the first time. Work Louder Input isn't required for the ChatGPT integration.
40controls with [Work Louder Input](https://worklouder.cc/micro-setup).42Use it to customize controls for other apps or configure more layers.
43
44## Pair with Bluetooth
45
46Codex Micro provides three Bluetooth channels.
47
481. Press the rear button once to turn on the Micro.
492. Press and hold the touch control on the bottom-left edge for three seconds.
50 The lighting under the Micro turns blue when Bluetooth mode is active.
513. Tap the touch control to choose Bluetooth channel 1, 2, or 3. A fast-flashing
52 channel light means the Micro is ready to pair.
534. Open your computer's Bluetooth settings and connect to the Micro when it
54 appears.
555. Wait for the channel light to turn solid, which means pairing is complete.
56
57The connection selector closes after five seconds without input. To switch to
58another paired channel, open the selector again, choose the channel, and wait
59for it to close. To pair that channel again, press and hold the touch control
60for three seconds until its light begins flashing.
61
62To use USB-C instead, open the connection selector and tap the touch control
63until the lighting under the Micro turns white. Connecting a USB-C cable while
64the Micro is still in Bluetooth mode charges it but doesn't switch it to the
65wired connection.
66
67For hardware diagrams, see the [Work Louder Codex Micro setup
68guide](https://worklouder.cc/openai-micro-setup).
41 69
42<a id="read-and-switch-tasks-with-agent-keys"></a>70<a id="read-and-switch-tasks-with-agent-keys"></a>
43 71
46Each of the six frosted Agent Keys can follow a chat and light up to show its74Each of the six frosted Agent Keys can follow a chat and light up to show its
47current status. Press an Agent Key once to switch to that chat without bringing75current status. Press an Agent Key once to switch to that chat without bringing
48ChatGPT forward. Press it twice within 350 milliseconds to switch chats and76ChatGPT forward. Press it twice within 350 milliseconds to switch chats and
49bring the ChatGPT window forward.77bring the ChatGPT window forward. To focus ChatGPT with the first press, turn on
78**Focus ChatGPT with a single tap** in the device settings.
50 79
51| Light | Status | Meaning |80| Light | Status | Meaning |
52| ----- | ---------------- | ----------------------------------------- |81| ----- | ---------------- | ----------------------------------------- |
60The selected chat's key pulses with its status light.89The selected chat's key pulses with its status light.
61 90
62Out of the box, the keys follow your six most recently updated chats, whether91Out of the box, the keys follow your six most recently updated chats, whether
63or not they're pinned. You can change **Agent source** in **Settings > Codex92or not they're pinned. Change **Agent keys** in the device settings to use a
64Micro** to use a different arrangement:93different arrangement:
65 94
66- **Most recent chats**: Follow the six most recently updated chats, pinned or95- **Most recent chats**: Follow the six most recently updated chats, pinned or
67 unpinned.96 unpinned.
68- **Pinned chats**: Follow the first six chats in **Pinned**.97- **Pinned chats**: Follow the first six chats in **Pinned**.
69- **Priority chats**: Put chats waiting for input, unread chats, and active98- **Priority chats**: Put chats waiting for input, unread chats, and active
70 chats first.99 chats first.
71- **Custom assignments**: Choose the chat assigned to each Agent Key. Press an100- **Custom assignments**: Assign a chat, shortcut, physical key action, or enabled
72 unassigned Agent Key to open a new chat. When you start the chat, ChatGPT101 skill to each Agent Key. Press an unassigned Agent Key to open a new chat.
73 assigns it to that key.102 When you start the chat, ChatGPT assigns it to that key.
74 103
75The status colors stay the same. You can decide which chats the Agent Keys104The status colors stay the same for keys that follow chats. With **Custom
76follow, but you can't turn them into extra Command Keys.105assignments**, an Agent Key can trigger an action instead.
77 106
78## Use and customize Command Keys107## Use and customize Command Keys
79 108
99 128
100 129
101The Mic key uses your computer's microphone. Codex Micro doesn't have a130The Mic key uses your computer's microphone. Codex Micro doesn't have a
102microphone of its own. Hold the key while you speak, then release it to stop.131microphone of its own. By default, it uses **Push to talk**: hold the key while
103For hands-free recording, press it twice within 350 milliseconds to keep132you speak, then release it to stop. For hands-free recording, press it twice
104recording. Press it again to stop.133within 350 milliseconds to keep recording. Press it again to stop.
105 134
106A sea-green light moves around the keyboard while you record. It changes to a135A sea-green light moves around the keyboard while you record. It changes to a
107moving white light while ChatGPT processes your speech, then turns solid white136moving white light while ChatGPT processes your speech, then turns solid white
108when the prompt is ready. Press the Codex key to send it.137when the prompt is ready. Press the Codex key to send it.
109 138
110In **Settings > Codex Micro**, select a Command Key, then choose its keycap and139If **Voice Chat** is available under **Microphone key**, choose it to use the
111action. You can open the browser or terminal, review changes, commit with Git,140Mic key to start a Voice Chat or toggle your microphone; press and hold it to
112create a pull request, attach files or photos, manage scheduled tasks, change141end the chat. Turn on **Use separate microphone keys** to map the two switches
113reasoning effort, or open **Skills**. If you choose a keycap that's already used142under the wide Mic key independently.
143
144In the device settings, select a Command Key in the **Layout** preview, then
145choose its keycap and action. You can open the browser or terminal, manage
146chats, review changes, run Git and pull request actions, attach files or photos,
147open plugins or scheduled tasks, change reasoning effort, run an enabled skill,
148or assign another shortcut. If you choose a keycap that's already used
114somewhere else, ChatGPT swaps the two instead of using one keycap twice.149somewhere else, ChatGPT swaps the two instead of using one keycap twice.
115 150
116After you remap a key, swap the physical keycap to match its new action.151After you remap a key, swap the physical keycap to match its new action.
152Select **Reset layout** to restore the default Command Key and analog stick
153assignments without changing the Agent Key mode or custom chat assignments.
117 154
118 155
119 156
132actions. Codex Micro starts with the mappings shown here.169actions. Codex Micro starts with the mappings shown here.
133 170
134Choose any available ChatGPT desktop command or enabled skill for each171Choose any available ChatGPT desktop command or enabled skill for each
135direction in **Settings > Codex Micro**.172direction in the device settings.
136 173
137 174
138 175
151 188
152 189
153 190
154The dial moves through the composer controls and options, with **Reasoning**191The dial uses **Composer navigation** by default. Turn it to move through
155selected by default. Turn the dial to change the selection, then press it to192composer controls and options, then press it to open or select the focused
156open or select the focused control. When a composer control or menu is open,193control. When a composer control or menu is open, the Agent Key immediately to
157the Agent Key immediately to the right of the dial lights red. Press that key194the right of the dial lights red. Press that key to cancel.
158to cancel.195
196Choose one of four dial modes in the device settings:
197
198| Mode | Behavior |
199| -------------------------- | ------------------------------------------------------------------------------ |
200| **Composer navigation** | Move through composer controls and select the focused control. |
201| **Reasoning only** | Adjust reasoning effort and open its slider or advanced options. |
202| **Conversation scrolling** | Scroll the active chat; press the dial to jump to the latest message. |
203| **Custom assignments** | Assign an action or skill to the left turn, right turn, press, and long press. |
159 204
160In **Settings > Codex Micro**, choose whether the dial uses **Composer205Pressing and holding the dial opens the device settings in every mode except
161navigation** or **Reasoning only**. In **Reasoning only** mode, turning the dial206**Custom assignments**, where it runs the action assigned to the long press.
162opens and adjusts reasoning effort. Press the dial to open the slider or its
163advanced options.
164 207
165## Adjust lighting208## Adjust lighting
166 209
167In **Settings > Codex Micro**, adjust the brightness and choose how long the210{/* vale Microsoft.Auto = NO */}
168lights stay on when you're not using Codex Micro. They come back on when you
169use the keyboard or an Agent Key changes status. By default, the lights turn
170off after three minutes.
171 211
172When the keyboard reports its battery status, you can see it in **Settings >212In the device settings, adjust **Brightness** and choose an **Auto-dim**
173Codex Micro** and in the Codex Micro icon's sidebar tooltip.213interval from 30 seconds to one hour, or turn automatic dimming off. The lights
214come back on when you use the Micro or an Agent Key changes status. By default,
215the lights turn off after three minutes.
216
217{/* vale Microsoft.Auto = YES */}
218
219When the Micro reports its battery status, you can see it in the device settings
220and beside the Micro icon in the sidebar.
174 221
175## Add more layers222## Add more layers
176 223
177Codex uses layer 1. Use [Work Louder224ChatGPT uses layer 1. Use [Work Louder
178Input](https://worklouder.cc/micro-setup) to configure up to five more layers225Input](https://worklouder.cc/micro-setup) to configure up to five more layers
179with shortcuts and actions for other apps.226with shortcuts and actions for other apps.
180 227
181## Troubleshoot Codex Micro228## Troubleshoot Codex Micro
182 229
183### Pair the keyboard again
184
185Use the bottom-left touch control to start pairing again. The rear button
186controls power and doesn't start pairing.
187
1881. Hold the bottom-left touch control for three seconds to enter communication
189 mode.
1902. Tap the control to choose Bluetooth channel 1, 2, or 3.
1913. Hold the control for three seconds on that channel. The channel light flashes
192 while pairing and turns solid when paired.
193
194### Fix Input Monitoring on macOS230### Fix Input Monitoring on macOS
195 231
196If **Settings > Codex Micro** shows that Input Monitoring isn't set up, select232If the device settings show that Input Monitoring isn't set up, select **Open
197**Open System Settings**, then follow these steps:233System Settings**, then follow these steps:
198 234
1991. Open **System Settings > Privacy & Security > Input Monitoring**.2351. Open **System Settings > Privacy & Security > Input Monitoring**.
2002. Turn on access for ChatGPT if it's already listed. If it's missing, drag2362. Turn on access for ChatGPT if it's already listed. If it's missing, drag
201 **ChatGPT** from Applications into the list, or select **Add (+)** and choose237 **ChatGPT** from Applications into the list, or select **Add (+)** and choose
202 **ChatGPT**.238 **ChatGPT**.
2033. Quit and reopen ChatGPT, then confirm ChatGPT detects Codex Micro on layer 1.2393. Quit and reopen ChatGPT, then confirm it detects the Micro on layer 1.
204 240
205For more about this macOS permission, see [Apple's Input Monitoring241For more about this macOS permission, see [Apple's Input Monitoring
206guide](https://support.apple.com/guide/mac-help/mchl4cedafb6/mac).242guide](https://support.apple.com/guide/mac-help/mchl4cedafb6/mac).
207 243
208### Get more Work Louder help244### Fix connection interference
245
246ChatGPT retries automatically when it detects a Micro but can't connect or loses
247communication. If the problem continues, reconnect the Micro and check whether
248a keyboard utility or security tool blocks access to it.
209 249
210For help with Bluetooth, cables, power, or resetting the keyboard, see250{/* vale Vale.Spelling = NO */}
211the [Creator Micro 2 setup guide from Work Louder](https://worklouder.cc/micro-setup).
212For direct support, email [hello@worklouder.cc](mailto:hello@worklouder.cc).
213 251
214## Get Codex Micro252On macOS, Work Louder notes that Karabiner and Logitech Options+ can interfere
253with Micro communication when those apps have Input Monitoring permission. To
254test for interference, quit the keyboard utility or temporarily turn off its
255Input Monitoring access, then reconnect the Micro. If your organization manages
256your computer, ask your IT administrator to check the device rules.
215 257
216You can buy Codex Micro through [OpenAI Supply258{/* vale Vale.Spelling = YES */}
217Co](https://openai.com/supply/co-lab/work-louder/) while supplies last.259
260### Get more Work Louder help
218 261
219{/* vale Microsoft.We = NO */}262For help with Bluetooth, cables, power, or resetting the keyboard, see the [Work
220{/* vale write-good.TooWordy = NO */}263Louder Codex Micro setup guide](https://worklouder.cc/openai-micro-setup). For
264direct support, email
265[hello@worklouder.cc](mailto:hello@worklouder.cc).
221 266
222We expect orders to begin shipping shortly after purchase.267## Get a compatible Micro
223 268
224{/* vale Microsoft.We = YES */}269Check Codex Micro availability through [OpenAI Supply
225{/* vale write-good.TooWordy = YES */}270Co](https://openai.com/supply/co-lab/work-louder/). The ChatGPT desktop app also
271supports [Creator Micro 2](https://worklouder.cc/creator-micro-2), available
272directly from Work Louder.
