Skip to content
alejandrom2Public

About

Control T3 Code from your Stream Deck or Logitech mouse: threads, approvals, models, effort, git and pull requests on keys, dials and the Actions Ring. Independent project, not affiliated with T3 Code, Elgato, Logitech or OpenDeck.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

200 Commits

Folders and files

Repository files navigation

Turnkey logo: three Stream Deck keys

Turnkey
for T3 Code

Control T3 Code from your Stream Deck, your Logitech mouse or your MX Keypad.
See every agent thread, approve and answer from a key, switch models and effort on a dial, and run git and pull request actions without switching to T3 Code.

Download for Stream Deck  Download for Logitech  Buy me a coffee

Works with Stream Deck

CI Release License: MIT

Guide · Discussions · Contributing

Turnkey on a Stream Deck +, showing agent threads on its keys

What it does

A thread's key: done, three minutes
Threads on keys and dials
Status, title and run time for every thread, tinted when one needs you. Tap to open it.
The Allow once key for a command approval
Act without switching windows
Approve, deny or answer agents, send prompts, steer or stop a turn.
The Model key on Terra 5.6
Model controls
Model, effort, fast mode, access and plan mode, from keys or the Power dial.
A pull request key with one check failing
Git and pull requests
Commit, push, open a PR, watch its checks and send Fix findings to the thread.
A usage key: 72% of the 5-hour limit
Usage and limits
Cost, tokens and subscription limit windows, as on T3 Code's Usage page.
A machine's key: Studio, connected
Every provider and machine
Codex, Claude, Cursor, OpenCode and the rest, on local and remote T3 Code.

Supported devices

Each device gets a ready-made Turnkey profile, and you can drag any action onto your own.

The Power dial's strip on a Stream Deck +: model, effort, speed and access mode Stream Deck +
Keys for everyday actions and dials for threads, usage, the Power dial (model, effort and access) and skills. Swipe the touch strip to a menu of folders: Threads, Controls, Prompts, Skills, Git, Pull Requests, Usage and More, each with its own dials.
A thread's key: done, three minutes Stream Deck, XL and Mini
The 15-key Stream Deck has four thread keys and the everyday actions, then pages for threads, controls, skills, git and usage. The XL shows eight threads on its first page, and the Mini fits two threads with Activity, Approve and Stop.
A Stream Deck Neo info bar: Fix flaky auth needs approval, two minutes, with one thread waiting and two running Stream Deck Neo
The Stream Deck + pages on keys. The info bar follows the page you're on: the most urgent thread on home, the model in Controls, the branch in Git, the pull request in Pull Requests, the queue in Prompts and the tightest limit in Usage.
Turnkey's Actions Ring for T3 Code: hovering the most urgent thread names it, then the Threads, Prompts, Models and Limits folders open in turn, each with a slot hovered: 2 waiting on you · 3 running, Fix tests, Claude · Opus 5.5 and Claude · 5-hour: 47% used Logitech Actions Ring
T3 Code gets its own Actions Ring on an MX mouse or keyboard: the thread that needs you, Continue and Stop, and folders for your threads, quick prompts, models and limits. Each slot shows live state, and hovering names its thread, model or limit. An MX Master 4 buzzes when a thread needs approval, asks a question, finishes or fails.
An Approve key: Allow once for npm run db:migrate Logitech MX Keypad
A ready-made page of nine keys: three threads, then Approve, Continue and Deny, then the Turnkey folder, Effort and Limits. Each key shows the full face as on Stream Deck, and keys that can't be undone, like Approve, act only when held. Git, pull request, health and preview actions wait in the Turnkey folder.

See it

video.mp4

Allow once and Deny keys for an agent's command approval

Get started

Turnkey connects the way T3 Code's own web and mobile clients do: a pair link, then a live WebSocket feed of your threads. It doesn't read app files or drive the UI, and it talks only to the T3 Code servers you pair it with.

Stream Deck

You need the Stream Deck app 7.6 or newer on macOS 12+ or Windows 10+, and T3 Code running on this computer or one you can reach. Turnkey works on the Stream Deck +, the 15-key Stream Deck, XL, Mini and Neo; dials need a Stream Deck +.

  1. Install. Download Turnkey.streamDeckPlugin and double-click it. Stream Deck offers Turnkey's ready-made profiles: pick one, or drag actions from the Turnkey category onto your deck.
  2. Create a pair link. In T3 Code, open Settings → Sharing & access and create one.
  3. Connect. In Stream Deck, open any Turnkey action's settings, paste the link under Add a machine and press Connect.

