palantir-notifications

star 0

Sends rich Windows Toast Notifications from the command line using the Palantir CLI tool. Use when the user wants to show notifications, display alerts, prompt for confirmation, capture user input via toasts, track progress with toast progress bars, or integrate notifications into scripts and CI/CD pipelines. Requires Windows 10+ and the Palantir .NET global tool.

MoaidHathot By MoaidHathot schedule Updated 4/30/2026
play_arrow Run Skill in Manus View GitHub

name: palantir-notifications description: Sends rich Windows Toast Notifications from the command line using the Palantir CLI tool. Use when the user wants to show notifications, display alerts, prompt for confirmation, capture user input via toasts, track progress with toast progress bars, or integrate notifications into scripts and CI/CD pipelines. Requires Windows 10+ and the Palantir .NET global tool. compatibility: Requires Windows 10 build 17763+, .NET 10 SDK, and the Palantir global tool (dotnet tool install --global Palantir)

Palantir — Windows Toast Notifications CLI

Palantir is a CLI tool for displaying rich Windows Toast Notifications. It supports text, images, buttons, input forms, audio, progress bars, presets, and interactive wait-for-response patterns.

Installation

dotnet tool install --global Palantir

Verify it works:

palantir test

Core Usage

Simple notifications

palantir -t "Title" -m "Message"
palantir -t "Build OK" -m "All tests passed" --attribution "Via CI" -a mail

Key options

Option Short Purpose
--title -t Bold first line
--message -m Second line
--body -b Third line
--attribution Small text at bottom
--audio -a Sound: default, im, mail, reminder, sms, alarm, call
--silent -s No sound
--duration short (5s) or long (25s)
--image -i App logo (file path or URL)
--hero-image Large banner image
--quiet -q Suppress console output

For the complete options list, see references/options.md.

Buttons

Three button types:

Format Example Behavior
"Label" --button "OK" Dismiss
"Label;submit" --button "Send;submit" Foreground activation (captures input)
"Label;uri" --button "Open;https://..." Opens URI

Submit buttons are required to capture user input. Dismiss buttons discard input.

Structured alternative: --button "label=Send,action=submit,arguments=send-reply"

Input Forms

# Text input
--input "id;placeholder text"

# Selection box (combo box)
--selection "id;Option A,Option B,Option C"

Inputs are only useful with a submit button and --wait:

palantir -t "Reply" \
  --input "reply;Type here..." \
  --button "Send;submit" --button "Cancel" \
  --wait

Output when user types and clicks Send:

{"action":"activated","arguments":"button=Send","userInputs":{"reply":"hello"}}

Wait for Interaction

--wait blocks until the user interacts. Returns JSON to stdout.

palantir -t "Deploy?" --button "Yes;submit" --button "No" --wait

Exit codes

Code Meaning
0 activated (user clicked submit button or toast body)
1 dismissed (user swiped away / clicked X)
2 failed
3 cancelled (Ctrl+C)
4 timed out

Timeout

palantir -t "Confirm" --button "OK;submit" --wait --timeout 30

Output formats

Format Flag Output
JSON --format json {"action":"activated","arguments":"button=OK"}
Text --format text action=activated\narguments=button=OK
None --format none No output, just exit code

PowerShell scripting pattern

$result = palantir -t "Continue?" -m "Deploy to prod?" `
  --button "Deploy;submit" --button "Cancel" `
  --wait --timeout 60 | ConvertFrom-Json

switch ($result.action) {
    "activated" { Write-Host "Deploying..." }
    "dismissed" { Write-Host "Cancelled" }
    "timedOut"  { Write-Host "No response" }
}

Capturing form input

$result = palantir -t "Bug Report" `
  --input "desc;Describe the issue" `
  --selection "severity;Critical,High,Medium,Low" `
  --button "Submit;submit" --button "Cancel" `
  --wait | ConvertFrom-Json

if ($result.action -eq "activated") {
    $desc = $result.userInputs.desc
    $sev = $result.userInputs.severity
}

Progress Bars

Show progress

