Skip to main content

Settings

Important
This page is not meant to be viewed on the website. See it in the app under "Kit Settings" instead!
It's left here as a reference for those willing to contribute changes.

Pro Tutorials

Visit https://scriptkit.com/tutorials to view the official Script Kit tutorials created by John Lindquist.

These lessons will take your scripting skills to the next level. Unlocking countless possibilities with scripts, AI, and more! 🚀

Find Help on Github Discussions

The Script Kit community lives on GitHub discussions.

This is the place to:

Or just hit Enter to browse all.

We'll do our best to respond ASAP!

Subscribe to the Newsletter

  • Featured Scripts
  • Latest Updates
  • Tutorials and lessons
  • Script Kit Tips and Tricks
  • Curated dev news

Sign-in to Share Scripts

Sign-in to share scripts with others.

FAQ

What is Script Kit?

Script Kit is an open-source dev tool for creating, running, editing, and sharing scripts.

These scripts can run in the Kit.app, the Terminal, GitHub actions, package.json scripts, webhooks, or pretty much anywhere.

Community of Scripters?

The main goal of Script Kit is to build a community of people who love to script away the frictions of their day! 🥰

What are Kit.app, kit, and kenvs?

  • Kit.app - The Kit.app provides a UI for your scripts. The app is "script-driven" meaning that every time you launch the app, you're really launching a script. The main menu, even though complex, is a script you could write.

  • kit - "kit" is the sdk of Script Kit

    • A bundle of JavaScript common libs wrapped by an API to make writing scripts easier (get, download, replace, outputFile, etc)
    • APIs for interacting with your OS (edit, focusTab, say, notify, etc)
    • APIs for interacting with Kit.app and Terminal (arg, env, etc)
    • Scripts and utils for app setup, managing kenvs, parsing scripts, etc
  • kenvs - Kit Enviroments (AKA "kenv") are directories that contain a "scripts" directory. If you point "kit" at a "kenv", kit will parse the scripts and give you tools to simplify running and managing them.

Terminal Tools

Add ~/.kit/bin to $PATH

This is similar to VS Code's "Add code to path"

You can run the kit CLI from your terminal with

~/.kit/bin/kit

but this option will allow you run the CLI with:

kit

If you're familiar with adding to your .zshrc, just add ~/.kit/bin to your PATH.

The kit CLI will allow you to run, edit, etc scripts from your terminal.

Add kenv Executables to $PATH

Each time you create a script, Script Kit also generates a command based on the name you can run from the terminal.

If you create a script named list-downloads, then Script Kit creates a ~/.kenv/bin/list-downloads executable.

Then you can run the command like so in the terminal:

~/.kenv/bin/list-downloads

This will walk you through running the command without the full path:

list-downloads

Generate bin Files

If you manually manage files in the scripts dir (instead of using Kit.app or the kit CLI) you may run into the scenarios where you have to re-generate all the bin executables. This will do that for you.

View Automatic Scripts

View Scheduled Scripts

Use cron syntax to run scripts on a schedule:

// Schedule: */10 * * * * *

Note: these scripts must not include arg or they will time out after 10 seconds

View System Event Scripts

This menu shows scripts that run on system events.

Add the System metadata to run your script on a system event

// System: unlock-screen

Available events:

  • suspend
  • resume
  • on-ac
  • on-battery
  • shutdown
  • lock-screen
  • unlock-screen
  • user-did-become-active
  • user-did-resign-active
  • Read about the available events here

Note: YMMV based on your specific machine setup.

Settings

Theme Selector

Select from a variety of themes. Mostly a work in progress. We'll support community themes in the future. ❤️

Change Script Kit Shortcut

Don't like cmd+;? Change it here!

Add/Change a Script Shortcut

This list all the scripts and allows you to add a shortcut to it.

You can manually add shortcuts to scripts like so:

// Shortcut: cmd option g

This menu will manage that for you

Change Editor

This will re-prompt you to pick an editor from your PATH by updating your kenv .env.

You can always manually change the editor that Script Kit uses to open files in ~/.kenv/.env.

The following would use code (assuming is on the "PATH").

KIT_EDITOR=code

If code isn't on your PATH, you can add the full path to the editor.

Clear Kit Prompt Cache

Each time you move or resize the prompt around for your scripts, Script Kit will store the position and size. If you want to reset the position of you prompts back to the centered defaults, then run this command.

let express = await npm("express")

Switch to JavaScript Mode

Prefer JavaScript for your scripts? Hit Enter!

Switch to TypeScript Mode

Prefer TypeScript for your scripts? Hit Enter!

Sync $PATH from Terminal to Kit.app

Have a command that's working in your terminal, but doesn't work when you call it with Script Kit?

Use this to sync up your "PATH" from your terminal to the "PATH" that Script Kit will use.

You can manually edit a PATH value any time in ~/.kenv/.env

Check for Update

Kit.app will check for updates each time your machine wakes from sleep. But if you heard about an update and just can't wait, trigger this command to grab it.

Disable Automatic Update Check

Add the following to your .env to disable automatic update checks:

KIT_DISABLE_AUTO_UPDATE=true

Disable Telemetry

Kit.app reports anonymous open, error, prompt type, and quit events to help improve the app. If you'd like to disable this, add the following to your .env:

KIT_DISABLE_TELEMETRY=true

Select Default Display

Force the prompt to always open on a specific display.

Log and Env

Open kit.log

This will open the kit.log file in your editor. This is where Script Kit logs errors and other information.

Edit .env

This will open the .env file in your editor. This is where Script Kit stores environment variables for your scripts.

Credits

John Lindquist

Development

Vojta Holik

Design

Supported By

See You Soon 💕

Quit

See you soon! 👋