URL scheme

Gisti registers the gisti:// scheme. Anything that can open a URL (Shortcuts, Raycast, a shell script, another app) can talk to Gisti.

Endpoints

URL	Effect
gisti://note?text=...&title=...	create a note
gisti://capture?text=...	add a clipboard element
gisti://image?path=...	save an image into the history
gisti://open?id=...	open an element’s detail or chat view
gisti://summarize?id=...	open an element and generate its AI summary
gisti://search?q=...	bring the panel up with a search query
gisti://onboarding	reopen the first-launch welcome window

Parameters are URL-encoded. image accepts an http(s) URL or a file path; open and summarize take the element id from Copy Link (⌘ L); search also accepts query= as an alias for q=.

Gisti is sandboxed, so a plain file path must point somewhere Gisti is allowed to read – its own container. For scripting, either pass an http(s) URL, or drop the file into ~/Library/Containers/com.gisti.app/Data/tmp/ first (see the example below).

Examples

# Quick note from the terminal
open "gisti://note?text=Deploy%20checklist&title=Ops"

# Pipe a command's output into Gisti
open "gisti://capture?text=$(git log -1 --oneline | jq -sRr @uri)"

# Save an image from the web
open "gisti://image?path=https%3A%2F%2Fexample.com%2Fchart.png"

# Save a rendered chart from a script: stage it inside Gisti's
# container so the sandboxed app can read it
GISTI_TMP=~/Library/Containers/com.gisti.app/Data/tmp
cp chart.png "$GISTI_TMP/" && open "gisti://image?path=$GISTI_TMP/chart.png"

# Jump straight into search results
open "gisti://search?q=deploy%20checklist"

Copy Link on any element produces a gisti://open?id=... URL – paste it in a task manager or a doc and jump back to the exact element later. Pasted inside a note as [text](gisti://open?id=...), it becomes a clickable cross-reference between notes – see Linking to other notes.

Related

• Markdown
• Share Extension
• Clipboard