Add each machine once; every action can follow one machine or all of them. Pairings last 30 days, and you can revoke Turnkey anytime from Sharing & access in T3 Code.

Logitech

You need Logi Options+ on macOS, an MX mouse or keyboard with the Actions Ring, or an MX Keypad, and T3 Code as above. Haptics need an MX Master 4. Windows isn't tested yet.

  1. Install. Download Turnkey.lplug4 and open it to install it in Logi Options+.
  2. Pair. In Options+, Turnkey's actions show a Pair with T3 Code banner. Its button opens a Turnkey Settings page on this computer: paste a pair link from T3 Code's Settings → Sharing & access and press Connect.
  3. Pick the ring. In Options+, add T3 Code to the Actions Ring and choose its Default profile. Rearrange it as you like, or put Turnkey's actions on any other profile. Turnkey Settings on the ring reopens the settings page.
  4. Set up the keypad. On an MX Keypad, choose the T3 Code app's Default profile in Options+: three threads, Approve, Continue and Deny, the Turnkey folder, Effort and Limits. Hold a key to confirm anything that can't be undone.

The guide covers every action, the settings window, profiles, extra access and known limits.

OpenDeck

Turnkey also runs under OpenDeck, including on Linux. Install the same .streamDeckPlugin from OpenDeck's plugin manager. It needs Node.js 22 or newer installed natively (not the Flatpak), and on Linux, Share's copy needs wl-copy (Wayland) or xclip (X11).

What OpenDeck can't do yet: the ready-made profiles and switching to them when T3 Code opens (use OpenDeck's own per-app profiles instead), and the Neo info bar. On Linux, Turnkey reconnects on its own schedule rather than the moment T3 Code launches.

Support Turnkey

Turnkey is free. If it saves you some clicks, a coffee keeps it going. ☕

Buy me a coffee

Contributing

Bug reports, fixes, translations and ideas are welcome. See CONTRIBUTING.md for setup and house rules, and SECURITY.md to report a vulnerability privately. Turnkey's translations were machine-made, so corrections from native speakers help a lot.

License

MIT © 2026 Alejandro Martinez. See LICENSE. Bundled third-party code and assets keep their own licenses: T3 Code (MIT) and Lucide (ISC), in LICENSES.

Disclaimer: Turnkey is an independent project, not affiliated with T3 Code or the companies it names.

Turnkey is an independent project. It is not affiliated with, endorsed by, or sponsored by T3 Code or its creators, Elgato or Logitech, or by any of the companies below.

T3 Code is a product of T3 Tools Inc. Claude and Claude Code are trademarks of Anthropic, PBC. OpenAI, ChatGPT and Codex are trademarks of OpenAI. Cursor is a trademark of Anysphere, Inc. Grok is a trademark of xAI. Antigravity and Gemini are trademarks of Google LLC. OpenCode, Pi, Muse and any other agent or provider names belong to their respective owners. GitHub is a trademark of GitHub, Inc. Stream Deck is a trademark of Corsair Memory, Inc. Logitech, Logi, Logi Options+, MX Master and Actions Ring are trademarks of Logitech. All other names, logos and brands are the property of their respective owners and are used only to identify the services Turnkey works with.

Provider marks are shown as T3 Code shows them, to identify the agent a thread runs on. Portions of Turnkey (usage and limits math, prompt texts, provider marks) are adapted from T3 Code under the MIT license; see LICENSES/t3code.txt. Icons are from Lucide under the ISC license; see LICENSES/lucide.txt.

Turnkey talks only to the T3 Code servers you pair it with. It sends nothing to its maker, and it doesn't run or bill any AI model itself: your agents' usage stays with your own provider accounts in T3 Code.

About

Control T3 Code from your Stream Deck or Logitech mouse: threads, approvals, models, effort, git and pull requests on keys, dials and the Actions Ring. Independent project, not affiliated with T3 Code, Elgato, Logitech or OpenDeck.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages