Extend Bolt

Glossary.

The words the Bolt Apps docs use, in two lines each.

Terms.

WordWhat it means
Tier 1Data only: text and links. No command, no network, no file access. Snippets, search engines and prompt skills are here. See Safety tiers.
Tier 2Acts inside Bolt, with no command and no network. A transform User App is here. Detectors and compliance packs are also tier 2, and only an admin can add those. See Safety tiers.
Tier 3Reaches your system or network: runs a command or script, reads another program on your computer, or calls an outside service. It runs with your own rights, the same as your terminal, so install only what you trust. A bridge or http_local App is tier 3.
transformA User App runtime that reshapes text with a pipe of up to 32 steps, on your device. Tier 2. See runtime: transform.
bridgeA User App runtime that runs one program, such as a command line tool or your own script, and shows what it prints as rows. Tier 3. See runtime: bridge and the paragraph below.
http_localA User App runtime that makes one GET or POST to a service on this computer (127.0.0.1, ::1 or localhost only) and shows the reply as rows. No script. Tier 3. See runtime: http_local.
RecognizerIn a User App, the recognize block: patterns that claim pasted or typed text so the launcher offers the App without the = key. It only offers the App; it does not mask anything. The same word is used for detectors, where a pack recognizer finds identifiers for masking. See User Apps and Detectors.

Which languages can a bridge script use, and how do input and output pass?

Any. A bridge App runs a program, not a language: Bolt splits the bridge.command line for your operating system into arguments and starts that program directly, with no shell, so a shell script, Python, Node or a compiled tool all work if the program is on the person's computer. What you type after the key arrives as an argument, written {{query}} (or your own args and inputs names) in the command, for example python3 {{scripts_dir}}/my-script.py {{query}}. Bolt closes standard input, so nothing arrives on it, and the environment is small (PATH, HOME, locale and a few others), so do not look for the typed words there. The program prints to standard output and exits 0. With parse: json, that output must be a JSON array of objects, or { "rows": [ ... ] }, and nothing else; parse: lines makes one row per line, and parse: raw one row of the whole output. A non-zero exit discards the rows and shows the error text. The program gets 10 seconds unless timeout_seconds says otherwise (1 to 60), runs in a fresh private working folder unless bridge.cwd is home, and at most 2000 rows are kept. A typed value that would begin an argument with - is refused, so it cannot become a program option. The Python kit in the Bolt Apps toolkit is optional: it is the helper the templates use, and a bridge needs none of it. Checked against the Bolt source on 2026-11-17; the Agent guide has the full row format and limits.