palantir -t "Downloading" \
  --progress-title "file.zip" \
  --progress-value 0.6 \
  --progress-status "60%..." \
  --tag "dl-1"

Use --progress-value indeterminate for a spinning indicator.

Update progress (no new popup)

palantir update --tag "dl-1" --progress-value 0.8 --progress-status "80%..."
palantir update --tag "dl-1" --progress-value 1.0 --progress-status "Complete!"

Replace with final result

palantir -t "Download Complete" -m "file.zip" --tag "dl-1" --replace -a default

Presets

Three built-in presets: alarm, reminder, call.

palantir -t "Alert!" --preset alarm        # alarm sound, looping, long duration
palantir -t "Meeting soon" --preset reminder  # reminder sound, long duration

Custom presets

# Save
palantir preset save my-alert '{"audio":"mail","duration":"long","attribution":"Via CI"}'

# Use
palantir -t "Done" --preset my-alert

# List / show / delete
palantir preset list
palantir preset show my-alert
palantir preset delete my-alert

CLI options always override preset values.

Config file location (first match): $PALANTIR_CONFIG_PATH, $XDG_CONFIG_HOME/Palantir/, %APPDATA%\Palantir/. File: palantir.json.

Tagging & Headers

# Tag for later update/remove/replace
palantir -t "Build" -m "Running..." --tag "build-1" --group "ci"

# Group in Action Center under a header
palantir -t "PR merged" --header-id "github" --header-title "GitHub"

Subcommands

Command Purpose
palantir clear Clear all notification history
palantir remove --tag X Remove a specific toast
palantir remove --group X Remove all toasts in a group
palantir update --tag X ... Update progress data
palantir history List active notifications
palantir test Send a test notification
palantir preset save/list/show/delete Manage presets
palantir completions powershell Generate shell completions

Other Features

Feature How
Stdin pipe echo "text" | palantir -t "Title" -m -
JSON input palantir --json notification.json or --json - for stdin
Dry run palantir -t "Test" --dry-run (outputs XML, no toast)
On-click command palantir -t "Done" --on-click "explorer ." (implies --wait)
Launch URI palantir -t "Click me" --launch "https://example.com"
Version palantir --version

Styling, Layout & Rich Content

Windows toasts cannot render arbitrary text colors, inline bold/italic, or hyperlinks inside text — these are platform limits. Three opt-in tiers exist; defaults are unchanged.

Tier 1 — Per-line styling

palantir -t "Done" --title-style large --title-align center \
                   -m "subtle note" --message-style dim
Friendly alias Schema value
header header
large title
normal base
small caption
dim baseSubtle

Raw schema values (e.g. titleNumeral, subheaderSubtle) are also accepted. Alignment: left, center, right.

Tier 1.5 — Extra text lines

palantir -t "Title" \
  --extra-text "Line 4" --extra-text-style dim \
  --extra-text "Line 5" --extra-text-align right

Each --extra-text-style / --extra-text-align attaches to the most recent --extra-text (left-to-right ordering).

Tier 2 — Multi-column / multi-row layout

palantir -t "Backup" \
  --column "text=Started:;style=dim" --column "text=10:42 AM;align=right" \
  --column-row \
  --column "text=Files:;style=dim"   --column "text=1,234;align=right"

Spec format: ;-separated key=value pairs (text, style, align). --column-row separates rows; omit for a single-row layout.

Tier 3 — Full XML control

# Verbatim <text> element
palantir -t "Score" \
  --text-raw '<text hint-style="titleNumeral" hint-align="center">42</text>'

# Inject XML at any anchor (binding default, actions, toast)
palantir -t "Custom" --xml-anchor actions \
  --xml-fragment '<action content="X" arguments="x" activationType="foreground"/>'

# Load from file
palantir -t "Custom" --xml-fragment "@./fragment.xml"

Add --validate-xml to enable schema validation in the CLI (off by default for speed; library ToastOptions.ValidateXml defaults true).

Color: emoji shortcodes (opt-in)

palantir --expand-shortcodes -t ":check: Done" -m ":warn: Heads-up"

