Clueless-ly

A private, always-on-top AI assistant overlay for macOS and Windows.
Real-time transcription, on-demand screen context, excluded from screen sharing.

What is this?

Clueless-ly is a small overlay that sits above your other windows. It can listen to a conversation (your microphone and your computer's system audio), look at your screen when you ask, and answer questions in context, all in a window that the operating system keeps out of ordinary screen recordings and shares.

It uses the OpenAI API for transcription and answers. You bring your own API key.

Project status

  Ready to test. The macOS build works end to end: realtime transcription, screen context, modes (coding / interview / speech), push-to-talk, and the private overlay. Try it and report issues.

  Work in progress. The shared app and the Windows platform layer are implemented and build, but have not yet been verified on Windows hardware. Expect rough edges.

Which branch do I use?

This main branch is just the landing page. The application lives on the platform branches below.

Get started

The fastest path on either platform:

git clone <repository-url>
cd Clueless-ly
git checkout mac        # or: git checkout windows
./launch.sh             # Windows: ./launch.ps1

The launcher installs dependencies, creates your .env, and starts the app. You then add your OpenAI API key to .env.

Full instructions — dependencies, the OpenAI key, OS permissions, and packaging — are in setup.md.

Contributing? Each platform branch has an ARCHITECTURE.md that explains the codebase.

Privacy note

The overlay excludes itself from screen capture using the official OS mechanism (macOS NSWindowSharingNone, Windows WDA_EXCLUDEFROMCAPTURE). This is not a guarantee against every possible capture method, and it requires a recent OS version. Clueless-ly does not tamper with capture software, hide processes, or bypass any security controls.

License

MIT

Built With

• electron
• typescript