Skip to content

About

Clyde Commands Registry

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

27 Commits

Folders and files

Repository files navigation

Clyde Registry

The official registry for Clyde, a macOS command launcher that acts as an intent dispatcher. It's an app that opens everything.

This repo is the source of truth for all user-commands and user-scripts available at clydecommands.com/registry. Every merged PR automatically appears on the site.


What is a user-command?

A user-command is a single JSON file containing an array of related commands that Clyde loads from ~/.clyde/user-commands/.

{
  "id": "obsidian",
  "displayName": "Obsidian",
  "description": "Commands for your Obsidian vaults.",
  "version": "1.0.0",
  "author": "your-github-username",
  "homepage": "https://obsidian.md",
  "registry": "https://github.com/ColorfulDots/clyde-registry",
  "appStore": null,
  "color": "purple",
  "icon": "note.text",
  "tags": ["productivity", "notes"],
  "commands": [
    {
      "name": "Open Daily Journal",
      "keywords": ["journal", "daily", "obsidian"],
      "executor": "urlScheme",
      "target": "obsidian://daily",
      "description": "Open today's daily note in Obsidian"
    }
  ]
}

AI can generate this reliably — try it at clydecommands.com/generate.


What is a user-script?

A user-script is a shell script installed at ~/.clyde/user-scripts/. Use scripts for interactive commands, multi-step flows, or anything that needs more than a single shell one-liner.


Registry structure

official/
  user-commands/    ← JSON command modules
  user-scripts/     ← shell scripts
_template.json
_template.sh

All contributions go through a PR. Once approved and merged by the Clyde team, they appear in the registry.


Submit a user-command

1. Fork this repo

https://github.com/ColorfulDots/clyde-registry

2. Copy the template

cp _template.json official/user-commands/your-module-name.json

3. Fill it in

The id field must match the filename exactly:

your-module-name.json  →  "id": "your-module-name"

4. Validate locally

node validate.mjs

5. Open a pull request

CI runs validation automatically. The PR template will walk you through the checklist.


Submit a user-script

cp _template.sh official/user-scripts/your-script-name.sh

Fill in the header block and your script logic, then open a pull request.


Schema reference

User-command fields

Field Required Type Notes
id ✅ string Must match filename
displayName ✅ string Shown in Clyde and on the website
description ✅ string One sentence
color ✅ string Brand primary color — named (e.g. green) or hex with or without # (e.g. #1DB954 or 1DB954)
icon ✅ string Phosphor icon name (e.g. music-note, globe, terminal-window) — see phosphoricons.com
tags ✅ string[] Category tags (e.g. ["developer", "productivity"])
commands ✅ array At least one
version — string e.g. "1.0.0"
author — string Your GitHub username
homepage — string The service or tool's own website
registry — string Link back to this registry repo
appStore — string Mac App Store URL, or null if not available

Command fields

Field Required Type Notes
name ✅ string Shown in Clyde's results list
keywords ✅ string[] Words that trigger this command
executor ✅ string See executor types below
target ✅ string What to run
description ✅ string One sentence subtitle

Executor types

Executor What it does Example target
urlScheme Opens a URL or deep link https://github.com, obsidian://daily
shell Runs a shell command open -a Terminal, kill -9 $(lsof -ti:3000)
applescript Runs AppleScript source tell application "Finder" to empty trash
shortcut Runs a Shortcuts.app shortcut by name My Morning Routine

Colors

Use the brand's primary color — either a named color (e.g. green) or a hex value with or without # (e.g. #1DB954 or 1DB954). This is used as the icon background in Clyde's UI.


Security

The following patterns are automatically blocked by CI:

  • curl ... | bash / wget ... | bash
  • rm -rf /
  • dd if= (disk writes)
  • Fork bombs

Commands that download and execute arbitrary code will be rejected regardless of intent.


Installing a user-command locally

curl -o ~/.clyde/user-commands/spotify.json \
  https://raw.githubusercontent.com/ColorfulDots/clyde-registry/main/official/user-commands/spotify.json

Or browse and install at clydecommands.com/registry.


Generate with AI

Describe what you want at clydecommands.com/generate — AI generates the JSON for you. Copy, save, submit.


License

MIT — Colorful Dots, LLC

About

Clyde Commands Registry

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages