这个页面还没有中文版,当前显示的是英文。 英文
Docs menu

Shortcuts

Keep a task that worked, run it again with or without your AI, share it as a file, and trust one that comes from someone else.

On this page

A shortcut is a task that worked, kept with the few things that change each time. Next time, your AI does it in one go. You can also run it yourself from the app, without your AI.

Make a shortcut

There are three ways.

  1. From a task. In Activity, pick a task your AI did and click Make a shortcut. Name it, check what changes each time, and click Make the shortcut.
  2. From a suggestion. When your AI did the same task twice in the last 30 days, it shows under Suggested with “you did this twice”. Click Keep as a shortcut, or Not now to set it aside.
  3. By asking your AI. Ask it to keep the task as a shortcut.

Delta MCP keeps only what worked. A step that failed, or was undone, is left out, and the screen says so. A secret is never kept: it becomes an input you give each time.

Names the task created, such as a new folder, are marked New each time. Each run needs a fresh name, or it would make the same thing twice.

Some tasks can’t be kept: one step may use what an earlier step created, or a step failed halfway. The app says which. Ask your AI to do the task in one go, then keep it.

Run a shortcut

  1. Open Shortcuts and pick one.
  2. Fill in its inputs.
  3. Click Run.

It runs here, without your AI. The run shows in Activity as “a shortcut, no AI”, and Last runs lists it with the time it took. Your click approves its ordinary changes. Deleting or sending still follows each connector’s mode: under Ask before deleting or sending, a card opens. A Read only connector refuses, and a shortcut from someone else asks before every change until you trust it.

Your AI can run a shortcut in one line. From a terminal, a script or CI, see Shortcuts on the command line.

Share a shortcut

Click Share. Delta MCP writes the shortcut as a readable file in Documents/Delta. Change that folder in Settings, under Shortcuts you share. The file starts like this:

// Delta shortcut
// Create the tests for a site
// Name: make_site_tests
// Inputs: { site: string }
// Uses: cerberus
// Example: {"site":"https://shop.com"}

The program follows, as your AI wrote it. A shortcut with a secret written in it can’t be shared.

A shared shortcut is locked by default. If someone changes the file, you, a colleague or an AI, the locked version keeps running. The change waits for you: Keep the locked version or Accept the change. The app shows what the file says now first.

Click Unlock and the file becomes the shortcut. Its changes are taken when a conversation starts, never in the middle of one.

Shortcuts from others

Click + at the top of Shortcuts, pick a file someone sent, and click Add shortcut. It lists under From a colleague. A shortcut can also live in a project, in a .delta/shortcuts folder that Delta MCP finds from the folder your AI works in.

Both work at once. Until you trust one, every change it makes asks you, whatever the mode. Click Trust this shortcut when you are sure. Trust holds for that exact version only. If the file changes, for example after a git pull, it asks again.

A shortcut is a program that changes things in your connectors. Read it before you trust it. Under For developers, the app shows its code.

If a connector it uses is missing, the app says so. Add the connector first. If you already have a shortcut with that name, change the Name line of the file.

Remove a shortcut

Click Remove. Your AI no longer sees it, and what it did stays in Activity. A file you shared stays where it is.

In code and in the terminal, a shortcut is still called a recipe, as in recipes.make_site_tests({ site }).

Something missing or wrong? Open an issue

Coming soon

Delta MCP is almost here

The free app for Mac, Windows and Linux lands soon. Leave your email and you’ll hear the moment it’s out. No account needed.

We use your email only to tell you once when Delta MCP is out. No newsletter. Privacy policy