explaingit

funnyrz/clickmate

Analysis updated 2026-05-18

22SwiftAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A macOS app that adds a customizable right click menu to Finder for quick file actions like copying paths, hashing, and opening in your favorite apps.

Mindmap

mindmap
  root((ClickMate))
    What it does
      Finder context menu
      File templates
      Quick file actions
    Tech stack
      Swift
      SwiftUI
      AppKit
      Finder Sync extension
    Use cases
      Create files from templates
      Copy file paths in various formats
      Open files in preferred apps
    Audience
      macOS power users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Create a new file from a template directly in Finder's right click menu.

USE CASE 2

Copy a file's path in a terminal safe or URL format for pasting elsewhere.

USE CASE 3

Open a selected file directly in an editor like VS Code or Cursor from Finder.

What is it built with?

SwiftSwiftUIAppKitXcode

How does it compare?

funnyrz/clickmatethalesmms/autocomparinltte/ari
Stars222223
LanguageSwiftSwiftSwift
Setup difficultymoderatehardmoderate
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 14+, Xcode, and enabling the Finder extension in System Settings, unsigned builds may be blocked by Gatekeeper.

In plain English

ClickMate is an app for Mac computers that adds a new submenu to the right click menu in Finder, the default file browser on macOS. Instead of switching between separate apps or the terminal for everyday file tasks, ClickMate puts a configurable set of shortcuts directly where you already work, on files and folders themselves. From that new menu, you can create new files from templates for common formats such as text, Markdown, JSON, CSV, HTML, CSS, JavaScript, Swift, and Python, or your own custom file types. It can copy a file's path in several different formats, including a plain path, a file URL, or a version safely formatted for pasting into a terminal command. It can also open the selected file or folder directly in apps like Terminal, iTerm2, VS Code, Cursor, BBEdit, or Sublime Text, generate SHA-256, SHA-1, or MD5 checksums for a file, reveal a file's containing folder, create timestamped duplicates or aliases, move items into a new folder, compress files, and show details such as image dimensions or other file metadata. A settings window lets you customize which menu items appear, manage file templates, and pin your favorite apps for quick access. To build and run ClickMate, you need a Mac running macOS 14 or later and Xcode with Apple's developer tools installed. The project can be opened directly in Xcode or built from the command line. Getting the full right click menu working requires enabling the ClickMate extension in System Settings under Extensions, and in some cases restarting Finder for the menu to appear. A helper script is included for packaging an unsigned installer disk image, though macOS's Gatekeeper security feature may block that unsigned build on other people's machines unless they explicitly allow it. This project is aimed at Mac users who are comfortable building an app from source code in Xcode, rather than people looking for a ready to download application, and it is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me build and run ClickMate from source in Xcode on my Mac.
Prompt 2
Explain how to enable the ClickMate Finder extension in System Settings.
Prompt 3
Walk me through packaging an unsigned DMG for ClickMate using the included script.
Prompt 4
What file actions and copy helpers does ClickMate add to Finder's right click menu?

Frequently asked questions

What is clickmate?

A macOS app that adds a customizable right click menu to Finder for quick file actions like copying paths, hashing, and opening in your favorite apps.

What language is clickmate written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AppKit.

How hard is clickmate to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is clickmate for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.