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! 🚀
![](https://www.scriptkit.com/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fbadass-courses%2Fimage%2Fupload%2Fv1683624377%2Fplaceholder-tutorial-illustration-sk_2x_thb8g3.png&w=256&q=100)
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
- A bundle of JavaScript common libs wrapped by an API to make writing scripts easier (
-
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! 👋