Built-in codes: :check: :x: :warn: :info: :question: :exclamation: :red_circle: :green_circle: :yellow_circle: :blue_circle: :white_circle: :black_circle: :bell: :hourglass: :rocket: :fire: :sparkles: :lock: :unlock: :tada: :wave: :gear: :wrench: :hammer: :package: :floppy_disk: :zap: :bug: :mag: :eyes: :thumbsup: :thumbsdown: :heart: :star:. Unknown codes are left literal. To use other emoji, place them directly in the text (no flag needed).

What is NOT possible

  • Custom RGB/hex text colors
  • Inline **bold** / *italic* / underline
  • Hyperlinks inside body text
  • HTML / Markdown / XAML rendering

Workaround for "color": colored hero/inline image plus emoji.

Personalities (Toast App Identity)

Each toast has a corner icon + app name (controlled by Windows AUMID). Personalities let you switch them per-toast.

# Register a personality (auto on first use, or explicit)
palantir personality register --name opencode \
  --display-name "OpenCode" --icon path-or-url

# Per-toast
palantir --as opencode -t "..."

# Set default
palantir personality use --name opencode

# One-off
palantir --display-name "X" --app-icon path -t "..."

Built-in default: when nothing else is specified, Palantir auto-registers and uses a palantir personality (display "Palantir", icon = exe icon). Customize via a personalities.palantir entry in palantir.json. Shown in personality list as [built-in,windows]. Bulk ops skip it (auto-recreates).

Command Effect
personality list config + Windows state
personality register-all register everything in config
personality sync [--dry-run] reconcile both directions
personality prune remove stale Windows entries
personality unregister-all remove all (with --yes to skip prompt)
personality delete --name X config-only removal

Lifecycle flags: --yes (skip prompt), --keep-history (preserve Action Center history), --keep-shortcut (advanced).

Cache & Paths

palantir.json is portable (logical only). registry.json and the cache are machine-local state and recreated automatically — never sync them.

paths section (all keys optional):

{
  "paths": {
    "cache":    "${XDG_CACHE_HOME}/palantir",
    "icons":    "${PALANTIR_CONFIG}/icons",
    "registry": "${XDG_STATE_HOME}/palantir/registry.json"
  }
}

Tokens supported anywhere (incl. personalities.*.icon): ${VAR} (any env var), ${PALANTIR_CONFIG}, ${PALANTIR_CACHE}, leading ~.

Defaults:

  • Cache: paths.cache → PALANTIR_CACHE_PATH → XDG_CACHE_HOME/palantir → XDG_CONFIG_HOME/palantir/cache → %LocalAppData%\Palantir\cache
  • Registry: paths.registry → PALANTIR_REGISTRY_PATH → XDG_STATE_HOME/palantir/registry.json → %LocalAppData%\Palantir\state\registry.json
Command Effect
cache path print resolved directories
`cache clear [--icons --images]`

Common Patterns

CI/CD build result

if ($LASTEXITCODE -eq 0) {
    palantir -t "Build OK" -m "$project succeeded" -a default -q
} else {
    palantir -t "Build Failed" -m "$project has errors" --preset alarm -q
}

Confirmation dialog with timeout

palantir -t "Destructive Action" -m "Delete all temp files?" `
  --button "Delete;submit" --button "Cancel" `
  --wait --format none --timeout 30

if ($LASTEXITCODE -eq 0) { Remove-Item .\temp\* -Recurse }

Progress tracking loop

palantir -t "Processing" --progress-title "Files" `
  --progress-value 0.0 --progress-status "Starting..." --tag "proc" -q

for ($i = 1; $i -le $total; $i++) {
    # ... do work ...
    palantir update --tag "proc" --progress-value ($i/$total) `
      --progress-status "$i/$total done" -q
}

palantir -t "Complete" -m "All files processed" --tag "proc" --replace -q

For more examples including multi-step workflows, monitoring dashboards, and scheduled reminders, see EXAMPLES.md.

Install via CLI
npx skills add https://github.com/MoaidHathot/Palantir --skill palantir-notifications
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
MoaidHathot
MoaidHathot Explore all skills →