ClickGit Button Setup Guide

Everything you need to know to set up and use your ClickGit button

🎉 Your Button Comes Ready to Party!

Your ClickGit button arrives pre-configured in PARTY Mode - perfect for testing that everything is working properly.

What it does:

  • Button LEDs cycle through colorful patterns
  • Pressing the button types "DISCO" on your computer
  • Shows all the hardware features work correctly

Why this is useful:

  • Confirms your computer recognizes the button
  • Verifies the USB connection is working
  • Ensures the button is typing correctly
  • No setup required - it works right out of the box!

Ready to start committing code? Follow the quick start guide below to configure your button for Git.

🚀 Quick Start Guide

1Connect your button

Plug your ClickGit button into your computer with the included USB-C cable. It will briefly light up blue.

2Enter configuration mode

Hold down the button for 5 seconds until it turns solid red, then release.

3Connect to the button's WiFi

On your computer, connect to the WiFi network named clickgit (no password required).

4Configure your button

Open your web browser and go to http://192.168.4.1, then select your preferred mode.

5Exit configuration mode

Hold the button for 5 seconds again until the red light turns off, then start using your button!

Your button comes in PARTY Mode by default (changing colors and typing "DISCO").

See the detailed guide below for complete setup instructions.

Setting Up Your ClickGit Button

What's in the Box

  • ClickGit Button
  • USB-C to USB-C cable
  • Setup & Review Card

Step 1: Connecting Your Button

Connect your ClickGit button to your computer using the included USB-C cable. The button will light up blue briefly when connected.

⚠️

The button works with any USB-C port on your computer. No additional drivers are needed.

Step 2: Understanding Button Modes

Your ClickGit button has four operating modes:

PARTY Mode (Default)

The device comes configured in this mode! Each button press changes the LED colors and types "DISCO" on your computer. Perfect for testing if your button is working correctly.

YOLO Mode

Quick commits with a "YOLO" message. Press the button and it will automatically add, commit with "YOLO", and push to your repository.

AI Commit Mode

Uses Cursor IDE's AI feature to generate meaningful commit messages. It will stage changes, generate an AI message, commit, and push.

Custom Macro Mode

Define your own sequence of keyboard commands and actions. Perfect for custom workflows.

Step 3: Configuring Your Button

Entering Configuration Mode

  1. Hold down the button for 5 seconds
  2. The button will turn solid red when in configuration mode
  3. Release the button

Connecting to Configuration

  1. On your computer, look for a WiFi network named "clickgit"
  2. Connect to this network (no password required)
  3. Open your web browser and navigate to: http://192.168.4.1
  4. You should see the ClickGit configuration page
⚠️

You will temporarily lose internet connection while connected to the ClickGit WiFi network. This is normal.

Choosing Your Mode

Select one of the four modes from the dropdown menu:

  • PARTY Mode: Fun mode that changes colors and types "DISCO" (default)
  • YOLO Mode: For quick commits with a "YOLO" message
  • AI Commit Mode: For using Cursor IDE's AI commit feature
  • Custom Macro: For defining your own command sequence

Exiting Configuration Mode

After saving your settings, hold the button for 5 seconds again to exit configuration mode. The red light will turn off.

Step 4: Using Your Button

  1. Make sure you're in a Git repository on your computer
  2. Open your terminal or code editor (we recommend Cursor IDE for best results)
  3. Make some changes to your code
  4. Press the ClickGit button to commit and push your changes
  5. Watch the button's green light celebration when successful!

Macro Language Reference

Basic Commands

// Comment

Line is ignored

DELAY 1000

Wait for 1000 milliseconds

TYPE text

Type text without pressing Enter

PRINT text

Type text and press Enter

KEY RETURN

Press the Enter/Return key

Key Combinations

COMBO CTRL+c

Press Ctrl+C (copy)

COMBO CTRL+ALT+DELETE

Press Ctrl+Alt+Delete

COMBO GUI+SPACE

Press Command/Windows+Space

COMBO SHIFT+F5

Press Shift+F5

Example: Git Commit Workflow

// Open terminal
COMBO CTRL+SHIFT+`
DELAY 1000

// Stage all changes
PRINT git add .
DELAY 800

// Create commit with message
TYPE git commit -m "Updated documentation and fixed bugs"
KEY RETURN
DELAY 1200

// Push to remote repository
PRINT git push
DELAY 3000

// Show success message
PRINT echo "✅ Changes pushed successfully!"

Ready to start committing?

Your ClickGit button is all set up and ready to use!

Back to Home