VibeCoding666

English | 中文

Human-Only Section

This is a serious yet abstract project! Joke around if you want, but don’t treat Vibe Coding as a joke.

This is an on-screen keyboard shortcut tool built specifically for Vibe Coding. It was inspired by a RedNote user asking for a Vibe Coding shortcut keyboard. With one mouse click, you can quickly input common prompts such as “Help me fix this bug,” “Keep fixing the bug,” “Reply to me in Chinese!”, and “Write the code directly.” All key contents are fully customizable. Simply attach it to either side of your screen workspace and you can use it freely.

The name VibeCoding666 is a blessing for everyone to stay “666” (smooth and awesome) throughout Vibe Coding. This project was also developed fully in a Vibe Coding style, including architectural decisions—except for this section in the README.

It is designed to be compatible with macOS/Windows/Linux, but is currently only tested on macOS 13.7.

Latest Version

• Current version: v0.3.4 (2026-02-14)
• This update: fixed low contrast of control buttons and product title text under light system appearance by automatically switching to dark text (matching key label color) for better visibility

Quick Start

Option 1: Full Desktop App (Recommended)

cd VibeCoding666
npm install
npm start

Option 2: Lightweight Server Version

cd VibeCoding666/simple
npm install
node server.js

Features

• Custom keys: each key can define its own display label and input content
• Smart layout behavior: horizontal layout auto-binds to top/bottom edge snapping; vertical layout auto-binds to left/right edge snapping
• UI optimization: compact title bar optimized for vertical mode
• Independent settings window: settings no longer jump with the main window, improving stability
• Cross-platform support: macOS (Intel/Apple Silicon), Windows, Linux
• System-level input: click to type into the currently active window
• Configurable appearance: adjust opacity and always-on-top behavior
• Global shortcut: Ctrl/Cmd + Alt + K to show/hide
• Config import/export: convenient for backup and sharing

System Requirements

macOS

xcode-select --install

Windows

Run PowerShell as Administrator:

npm install --global windows-build-tools

Linux (Ubuntu/Debian)

sudo apt-get install libxtst-dev libpng++-dev

Linux (Fedora/RHEL)

sudo dnf install libXtst-devel libpng-devel

Installation Troubleshooting

If installation fails, it is usually caused by native module build issues:

# Clear cache
npm cache clean --force
rm -rf node_modules package-lock.json

# Reinstall
npm install

System Permissions & Security Notes

⚠️ This project relies on robotjs to simulate system-level input. If clicking keys does not type anything, it is usually not a functional bug, but blocked by system permissions or security policies.

macOS (Most Important)

After first launch, grant Accessibility permission:

1. Open System Settings → Privacy & Security → Accessibility
2. Add and enable the program used to run this project:
   • Dev run: Terminal / iTerm (whichever terminal runs npm start)
   • Packaged run: VibeCoding666.app
3. Quit and relaunch the app

If input still does not work, continue checking:

• Privacy & Security → Input Monitoring: allow the terminal or VibeCoding666.app, then relaunch
• Privacy & Security → Automation: if related prompts appear, allow control of target apps

Windows

Input may fail due to privilege level mismatch or security software interception:

1. Start the app (or terminal running it) with Run as administrator
2. If the target app also runs as administrator, ensure this app runs as administrator too
3. Add the app directory to Windows Defender / third-party antivirus trust or whitelist

Linux

Linux desktop environments vary a lot. Common limitations:

1. Wayland sessions often restrict input simulation; switch to X11/Xorg and try again
2. Ensure required dependencies are installed (see Linux requirements above)
3. Remote desktop or sandbox environments may block input through session policies; test in a local desktop session

Usage

1. Show/hide: shortcut Ctrl/Cmd + Alt + K
2. Move position: drag by holding the title bar
3. Customize keys: click the ⚙ settings button
4. Config management: supports JSON config import/export

Tech Stack

• Electron: cross-platform desktop framework
• robotjs: system-level input simulation
• HTML5/CSS3: user interface

Config File Location

• macOS: ~/Library/Application Support/VibeCoding666/
• Windows: %APPDATA%/VibeCoding666/
• Linux: ~/.config/VibeCoding666/

Uninstall

Windows

When using the uninstaller bundled with the installer, a confirmation dialog appears:

• Select No: uninstall app only, keep user data
• Select Yes: uninstall app and delete user data (config and custom keys)

macOS

Run the uninstall script:

npm run uninstall:mac

The script first uninstalls the app, then asks whether to remove user data (config and custom keys).

Linux

Run the uninstall script:

npm run uninstall:linux

The script first tries to remove the vibecoding666 package (if installed), then asks whether to remove user data (config and custom keys).

License

MIT (see LICENSE)