terminaldeck

KO | EN

gitlite — search

#javascript #python #ai #llm #machine-learning #rust #deep-learning #docker #macos #kubernetes #security #openai #mcp #open-source

(★ 47)

Control Claude Code with Stream Deck + voice dictation

terminaldeck 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TerminalDeck

Control [Claude Code](https://docs.anthropic.com/en/docs/claude-code) entirely through a Stream Deck and voice dictation. Designed for accessibility and hands-free coding.

## What It Does

TerminalDeck connects your Elgato Stream Deck MK.2 to Claude Code, letting you:

- **Open/switch terminal windows** without touching the keyboard
- **Launch Claude Code** with a single button press
- **Respond to prompts** (Yes, No, Yes to All, Cancel) hands-free
- **Navigate** conversation history (up/down arrows)
- **Submit prompts** and run commands
- **Toggle voice dictation** for truly hands-free coding

## Stream Deck Layout

```
┌─────────┬─────────┬─────────┬─────────┬─────────┐
│  Open   │ Switch  │ Launch  │   New   │  Close  │
│ Terminal│ Window  │ Claude  │Terminal │ Session │
├─────────┼─────────┼─────────┼─────────┼─────────┤
│   Yes   │ Yes to  │   No    │ Cancel  │   Tab   │
│   [Y]   │   All   │   [N]   │   ESC   │   ->|   │
├─────────┼─────────┼─────────┼─────────┼─────────┤
│ Dictate │ Submit  │   UP    │  DOWN   │ Delete  │
│   MIC   │  ENTER  │         │         │   DEL   │
└─────────┴─────────┴─────────┴─────────┴─────────┘
```

## Requirements

- **macOS 12.0** (Monterey) or later
- **Elgato Stream Deck MK.2** (15-key) - other models not yet supported
- For development: Node.js 20+, Rust (latest stable)

## Installation

```bash
git clone https://github.com/sidmohan0/terminaldeck.git
cd terminaldeck
npm install
npm run tauri:dev
```

## Configuration

In the app settings, you can configure:

- **Terminal App**: Terminal, iTerm, or Warp
- **CLI Tool**: Claude or Codex

## How It Works

TerminalDeck uses:
- **HID API** to communicate directly with Stream Deck hardware
- **AppleScript** to control terminal applications and send keystrokes
- **Tauri** for the native macOS app wrapper

## Troubleshooting

### Stream Deck Not Detected

1. Ensure Stream Deck is plugged in before launching the app
2. Check System Settings → Privacy & Security → Input Monitoring - add TerminalDeck
3. Try clicking "Connect Stream Deck" from the tray menu
4. Unplug and replug the Stream Deck, then reconnect

### Buttons Not Responding

1. Check that TerminalDeck is connected (tray icon menu)
2. Ensure Accessibility permissions are granted in System Settings
3. For dictation: verify your macOS dictation shortcut matches the app setting

### AppleScript Permissions

TerminalDeck uses AppleScript to control your terminal. On first use, macOS will prompt for permissions. Grant access in:
- System Settings → Privacy & Security → Accessibility
- System Settings → Privacy & Security → Automation

## Tech Stack

| Layer    | Technologies                        |
| -------- | ----------------------------------- |
| Frontend | React 19, TypeScript, Vite          |
| UI       | shadcn/ui, Tailwind CSS             |
| Backend  | Tauri v2, Rust                      |
| Hardware | hidapi (Stream Deck communication)  |

## Contributing

See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for development setup and guidelines.

## License

[MIT](LICENSE.md) - Sid Mohan

## Acknowledgments

Built on the [Tauri React Template](https://github.com/dannysmith/tauri-template) by Danny Smith.

terminaldeck

terminaldeck 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

terminaldeck

terminaldeck 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README