Skip to content

remotehumans/riff

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Riff

Riff Workflow - Walk around, think out loud, build with AI

Walk around. Think out loud. Talk to your computer.

Riff is two independent tools for hands-free interaction with AI agents and any app that accepts text input. Use one or both - they work together but neither requires the other.

Riff Bridge lets you speak to your computer from across the room using a smart ring and your voice. The ring triggers your voice-to-text app, and you control everything with gestures - send, delete, scroll, interrupt. It works with AI coding agents like Claude Code and Codex, but also chat interfaces, note-taking apps, email - anything you can type into.

Riff Voice gives your AI agents a voice. It speaks summaries of what your agents are doing aloud through your speakers, so you can hear task completions, errors, and progress updates without looking at the screen.

Components

Riff Bridge - Smart Ring Controller

A macOS daemon that turns a ~$15 Bluetooth smart ring (JX-11) into a wireless controller. Pair it with any voice-to-text app and you can talk to your computer hands-free from anywhere in Bluetooth range.

What you get: Step back from your desk - or walk to another room with a wireless mic - and speak instructions to AI agents, dictate notes, write emails, or put text into any app. All controlled by ring gestures.

You need: A JX-11 ring, a voice-to-text app, and a Mac.

cd riff-bridge
make install

Full setup guide →

Riff Voice - Voice Narrator for AI Agents

A macOS daemon that gives your AI agents a voice. It speaks summaries of agent activity aloud using on-device TTS (Kokoro via MLX on Apple Silicon) - so you hear when tasks start, finish, hit errors, or need attention. No API keys, no cloud, no latency.

What you get: Walk away from your desk and still know what your agents are doing. Riff Voice narrates session summaries, completions, and errors through your speakers or headphones.

You need: A Mac with Apple Silicon (M1+).

cd riff-voice
make install

Full setup guide →

Use Them Together or Separately

Setup What you can do
Riff Bridge only Speak to AI agents or any app via ring gestures. Read output on screen.
Riff Voice only Type at your desk as normal. Hear agent output spoken aloud.
Both Full hands-free loop: speak instructions via ring, hear responses via Riff Voice. Walk around and build.

Most people start with Riff Bridge - it's the core "walk around and talk to your computer" experience. Add Riff Voice later if you want audio feedback without looking at the screen.

Hardware

Item Cost Required? Where to get it
JX-11 Smart Ring ~$15 Yes AliExpress, Amazon
Voice-to-text app Free-$10 Yes FluidVoice, Superwhisper, Whisper Flow, Handy, or any app with a keyboard shortcut trigger
Wireless microphone $30-300 Optional DJI Mic, Rode Wireless Go, or any BT/wireless mic

You don't need a wireless mic to get started. The ring works with your Mac's built-in microphone - you just need to be in the same room. This alone lets you step back from your desk, stand up, and interact with your computer without being glued to your keyboard. A wireless mic extends the range so you can walk to another room, but it's not required.

Requirements

  • macOS (tested on macOS 15 Sequoia)
  • Apple Silicon (M1+) required for Riff Voice (Riff Bridge works on Intel too)
  • A voice-to-text app with a configurable keyboard shortcut (push-to-talk)

Built by Remote Humans

Riff is built by Remote Humans. We help business owners and leaders become AI-native - using AI across their business to stay ahead, reduce costs, grow faster, and work more efficiently.

  • Leader Lab - 1:1 and group AI coaching that gets business owners and leaders hands-on with AI in their actual work
  • Build & Embed - We build custom AI workflows and tools directly into your business

Licence

MIT

About

Talk to your computer hands-free using a smart ring and your voice

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors