Scripts by JosXa

// Name: List Utilized Ports
// Description: Lists all utilized ports (on Windows) and associated executables.
// Author: JosXa

interface PortEntry {
  protocol: string;
  localAddress: string;
  port: string;
  pid: string;
}

interface ProcessChoice {
  name: string;
  description: string;
  value: PortEntry;
}

// Execute netstat command to get network statistics
const output = await exec(`netstat -ano`);

// Name: Download Script Kit (Win)
// Description: Downloads and runs the latest Script Kit for Windows.
// Author: JosXa

/**
 * Interface defining the structure of a release asset from the GitHub API.
 */
interface ReleaseAsset {
  name: string;
  browser_download_url: string;
}

/**
 * Interface defining the structure of a release from the GitHub API.
 */
interface Release {
  assets: ReleaseAsset[];
  tag_name: string;}

const repo = 'script-kit/app';

// Name: Time Stamp Convert
// Description: Converts timestamp to human-readable date
// Author: JosXa

import { DateTime } from 'luxon';

try {
  // Prompt the user to enter a timestamp
  const timestamp = await arg("Enter timestamp (e.g., 1740152737663):");

  // Attempt to convert the timestamp to a number and create a DateTime object
  const dateTime = DateTime.fromMillis(Number(timestamp));

  // Check if the DateTime object is valid
  if (dateTime.isValid) {
    // If valid, display the formatted date and time
    await div(dateTime.toLocaleString(DateTime.DATETIME_FULL));
  } else {
    // If invalid, display an error message
    await div("Invalid timestamp");

// Name: Batch Rename Files
// Description: Renames files in a directory using a template.
// Author: JosXa

// 1. Get the directory from the user.
const directory = await path({
  onlyDirs: true,
  placeholder: 'Pick a directory to rename files in',
});

// 2. Get the template for the new file names.
const templateString = await template(
  'NewName_$1',
  {
    placeholder: 'Enter the file name template (use $1, $2... for sequence)',
  },
);

// 3. Read the files from the directory.
const files = await readdir(directory);

// Name: Generate scripts.d.ts
// Description: Enables autocompletion for the `run` command

import "@johnlindquist/kit"

import { writeFile } from "node:fs/promises"

const scripts = await getScripts()

const availableScripts = scripts.map((x) => `  | "${x.command}"`).join("\n")

const body = `// Do not edit. Autogenerated by generate-scripts-declarations.ts
import type { Run } from "../../.kit/types/kit"

type AvailableScript = 
${availableScripts};

declare module "@johnlindquist/kit/types/kit" {
  export interface Run {
    // biome-ignore lint/style/useShorthandFunctionType: <explanation>

// Name: JSON to TypeScript
// Description: Convert some JSON to TypeScript models

import "@johnlindquist/kit"

import jsonToTS from "json-to-ts"

import { submitShortcut } from "@johnlindquist/kit/core/utils"
import { refreshable } from "@josxa/kit-utils"
import { crudArg } from "@josxa/kit-utils"
import ModernError from "modern-errors"

let json = args[0]

if (!json) {
  json = await editor({
    language: "json",
    validate(input: string): true | string {
      try {
        JSON.parse(input)

// Name: Urban Dictionary
// Keyword: ud

import "@johnlindquist/kit"
import type { Choice } from "@johnlindquist/kit"
import { DateTime } from "luxon"
import { escapeHTML } from "../../.kit/core/utils"

await setInput("")

const debouncedOnInput = debounce(async (input) => {
  if (!input) {
    return
  }

  try {
    const choices = await getResultsAsChoices(input)
    await setChoices(choices)
  } finally {
    setHint("")

// Name: Kill
// Description: Immediately terminates a Windows process using `taskkill /F /im <name.exe>`
// Keyword: kill
// Pass: true

import '@johnlindquist/kit'
import { Choice } from '@johnlindquist/kit'

const cache = await db({ recents: ["node.exe"] as string[] })

const exe = arg.pass ?? await arg('Type the name of a .exe to kill', cache.recents.map(x => {
  if (x === 'node.exe') {
    return {
      name: x,
      description: "CAUTION: This will stop all Kit Scripts (including this one, so there won't be an output)",
      value: x
    } as Choice
  }

  return x

// Name: Edit global .gitignore
// Description: Opens an editor with the global .gitignore file and sets it up if it doesn't exist

import "@johnlindquist/kit"
import { writeFile } from "node:fs/promises"
import { startSpinner } from "@josxa/kit-utils"

const cache = await db({ defaultEntries: [] as string[] })

const DESIRED_IGNORE_PATH = home(".global.gitignore")

const ensureGlobalGitIgnorePathConfigured = async () => {
  try {
    const existing = await exec("git config --global core.excludesfile")
    debugger

    if (existing.stdout.toString() !== DESIRED_IGNORE_PATH) {
      await exec(`git config --global core.excludesfile "${DESIRED_IGNORE_PATH}"`)
      await div(`Global gitconfig file configured to be at ${DESIRED_IGNORE_PATH}`)
    }

// Name: Cron Expression Validator
// Description: Validates and helps you build Crontab expressions
// Shortcode: cron
// Author: @JosXa, loosely based on Ricardo Gonçalves Bassete's version

import "@johnlindquist/kit"
import { computed, effect, signal } from "@preact/signals-core"
import cronstrue from "cronstrue"
import { markdownTable } from "markdown-table"

const FONT_SIZE = "0.8em"

const allowedCharsTable = markdownTable(
  [
    ["Character", "Meaning"],
    ["`*`", "any value"],
    ["`,`", "value list separator"],
    ["`-`", "range of values"],
    ["`/`", 'step values (e.g. `*/5 * * * *` for "every 5 minutes")'],
  ],