razorback16
Claude's answers, rendered: Markdown, math, charts and diagrams drawn in the Claude Code terminal. Independent project, not affiliated with Anthropic.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/razorback16--cc-intelligent-ui)HTML
<a href="/listings/razorback16--cc-intelligent-ui"><img src="/api/listings/razorback16--cc-intelligent-ui/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
On macOS or Linux:
curl -fsSL https://intelligentui.art/install.sh | bash
It installs Typst if needed, installs the mod and turns on auto-update. Then restart Claude Code. Run it again to update. [What the script does](docs/install.md#the-install-script).
**By hand:** install [Typst](https://typst.app) 0.15 (`brew install typst`), then in Claude Code type `/plugin install cc-intelligent-ui --marketplace razorback16/cc-intelligent-ui`, and turn on auto-update in `/plugin`. [Install guide](docs/install.md).
Needs Claude Code 2.1.298 or later. Works best in fullscreen mode (`/tui fullscreen`).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 8 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "razorback16",
- "owner": { "name": "razorback16" },
- "metadata": {
- "description": "Intelligent UI: Claude's answers drawn as rendered Markdown in your terminal"
- },
- "plugins": [{ "name": "cc-intelligent-ui", "source": "./" }]
- }
README.md · README · 104 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="outcomes/out/hero-dark.gif">
- <source media="(prefers-color-scheme: light)" srcset="outcomes/out/hero-light.gif">
- <img alt="Claude Code: a prompt asks Claude to show what Markdown it can draw, and the answer draws as one rendered picture: a cover image, a heading, a table, LaTeX math, a code block with syntax colours, a task list and a note" src="outcomes/out/hero-light.gif" width="100%">
- </picture>
- # Intelligent UI for Claude Code
- **Claude's answers, rendered.** Real Markdown, math, charts and diagrams, right in your terminal.
- <sub>An independent, community-made mod for Claude Code. Not affiliated with Anthropic.</sub>
- Intelligent UI draws each answer from Claude as a typeset picture, with [Typst](https://typst.app). Tables line up, equations look like a paper, and Claude can draw a chart or a diagram when a picture explains more than words. Only the drawing changes. The saved answer stays Markdown.
- ## Install
- On macOS or Linux:
- ```
- curl -fsSL https://intelligentui.art/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 20 on GitHub
- ```
- It installs Typst if needed, installs the mod and turns on auto-update. Then restart Claude Code. Run it again to update. [What the script does](docs/install.md#the-install-script).
- **By hand:** install [Typst](https://typst.app) 0.15 (`brew install typst`), then in Claude Code type `/plugin install cc-intelligent-ui --marketplace razorback16/cc-intelligent-ui`, and turn on auto-update in `/plugin`. [Install guide](docs/install.md).
- Needs Claude Code 2.1.298 or later. Works best in fullscreen mode (`/tui fullscreen`).
- ## Terminals
- | Terminal | Pictures |
- |---|---|
- | kitty 0.28+, Ghostty, cmux | Yes |
- | iTerm2 3.6+, herdr | Yes, after `/iui setup` (the install script does it) |
- | Rio 0.5.27+ | Yes, with `CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1` (not tested) |
- | ssh | Yes, from kitty or Ghostty |
- | Warp, WezTerm | Not yet (waiting on [warp#16312](https://github.com/warpdotdev/warp/pull/16312), [wezterm#7924](https://github.com/wezterm/wezterm/pull/7924)) |
- | tmux, screen, Terminal.app, Alacritty, VS Code, others | No: you see normal text |
- `/iui details` tells you why pictures do or do not show. [All terminal details](docs/install.md#terminals).
- 
- ## Features
- - **Rendered Markdown:** headings, tables, task lists, quotes and highlighted code, in your terminal's font.
- - **LaTeX math:** inline and display, typeset.
- - **Diagrams, charts and plots:** Claude draws them live with Typst, in your theme's colours, offline.
- - **Images and files:** images in answers, images and Markdown files that Claude sends, images that Claude reads (in the expanded row), and a preview of images you paste, above the prompt box.
- - **Copy answers as usual:** in fullscreen, drag over an answer to select and copy its text, as you do with normal text. Click a link or a file to open it (alt+click copies it); click a command to copy it. [How copy works](docs/usage.md#copy-text-from-a-picture).
- - **Readable plans:** plan mode shows the plan rendered, with approve, edit and reject.
- - **Light and dark themes:** Claude Code's colours or VS Code's, or your own.
- ## See it
- <table>
- <tr>
- <td width="50%">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="outcomes/out/6-diagrams-dark.png">
- <source media="(prefers-color-scheme: light)" srcset="outcomes/out/6-diagrams-light.png">
- <img alt="A flow chart of an agent loop and a commutative diagram of the First Isomorphism Theorem, drawn with fletcher in a Claude answer" src="outcomes/out/6-diagrams-light.png" width="100%">
- </picture>
- </td>
- <td width="50%">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="outcomes/out/2-math-dark.png">
- <source media="(prefers-color-scheme: light)" srcset="outcomes/out/2-math-light.png">
- <img alt="Typeset LaTeX math in Claude Code: the Gaussian integral, Maxwell's equations, a rotation matrix, a piecewise function, the Fourier transform and the Schrödinger equation" src="outcomes/out/2-math-light.png" width="100%">
- </picture>
- </td>
- </tr>
- </table>
- More in the [gallery](docs/gallery.md): plots, fractals and a tour of all the Markdown.
- ## Commands
- | Command | What it does |
- |---|---|
- | `/iui` | State, and what keeps pictures away |
- | `/iui on` / `off` | Pictures on or off |
- | `/iui theme <name>` | `claude-code`, `vscode-modern`, `vscode` or your own |
- | `/iui size <80–200>` | Text size, in percent |
- | `/iui setup` | Turns pictures on in iTerm2 and herdr |
- | `/iui grab` | Copies the text of your last selection of pictures |
- All commands are in [Usage](docs/usage.md).
- ## Privacy
- Nothing about you or your sessions leaves your computer. The mod makes one request a day at most, for its own public version number (`/iui updates off` stops it). It reads the clipboard only to help a copy or to find a pasted image path, skips password manager copies, and writes it only when you copy. Typst code in an answer cannot read your files. [Full details](docs/privacy.md).
- ## Docs
- [Install](docs/install.md) · [Usage](docs/usage.md) · [Themes](docs/themes.md) · [How it works](docs/how-it-works.md) · [Limitations](docs/limitations.md) · [Privacy](docs/privacy.md) · [Development](docs/development.md) · [Gallery](docs/gallery.md) · [Changelog](CHANGELOG.md)
- ## Disclaimer
- Intelligent UI is an independent project. It is not made, supported or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC.
- ## Licence
- MIT, see [`LICENSE`](LICENSE). The vendored Typst packages and the VS Code theme values keep their own licences: see [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md).
site/install.sh · Bundled script · 1,193 lines · 2 findings marked
- #!/usr/bin/env bash
- # Intelligent UI for Claude Code: the one-line installer.
- #
- # curl -fsSL https://intelligentui.art/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 4 on GitHub
- #
- # What it does (refer to docs/install.md):
- # 1. Checks the system (macOS or Linux, arm64 or x86_64) and that Claude Code is installed.
- # 2. Typst: when no Typst 0.15 or later is found, downloads the official Typst 0.15.1
- # release from GitHub, checks its SHA-256 (in this file) and puts it in ~/.local/bin.
- # 3. Adds the razorback16 marketplace and installs the mod, with the `claude plugin`
- # commands (or updates both when they are there). A razorback16 marketplace from
- # another source (a fork, a pinned ref, a local folder) is removed and added again
- # from GitHub. Another user copy of the mod (from another marketplace) is uninstalled;
- # copies in a project are not changed, only shown.
- # 4. Turns on auto-update for the razorback16 marketplace in your Claude Code
- # settings.json (extraKnownMarketplaces), with a backup of the file before that change.
- # An autoUpdate: false that you set is kept.
- # Run it again to update. It never uses sudo.
- # 5. When iTerm2 or herdr is there: adds the mod's own /iui setup block (it sets
- # CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 in iTerm2 and herdr only) to the start file of
- # your login shell, with a backup. /iui setup remove removes it.
- # Options: IUI_NO_TYPST=1 (no Typst step), IUI_NO_AUTO_UPDATE=1 (no auto-update step),
- # IUI_NO_SHELL_SETUP=1 (no shell setup step).
- # All the work is in functions, and the last line runs it: a cut download runs nothing.
- if [ -z "${BASH_VERSION:-}" ]; then
- echo "Run this script with bash: curl -fsSL https://intelligentui.art/install.sh | bash" >&2
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 27 on GitHub
- exit 1
- fi
- set -euo pipefail
- MARKETPLACE=razorback16
- MARKETPLACE_REPO=razorback16/cc-intelligent-ui
- PLUGIN_NAME=cc-intelligent-ui
- PLUGIN=cc-intelligent-ui@razorback16
- # The oldest Claude Code that the mod works with (docs/install.md).
- MIN_CLAUDE=2.1.298
- CLAUDE_SETUP_URL=https://code.claude.com/docs/en/setup
- TYPST_VERSION=0.15.1
- TYPST_MIN=0.15
- TYPST_URL=https://github.com/typst/typst/releases/download/v$TYPST_VERSION
- # Where the mod looks for Typst when it is not on the PATH, in its order
- # (TYPST_FALLBACKS in hooks/lib/settings.ts). `~` is $HOME.
- TYPST_DIRS='/opt/homebrew/bin /usr/local/bin /usr/bin /snap/bin ~/.cargo/bin ~/.local/bin /home/linuxbrew/.linuxbrew/bin ~/.linuxbrew/bin'
- # SHA-256 of the official Typst 0.15.1 release files. Computed from the files
- # downloaded from github.com/typst/typst/releases/tag/v0.15.1, and the same as
- # the `digest` of each file in the GitHub release API.
- typst_sha256() {
- case $1 in
- typst-aarch64-apple-darwin.tar.xz) echo 48f62ed034aa3a7978309579ac6ca00045e2ef0da73114e8af27cfd8e74dc05a ;;
- typst-x86_64-apple-darwin.tar.xz) echo 7f9fdd9584866245de9a79e0add8f9236fae6f40a8a45e2c4771ccc14db4e0fa ;;
- typst-aarch64-unknown-linux-musl.tar.xz) echo 5aa8d74a3d906e60ea12a66ac2f37f8eef1b14cbad7182a745e393a10c23dcee ;;
- typst-x86_64-unknown-linux-musl.tar.xz) echo a6d077d0a95eed5a2eba715b2dae06be954f624ccbf85758a03f389ded33118c ;;
- *) return 1 ;;
- esac
- }
- # Output: plain ASCII; bold headings only on a terminal.
- BOLD=
- PLAIN=
- init_output() {
- if [ -t 1 ] && [ "${TERM:-dumb}" != dumb ] && [ -z "${NO_COLOR:-}" ]; then
- BOLD=$(printf '\033[1m')
- PLAIN=$(printf '\033[0m')
- fi
- }
- say() { printf '%s\n' "$*"; }
- step() { printf '\n%s%s%s\n' "$BOLD" "$*" "$PLAIN"; }
- note() { printf ' %s\n' "$*"; }
- warn() { printf ' Warning: %s\n' "$*" >&2; }
- die() {
- printf '\nError: %s\n' "$*" >&2
- exit 1
- }
- # Shows a claude command, then runs it (stdin closed: it can not read this script).
- claude_run() {
- printf ' $ claude %s\n' "$*"
- "$CLAUDE" "$@" < /dev/null
- }
- on() { [ -n "${1:-}" ] && [ "$1" != 0 ]; }
- # The work folder, removed at the end.
- WORK=
- cleanup() { if [ -n "$WORK" ]; then rm -rf "$WORK"; fi; }
- # 0 when version $1 >= $2 (dotted numbers).
- version_ge() {
- awk -v a="$1" -v b="$2" 'BEGIN {
- n = split(a, x, "."); m = split(b, y, "."); if (m > n) n = m
- for (i = 1; i <= n; i++) { if (x[i] + 0 > y[i] + 0) exit 0; if (x[i] + 0 < y[i] + 0) exit 1 }
- exit 0 }'
- }
- # "~/..." with $HOME, for messages and paths.
- tilde() {
- case $1 in
- "$HOME"/*) printf '~%s' "${1#"$HOME"}" ;;
- *) printf '%s' "$1" ;;
- esac
- }
- # --- 1. Checks -------------------------------------------------------------
- OS=
- ARCH=
- TARGET=
- check_platform() {
- local s m
- s=$(uname -s)
- m=$(uname -m)
- case $s in
- Darwin) OS=macos TARGET=apple-darwin ;;
- Linux) OS=linux TARGET=unknown-linux-musl ;;
- *) die "this system ($s) is not supported. Intelligent UI works on macOS and Linux." ;;
- esac
- case $m in
- arm64 | aarch64) ARCH=aarch64 ;;
- x86_64 | amd64) ARCH=x86_64 ;;
- *) die "this processor ($m) is not supported. Intelligent UI works on arm64 and x86_64." ;;
- esac
- # A shell under Rosetta says x86_64 on an Apple silicon Mac.
- if [ "$OS" = macos ] && [ "$ARCH" = x86_64 ] && [ "$(sysctl -n sysctl.proc_translated 2> /dev/null || true)" = 1 ]; then
- ARCH=aarch64
- fi
- note "System: $OS, $ARCH"
- }
- CLAUDE=
- check_claude() {
- local v
- CLAUDE=$(command -v claude 2> /dev/null || true)
- if [ -z "$CLAUDE" ]; then
- # The native installer's place, when the shell has not put it on the PATH yet.
- for v in "$HOME/.local/bin/claude" "$HOME/.claude/local/claude"; do
- if [ -x "$v" ]; then
- CLAUDE=$v
- break
- fi
- done
- fi
- if [ -z "$CLAUDE" ]; then
- printf '\nError: Claude Code is not installed (no claude command on your PATH).\n' >&2
- printf 'Install Claude Code first: %s\nThen run this installer again. Nothing was changed.\n' "$CLAUDE_SETUP_URL" >&2
- exit 1
- fi
- v=$("$CLAUDE" --version < /dev/null 2> /dev/null | awk 'NR == 1 { print $1 }' || true)
- case $v in
- [0-9]*.[0-9]*.[0-9]*)
- note "Claude Code: $v ($(tilde "$CLAUDE"))"
- if ! version_ge "$v" "$MIN_CLAUDE"; then
- warn "Intelligent UI needs Claude Code $MIN_CLAUDE or later. Update Claude Code: claude update"
- fi
- ;;
- *) warn "could not read the version of Claude Code ($(tilde "$CLAUDE")). Intelligent UI needs $MIN_CLAUDE or later." ;;
- esac
- }
- # --- 2. Typst --------------------------------------------------------------
- # The version of the typst at $1 (for example 0.15.1), or nothing.
- typst_version() {
- "$1" --version < /dev/null 2> /dev/null | awk 'NR == 1 && $1 == "typst" { print $2 }' || true
- }
- # The typst that the mod uses (findTypst in hooks/lib/typst.ts): a login
- # shell's PATH (macOS puts /usr/local/bin first there), then the PATH, then
- # TYPST_DIRS in order.
- mod_typst() {
- local p
- p=$(perl -e 'alarm 5; exec @ARGV' sh -lc 'command -v typst' < /dev/null 2> /dev/null | head -n 1 || true)
- case $p in /*)
- printf '%s' "$p"
- return 0
- ;;
- esac
- find_tool typst
- }
- # The program $1: on the PATH, else in TYPST_DIRS in order.
- find_tool() {
- local p d
- p=$(command -v "$1" 2> /dev/null || true)
- case $p in /*)
- printf '%s' "$p"
- return 0
- ;;
- esac
- for d in $TYPST_DIRS; do
- case $d in \~/*) d=$HOME/${d#\~/} ;; esac
- if [ -e "$d/$1" ]; then
- printf '%s' "$d/$1"
- return 0
- fi
- done
- return 0
- }
- sha256_of() {
- if command -v sha256sum > /dev/null 2>&1; then
- sha256sum "$1" | awk '{ print $1 }'
- elif command -v shasum > /dev/null 2>&1; then
- shasum -a 256 "$1" | awk '{ print $1 }'
- else
- perl -MDigest::SHA -e 'print Digest::SHA->new(256)->addfile($ARGV[0], "b")->hexdigest' "$1"
- fi
- }
- # tar extracts .tar.xz with the xz command, or by itself (bsdtar, as on macOS).
- tar_reads_xz() {
- command -v xz > /dev/null 2>&1 && return 0
- tar --version 2> /dev/null | grep -qi bsdtar
- }
- SUM_TYPST=
- UNDO_TYPST=
- install_typst() {
- local pick v dest asset want got bin
- step "2. Typst"
- if on "${IUI_NO_TYPST:-}"; then
- note "Skipped (IUI_NO_TYPST is set)."
- SUM_TYPST="not checked (IUI_NO_TYPST is set)"
- return 0
- fi
- dest=$HOME/.local/bin/typst
- pick=$(mod_typst)
- if [ -n "$pick" ]; then
- v=$(typst_version "$pick")
- if [ -n "$v" ] && version_ge "$v" "$TYPST_MIN"; then
- note "Typst $v is installed: $(tilde "$pick"). Not changed."
- SUM_TYPST="Typst $v, $(tilde "$pick") (already installed)"
- return 0
- fi
- note "Typst ${v:-of an unknown version} is at $(tilde "$pick"). Intelligent UI needs $TYPST_MIN or later."
- fi
- v=
- if [ -x "$dest" ]; then v=$(typst_version "$dest"); fi
- if [ -n "$v" ] && version_ge "$v" "$TYPST_MIN"; then
- note "Typst $v is in $(tilde "$dest") already. Not changed."
- SUM_TYPST="Typst $v, $(tilde "$dest") (already installed)"
- else
- command -v curl > /dev/null 2>&1 || die "curl is not installed. Install curl, or install Typst $TYPST_MIN yourself (refer to https://github.com/typst/typst#installation)."
- tar_reads_xz || die "tar can not extract .tar.xz files here. Install xz (xz-utils on Debian and Ubuntu), then run this installer again."
- if [ -d "$dest" ] && [ ! -L "$dest" ]; then die "$(tilde "$dest") is a folder. Typst was not installed."; fi
- asset=typst-$ARCH-$TARGET.tar.xz
- want=$(typst_sha256 "$asset") || die "no Typst release file for $ARCH-$TARGET."
- WORK=$(mktemp -d "${TMPDIR:-/tmp}/iui-install.XXXXXX")
- note "Downloading the official Typst $TYPST_VERSION release: $TYPST_URL/$asset"
- curl -fsSL --proto '=https' --proto-redir '=https' --tlsv1.2 --retry 2 -o "$WORK/$asset" "$TYPST_URL/$asset" < /dev/null \
- || die "the download of Typst failed. Nothing was installed."
- got=$(sha256_of "$WORK/$asset")
- if [ "$got" != "$want" ]; then
- die "the SHA-256 of the downloaded Typst file is not correct (expected $want, got $got). The file was deleted, and nothing was installed."
- fi
- note "SHA-256 is correct: $got"
- mkdir "$WORK/x"
- tar -xJf "$WORK/$asset" -C "$WORK/x" < /dev/null || die "tar could not extract $asset. Nothing was installed."
- bin=$WORK/x/typst-$ARCH-$TARGET/typst
- if [ ! -f "$bin" ] || [ -L "$bin" ]; then die "no typst program in $asset. Nothing was installed."; fi
- chmod 755 "$bin"
- v=$(typst_version "$bin")
- [ "$v" = "$TYPST_VERSION" ] || die "the downloaded typst does not run here (it gave '${v}'). Nothing was installed."
- mkdir -p "$HOME/.local/bin"
- # A copy in the same folder, then one rename: never a half-written typst.
- cp "$bin" "$HOME/.local/bin/.typst.iui-$$"
- chmod 755 "$HOME/.local/bin/.typst.iui-$$"
- mv -f "$HOME/.local/bin/.typst.iui-$$" "$dest"
- note "Installed Typst $TYPST_VERSION: $(tilde "$dest")"
- SUM_TYPST="Typst $TYPST_VERSION, $(tilde "$dest") (downloaded and installed)"
- UNDO_TYPST="rm ~/.local/bin/typst"
- fi
- case ":$PATH:" in
- *":$HOME/.local/bin:"*) ;;
- *) note "Your PATH does not have ~/.local/bin. Intelligent UI finds Typst there. To run typst in a shell, add ~/.local/bin to your PATH." ;;
- esac
- pick=$(mod_typst)
- if [ -n "$pick" ] && [ "$pick" != "$dest" ]; then
- warn "Intelligent UI uses the first Typst it finds: $(tilde "$pick") (Typst $(typst_version "$pick")). Remove or update that one, or put ~/.local/bin before it in your PATH."
- fi
- }
- # --- JSON (perl) -------------------------------------------------------------
- # A small strict JSON reader that keeps the byte place of each value, so a
- # change to settings.json inserts text and keeps all other bytes. It needs
- # only core perl (no modules). Modes:
- # marketplace NAME stdin: the marketplace list (a JSON array); prints 3 lines for "name": NAME:
- # official or other, the source for `marketplace add`, and a description.
- # Exit 1: no such marketplace.
- # plugin ID stdin: the plugin list; prints the "version" and "enabled" of "id": ID, "scope": "user"
- # copies NAME stdin: the plugin list; prints "id TAB scope TAB version TAB enabled TAB projectPath"
- # for each copy of the plugin NAME (any marketplace, any scope); a copy with no
- # marketplace (@skills-dir, @inline) has its folder (installPath) for projectPath
- # entry FILE prints declared, or off (autoUpdate: false), for extraKnownMarketplaces.razorback16
- # in FILE. Exit 1: not there. Exit 2: FILE can not be read.
- # settings FILE BACKUP [OFF]
- # sets extraKnownMarketplaces.razorback16 (source and autoUpdate: true, or false with OFF)
- # in FILE; prints created, changed, unchanged or off (false already, kept).
- # Exit 2: not changed (the reason on stdout).
- # Exit 3: stdin is not a JSON array.
- json_pl() {
- cat << 'PERL'
- use strict; use warnings; no warnings 'recursion';
- use Fcntl;
- my ($mode, @args) = @ARGV;
- my $s;
- sub err { die "not valid JSON (byte " . (pos($s) // 0) . ": expected $_[0])\n" }
- sub ws { $s =~ /\G[ \t\n\r]*/gc }
- # The next byte (no zero-length match: perl allows no two at one place).
- sub peek { substr($s, pos($s), 1) eq $_[0] }
- sub str {
- $s =~ /\G"((?:[^"\\\x00-\x1f]++|\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4}))*+)"/gc or err('a string');
- my $r = $1;
- my %e = (n => "\n", t => "\t", b => "\b", f => "\f", r => "\r");
- # \u escapes as UTF-8 bytes (a pair for a character past U+FFFF), as the file's own bytes.
- $r =~ s{\\u([dD][89abAB][0-9a-fA-F]{2})\\u([dD][c-fC-F][0-9a-fA-F]{2})|\\u([0-9a-fA-F]{4})|\\(.)}
- {defined $1 ? u8(0x10000 + ((hex($1) - 0xD800) << 10) + hex($2) - 0xDC00) : defined $3 ? u8(hex $3) : ($e{$4} // $4)}ge;
- return $r;
- }
- sub u8 { my $c = chr(shift); utf8::encode($c); return $c }
- sub val {
- ws();
- my $b = pos($s);
- if ($s =~ /\G\{/gc) {
- my @m;
- ws();
- unless ($s =~ /\G\}/gc) {
- while (1) {
- ws();
- my $ks = pos($s);
- peek('"') or err('a key');
- my $k = str();
- my $ke = pos($s);
- ws();
- $s =~ /\G:/gc or err("':'");
- my $v = val();
- push @m, { k => $k, ks => $ks, ke => $ke, v => $v };
- ws();
- next if $s =~ /\G,/gc;
- last if $s =~ /\G\}/gc;
- err("',' or '}'");
- }
- }
- return { t => 'o', m => \@m, b => $b, e => pos($s) };
- }
- if ($s =~ /\G\[/gc) {
- my @l;
- ws();
- unless ($s =~ /\G\]/gc) {
- while (1) {
- push @l, val();
- ws();
- next if $s =~ /\G,/gc;
- last if $s =~ /\G\]/gc;
- err("',' or ']'");
- }
- }
- return { t => 'a', l => \@l, b => $b, e => pos($s) };
- }
- if (peek('"')) { my $x = str(); return { t => 's', s => $x, b => $b, e => pos($s) } }
- if ($s =~ /\G-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][-+]?[0-9]+)?/gc) { return { t => 'n', b => $b, e => pos($s) } }
- if ($s =~ /\G(true|false|null)/gc) { return { t => $1, b => $b, e => pos($s) } }
- err('a value');
- }
- sub parse {
- $s = $_[0];
- pos($s) = ($s =~ /^\xEF\xBB\xBF/) ? 3 : 0;
- my $v = val();
- ws();
- pos($s) == length($s) or err('the end of the file');
- return $v;
- }
- # The last member named $k (JSON.parse keeps the last one).
- sub member { my ($o, $k) = @_; my $f; for (@{ $o->{m} }) { $f = $_ if $_->{k} eq $k } return $f }
- # A string member, or undef.
- sub sv { my ($o, $k) = @_; my $m = member($o, $k); return ($m && $m->{v}{t} eq 's') ? $m->{v}{s} : undef }
- # No control bytes (for the shell's messages); other bytes, such as UTF-8 letters, are kept.
- sub clean { my $x = shift // ''; $x =~ s/[\x00-\x1f\x7f]|\xc2[\x80-\x9f]//g; return $x }
- # 1 when a source (an object with source, repo, url, ref, path) is the official
- # one: GitHub razorback16/cc-intelligent-ui, with no ref, path or sparse paths.
- sub official {
- my $o = shift;
- for my $k (qw(ref path)) { my $x = sv($o, $k); return 0 if defined $x && $x ne '' }
- return 0 if member($o, 'sparsePaths');
- my $kind = sv($o, 'source') // '';
- my $repo = sv($o, 'repo') // '';
- my $url = sv($o, 'url') // '';
- return 1 if $kind eq 'github' && lc($repo) eq 'razorback16/cc-intelligent-ui';
- return 1 if $kind eq 'git' && $url =~ m{\Ahttps://github\.com/razorback16/cc-intelligent-ui(?:\.git)?\z}i;
- return 0;
- }
- if ($mode eq 'marketplace' || $mode eq 'plugin' || $mode eq 'copies') {
- local $/; my $in = <STDIN> // '';
- my $v = eval { parse($in) } or exit 3;
- exit 3 unless $v->{t} eq 'a';
- for my $x (@{ $v->{l} }) {
- next unless $x->{t} eq 'o';
- if ($mode eq 'marketplace') {
- next unless (sv($x, 'name') // '') eq $args[0];
- my ($kind, $ref, $path) = map { clean(sv($x, $_)) } qw(source ref path);
- my ($spec, $desc);
- if ($kind eq 'github' || $kind eq 'git') {
- my $at = clean(sv($x, $kind eq 'git' ? 'url' : 'repo'));
- $spec = $at . ($ref ne '' ? "#$ref" : '');
- $desc = ($kind eq 'git' ? "the git URL $at" : "the GitHub repository $at") . ($ref ne '' ? " (ref $ref)" : '') . ($path ne '' ? " (folder $path)" : '');
- } elsif ($kind eq 'directory' || $kind eq 'file') {
- $spec = $path;
- $desc = ($kind eq 'file' ? 'the local file ' : 'the local folder ') . $path;
- } elsif ($kind eq 'url') {
- $spec = clean(sv($x, 'url'));
- $desc = "the URL $spec";
- } else {
- $spec = '';
- $desc = "a source of the type '$kind'";
- }
- print official($x) ? 'official' : 'other', "\n$spec\n$desc\n";
- exit 0;
- }
- my ($id, $sc, $ver, $en) = map { member($x, $_) } qw(id scope version enabled);
- next unless $id && $id->{v}{t} eq 's';
- my $vs = ($ver && $ver->{v}{t} eq 's') ? $ver->{v}{s} : '?';
- $vs =~ s/[^\x21-\x7e]//g;
- my $state = ($en && $en->{v}{t} eq 'false') ? 'disabled' : 'enabled';
- if ($mode eq 'plugin') {
- next unless $id->{v}{s} eq $args[0];
- next unless $sc && $sc->{v}{t} eq 's' && $sc->{v}{s} eq 'user';
- print $vs eq '' ? '?' : $vs, " $state\n";
- exit 0;
- }
- # copies: only ids that are safe to give to `claude plugin`.
- next unless $id->{v}{s} =~ /\A\Q$args[0]\E\@[A-Za-z0-9._-]+\z/;
- my $scope = clean(sv($x, 'scope'));
- $scope = '?' unless $scope =~ /\A[a-z]+\z/;
- my $where = sv($x, $id->{v}{s} =~ /\@(?:skills-dir|inline)\z/ ? 'installPath' : 'projectPath');
- print join("\t", $id->{v}{s}, $scope, $vs eq '' ? '?' : $vs, $state, clean($where)), "\n";
- }
- exit($mode eq 'copies' ? 0 : 1);
- }
- my $name = 'razorback16';
- if ($mode eq 'entry') {
- my $f = $args[0];
- exit 1 unless -e $f;
- open(my $fh, '<:raw', $f) or exit 2;
- local $/; my $t = <$fh> // ''; close $fh;
- exit 1 if $t =~ /\A\s*\z/;
- my $root = eval { parse($t) } or exit 2;
- exit 2 unless $root->{t} eq 'o';
- my $ekm = member($root, 'extraKnownMarketplaces');
- exit 1 unless $ekm && $ekm->{v}{t} eq 'o';
- my $rb = member($ekm->{v}, $name) or exit 1;
- my $au = $rb->{v}{t} eq 'o' ? member($rb->{v}, 'autoUpdate') : undef;
- print $au && $au->{v}{t} eq 'false' ? "off\n" : "declared\n";
- exit 0;
- }
- exit 4 unless $mode eq 'settings';
- my ($file, $bak, $off) = @args;
- my $want = $off ? 'false' : 'true';
- my @source = ([source => '"github"'], [repo => '"razorback16/cc-intelligent-ui"']);
- sub refuse { print "$_[0]\n"; exit 2 }
- my $real = $file;
- if (-l $file) {
- require Cwd;
- $real = Cwd::realpath($file);
- refuse("$file is a link to a file that is not there") unless defined $real && -e $real;
- }
- my ($old, $text);
- if (-e $real) {
- refuse("$file is not a file") unless -f $real;
- open(my $fh, '<:raw', $real) or refuse("can not read $file: $!");
- local $/; $old = <$fh> // ''; close $fh;
- }
- # Writes: a new file in the same folder, then one rename.
- sub put {
- my ($path, $data, $fmode, $then) = @_;
- my $tmp = "$path.iui-$$";
- unlink $tmp;
- sysopen(my $fh, $tmp, O_WRONLY | O_CREAT | O_EXCL, defined $fmode ? 0600 : 0666) or die "can not write $tmp: $!\n";
- binmode $fh;
- unless ((print {$fh} $data) && close $fh) { my $e = $!; unlink $tmp; die "can not write $tmp: $e\n" }
- chmod($fmode, $tmp) if defined $fmode;
- # The backup only when the new file is written.
- if ($then) { eval { $then->(); 1 } or do { unlink $tmp; die $@ } }
- rename($tmp, $path) or do { my $e = $!; unlink $tmp; die "can not write $path: $e\n" };
- }
- # A file that is not writable, or one with more names (hard links), is not replaced.
- sub writable {
- my $nl = (stat $real)[3];
- refuse("$file is not writable") unless -w $real;
- refuse("$file has $nl hard links, and a new file would break them") if $nl > 1;
- }
- # The line end of the file (CRLF kept).
- our $NL = (defined $old && $old =~ /\r\n/) ? "\r\n" : "\n";
- # JSON text for a value: [key, value] lists are objects, a string is raw JSON.
- sub render {
- my ($v, $ind, $unit, $multi, $kv) = @_;
- return $v unless ref $v;
- my @p = map { '"' . $_->[0] . '"' . $kv . render($_->[1], $ind . $unit, $unit, $multi, $kv) } @$v;
- return $multi ? "{$NL" . join(",$NL", map { "$ind$unit$_" } @p) . "$NL$ind}" : '{' . join($kv eq ':' ? ',' : ', ', @p) . '}';
- }
- my $out;
- if (!defined $old || $old =~ /\A\s*\z/) {
- $text = render([[extraKnownMarketplaces => [[$name => [[source => \@source], [autoUpdate => $want]]]]]], '', ' ', 1, ': ') . "\n";
- $out = defined $old ? 'changed' : 'created';
- } else {
- my $root = eval { parse($old) };
- unless ($root) { chomp(my $why = $@); refuse("$file is $why") }
- refuse("$file is not a JSON object") unless $root->{t} eq 'o';
- my $lineind = sub { my $p = shift; my $l = rindex($old, "\n", $p - 1) + 1; substr($old, $l) =~ /^([ \t]*)/; $1 };
- my $nl = ($old =~ /\n/);
- my ($unit, $kv) = (' ', ': ');
- if (@{ $root->{m} }) {
- my $f = $root->{m}[0];
- my $gap = substr($old, $root->{b} + 1, $f->{ks} - $root->{b} - 1);
- $unit = $1 if $gap =~ /\n([ \t]+)\z/;
- $kv = (substr($old, $f->{ke}, $f->{v}{b} - $f->{ke}) =~ / /) ? ': ' : ':';
- } elsif (!$nl) {
- $kv = ':';
- }
- # Each change: [begin, end, new text].
- my @edits;
- my $add = sub {
- my ($o, @members) = @_;
- my $li = $lineind->($o->{b});
- if (@{ $o->{m} }) {
- my $f = $o->{m}[0];
- my $l = $o->{m}[-1];
- my $gap = substr($old, $o->{b} + 1, $f->{ks} - $o->{b} - 1);
- my $okv = (substr($old, $f->{ke}, $f->{v}{b} - $f->{ke}) =~ / /) ? ': ' : ':';
- if ($gap =~ /\n([ \t]*)\z/) {
- my $mi = $1;
- my $u = (length($mi) > length($li) && substr($mi, 0, length $li) eq $li) ? substr($mi, length $li) : $unit;
- push @edits, [$l->{v}{e}, $l->{v}{e}, join('', map { ",$NL$mi\"$_->[0]\"$okv" . render($_->[1], $mi, $u, 1, $okv) } @members)];
- } else {
- my $sep = $okv eq ':' ? ',' : ', ';
- push @edits, [$l->{v}{e}, $l->{v}{e}, join('', map { "$sep\"$_->[0]\"$okv" . render($_->[1], '', '', 0, $okv) } @members)];
- }
- } else {
- push @edits, [$o->{b}, $o->{e}, render(\@members, $li, $unit, $nl ? 1 : 0, $kv)];
- }
- };
- my $ekm = member($root, 'extraKnownMarketplaces');
- if (!$ekm) {
- $add->($root, [extraKnownMarketplaces => [[$name => [[source => \@source], [autoUpdate => $want]]]]]);
- } elsif ($ekm->{v}{t} ne 'o') {
- refuse("extraKnownMarketplaces in $file is not an object");
- } else {
- my $rb = member($ekm->{v}, $name);
- if (!$rb) {
- $add->($ekm->{v}, [$name => [[source => \@source], [autoUpdate => $want]]]);
- } elsif ($rb->{v}{t} ne 'o') {
- refuse("extraKnownMarketplaces.$name in $file is not an object");
- } else {
- my $src = member($rb->{v}, 'source');
- refuse("extraKnownMarketplaces.$name in $file has another source, not the GitHub repository razorback16/cc-intelligent-ui")
- if $src && !($src->{v}{t} eq 'o' && official($src->{v}));
- my $au = member($rb->{v}, 'autoUpdate');
- if ($au && $au->{v}{t} eq 'true') { print "unchanged\n"; exit 0 }
- # Off by the person's choice (Disable auto-update): kept.
- if ($au && $au->{v}{t} eq 'false') { print "off\n"; exit 0 }
- if ($au) {
- push @edits, [$au->{v}{b}, $au->{v}{e}, $want];
- } else {
- $add->($rb->{v}, (member($rb->{v}, 'source') ? () : [source => \@source]), [autoUpdate => $want]);
- }
- }
- }
- $text = $old;
- for my $e (sort { $b->[0] <=> $a->[0] } @edits) { substr($text, $e->[0], $e->[1] - $e->[0]) = $e->[2] }
- $out = 'changed';
- }
- # The new text must read back with the entry set.
- my $check = eval { parse($text) };
- my $ok = $check && $check->{t} eq 'o';
- for my $k ('extraKnownMarketplaces', $name, 'autoUpdate') {
- last unless $ok;
- my $m = member($check, $k);
- $ok = $m && ($k eq 'autoUpdate' ? $m->{v}{t} eq $want : $m->{v}{t} eq 'o');
- $check = $m->{v} if $ok;
- }
- refuse("the change of $file did not read back (nothing was written)") unless $ok;
- writable() if defined $old;
- my $fmode = defined $old ? (stat $real)[2] & 07777 : undef;
- eval {
- put($real, $text, $fmode, defined $old ? sub { put($bak, $old, $fmode) } : undef);
- 1;
- } or do { chomp(my $why = $@); refuse($why) };
- print "$out\n";
- PERL
- }
- # LC_ALL=C: no perl locale warnings (a LANG that is not installed).
- json() { LC_ALL=C perl -e "$(json_pl)" "$@"; }
- # --- 3. The mod ----------------------------------------------------------------
- SUM_PLUGIN=
- COPIES=
- # Undo lines of step 3 that are not always there (one per line).
- UNDO_MORE=
- TAB=$(printf '\t')
- # $1 quoted for a shell command line, when it needs quotes.
- shq() {
- case $1 in
- '' | *[!A-Za-z0-9_./:@#%+=,-]*) printf "'%s'" "$(printf '%s' "$1" | sed "s/'/'\\\\''/g")" ;;
- *) printf '%s' "$1" ;;
- esac
- }
- # The version in a plugin_state line, or "?".
- ver_of() {
- local v=${1%% *}
- printf '%s' "${v:-?}"
- }
- # "VERSION enabled|disabled" of the mod in user scope, or nothing.
- plugin_state() {
- "$CLAUDE" plugin list --json < /dev/null 2> /dev/null | json plugin "$PLUGIN" 2> /dev/null || true
- }
- # Each copy of the mod, from any marketplace, in any scope (lines of
- # id, scope, version, enabled and projectPath, with tabs).
- plugin_copies() {
- "$CLAUDE" plugin list --json < /dev/null 2> /dev/null | json copies "$PLUGIN_NAME" 2> /dev/null || true
- }
- # The razorback16 marketplace. MKT_KIND: official, other (another source:
- # MKT_SPEC and MKT_DESC tell which), none (not known) or unknown (no JSON list).
- MKT_KIND=
- MKT_SPEC=
- MKT_DESC=
- marketplace_source() {
- local out info rc=0
- MKT_KIND=unknown
- if out=$("$CLAUDE" plugin marketplace list --json < /dev/null 2> /dev/null); then
- info=$(printf '%s' "$out" | json marketplace "$MARKETPLACE" 2> /dev/null) || rc=$?
- case $rc in
- 0)
- {
- IFS= read -r MKT_KIND
- IFS= read -r MKT_SPEC
- IFS= read -r MKT_DESC
- } << INFO || true
- $info
- INFO
- return 0
- ;;
- 1)
- MKT_KIND=none
- return 0
- ;;
- esac
- fi
- # No JSON: the text list. The source is not known.
- if ! "$CLAUDE" plugin marketplace list < /dev/null 2> /dev/null | grep -qw "$MARKETPLACE"; then MKT_KIND=none; fi
- }
- # The user settings file of Claude Code.
- settings_file() { printf '%s/settings.json' "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"; }
- # The razorback16 entry of the user settings: none, declared, off (autoUpdate
- # false) or unknown (the file can not be read).
- user_entry() {
- local f out rc=0
- f=$(settings_file)
- case $f in /*) ;; *)
- printf unknown
- return 0
- ;;
- esac
- out=$(json entry "$f" 2> /dev/null) || rc=$?
- case $rc in
- 0) printf '%s' "$out" ;;
- 1) printf none ;;
- *) printf unknown ;;
- esac
- }
- # The marketplace has another source (a fork, a pinned ref, a local folder):
- # an update from it can not get the newest version. Remove its entry in the
- # user settings, then add the official one. Claude Code can uninstall the mod
- # with the marketplace; if it does, the installer installs it again.
- OLD_STATE=
- REPOINTED=
- AUTO_OFF=
- repoint_marketplace() {
- local id scope ver pp undo entry
- warn "the $MARKETPLACE marketplace comes from $MKT_DESC, not from the GitHub repository $MARKETPLACE_REPO. An update from there can not get the newest version of the mod."
- note "So the installer adds the $MARKETPLACE marketplace again from $MARKETPLACE_REPO."
- note "Claude Code can uninstall the mod with the old marketplace; if it does, the installer installs it again."
- note "Kept: your /iui settings (Claude Code keeps them under the name $PLUGIN). The mod has no other saved options, secrets or data."
- OLD_STATE=$(plugin_state)
- entry=$(user_entry)
- # Auto-update that you turned off stays off for the new source.
- if [ "$entry" = off ]; then AUTO_OFF=1; fi
- while IFS=$TAB read -r id scope ver _ pp; do
- if [ "$id" = "$PLUGIN" ] && [ "$scope" != user ]; then
- note "Claude Code can also remove the copy of the mod in $scope scope for ${pp:-a project}."
- fi
- done << COPIES
- $COPIES
- COPIES
- if [ -n "$MKT_SPEC" ]; then
- undo="claude plugin marketplace remove $MARKETPLACE, then claude plugin marketplace add $(shq "$MKT_SPEC")"
- else
- undo="claude plugin marketplace remove $MARKETPLACE, then add $MKT_DESC again"
- fi
- # `remove --scope user` fails when the user settings do not declare it (an
- # older Claude Code, or another scope); then `add` changes its source by itself.
- if [ "$entry" = none ]; then
- note "Your user settings do not declare the $MARKETPLACE marketplace, so claude plugin marketplace add changes its source."
- if ! claude_run plugin marketplace add "$MARKETPLACE_REPO"; then
- die "Claude Code could not add the marketplace $MARKETPLACE_REPO. The old marketplace was not changed. The mod was not updated."
- fi
- else
- claude_run plugin marketplace remove "$MARKETPLACE" --scope user || die "Claude Code could not remove the marketplace $MARKETPLACE (from $MKT_DESC). The mod was not updated."
- if ! claude_run plugin marketplace add "$MARKETPLACE_REPO"; then
- die "Claude Code could not add the marketplace $MARKETPLACE_REPO. To add the old one back: claude plugin marketplace add $(shq "${MKT_SPEC:-?}")"
- fi
- fi
- note "The $MARKETPLACE marketplace comes from $MARKETPLACE_REPO now (before: $MKT_DESC)."
- REPOINTED=1
- UNDO_MORE="${UNDO_MORE}Old source: $undo
- "
- }
- # A copy that is in $2 (copies lines) with the id, scope and path of line $1.
- copy_in() {
- local id scope pp i s p
- IFS=$TAB read -r id scope _ _ pp << LINE
- $1
- LINE
- while IFS=$TAB read -r i s _ _ p; do
- if [ "$i" = "$id" ] && [ "$s" = "$scope" ] && [ "$p" = "$pp" ]; then return 0; fi
- done << LIST
- $2
- LIST
- return 1
- }
- install_plugin() {
- local before after rc=0 mkt_ok=1 now line id scope ver pp old new
- step "3. The mod: $PLUGIN"
- COPIES=$(plugin_copies)
- marketplace_source
- case $MKT_KIND in
- none) claude_run plugin marketplace add "$MARKETPLACE_REPO" || die "Claude Code could not add the marketplace $MARKETPLACE_REPO." ;;
- other) repoint_marketplace ;;
- *)
- if ! claude_run plugin marketplace update "$MARKETPLACE"; then
- mkt_ok=
- warn "the marketplace update failed. The mod is updated from the copy of the marketplace that Claude Code has, which can be old."
- fi
- ;;
- esac
- before=$(plugin_state)
- if [ -n "$before" ]; then
- claude_run plugin update "$PLUGIN" --scope user || rc=$?
- after=$(plugin_state)
- if [ "$rc" != 0 ]; then
- warn "the update of the mod failed. The installed version ($(ver_of "$after")) stays."
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (NOT updated: the update failed, refer to the warning above)"
- PROBLEM=1
- elif [ "$(ver_of "$after")" != "$(ver_of "$before")" ]; then
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (updated from $(ver_of "$before"))"
- elif [ -z "$mkt_ok" ]; then
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (NOT checked for a newer version: the marketplace update failed)"
- PROBLEM=1
- elif [ "$MKT_KIND" = unknown ]; then
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (no newer version found)"
- else
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (the newest version was installed already)"
- fi
- else
- claude_run plugin install "$PLUGIN" --scope user || die "Claude Code could not install $PLUGIN."
- after=$(plugin_state)
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (installed)"
- fi
- if [ -n "$REPOINTED" ] && [ "$rc" = 0 ]; then
- SUM_PLUGIN="$PLUGIN_NAME $(ver_of "$after") (from $MARKETPLACE_REPO now; before: $(ver_of "$OLD_STATE") from $MKT_DESC)"
- # A local folder can have a version that is not released yet.
- old=$(ver_of "$OLD_STATE")
- new=$(ver_of "$after")
- if [ "$old" != '?' ] && [ "$new" != '?' ] && [ "$old" != "$new" ] && version_ge "$old" "$new"; then
- warn "the version from the old source ($old) is newer than the version on GitHub ($new). To use the old source again: $(printf '%s' "$UNDO_MORE" | sed -n 's/^Old source: *//p')"
- fi
- fi
- # A mod that was disabled before the new marketplace stays disabled.
- case $OLD_STATE:$after in
- *' disabled:'*' enabled')
- claude_run plugin disable "$PLUGIN" --scope user || warn "Claude Code could not disable the mod again."
- after=$(plugin_state)
- ;;
- esac
- case $after in
- *' disabled') warn "the mod is disabled in Claude Code. To turn it on: claude plugin enable $PLUGIN" ;;
- esac
- now=$(plugin_copies)
- # A copy with no marketplace: Claude Code can not uninstall it.
- while IFS=$TAB read -r id scope ver _ pp; do
- case $id in
- *@skills-dir) warn "a copy of the mod is in a skills folder of Claude Code ($(tilde "${pp:-${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills}")): $id $ver. It has no marketplace, so Claude Code can not uninstall it. The copy from $MARKETPLACE is used, not that one. To remove it, delete its folder (claude plugin list shows it)." ;;
- *@inline) warn "a copy of the mod is loaded with --plugin-dir${pp:+ from $pp}: $id $ver. Claude Code can not uninstall it. To stop it, start Claude Code without that --plugin-dir." ;;
- esac
- done << NOW
- $now
- NOW
- # Another copy in user scope (from another marketplace) would run too.
- if [ -n "$after" ]; then
- while IFS=$TAB read -r id scope ver _ pp; do
- case $id in '' | "$PLUGIN" | *@skills-dir | *@inline) continue ;; esac
- [ "$scope" = user ] || continue
- note "Another copy of the mod is installed for your user: $id $ver. Two copies would both run, so the installer uninstalls that one."
- if claude_run plugin uninstall "$id" --scope user; then
- note "Uninstalled $id. Its /iui settings are kept under its own name; set them again with /iui if you want."
- UNDO_MORE="${UNDO_MORE}Other copy: claude plugin install $id --scope user
- "
- else
- warn "Claude Code could not uninstall $id. Two copies of the mod run. To remove it: claude plugin uninstall $id --scope user"
- PROBLEM=1
- fi
- done << NOW
- $now
- NOW
- now=$(plugin_copies)
- fi
- # Copies in a project: not changed. In that folder, they can hide the user copy.
- while IFS=$TAB read -r id scope ver _ pp; do
- case $scope in '' | user) continue ;; esac
- case $id in *@skills-dir | *@inline) continue ;; esac
- warn "a copy of the mod is installed in $scope scope for ${pp:-a project}: $id $ver. In that project it can be used instead of the version above. To remove it: cd $(shq "${pp:-.}") && claude plugin uninstall $id --scope $scope"
- done << NOW
- $now
- NOW
- # Copies that Claude Code removed with the old marketplace.
- if [ -n "$REPOINTED" ]; then
- while IFS= read -r line; do
- IFS=$TAB read -r id scope _ _ pp << LINE
- $line
- LINE
- case $scope in '' | user) continue ;; esac
- [ "$id" = "$PLUGIN" ] || continue
- copy_in "$line" "$now" && continue
- warn "Claude Code removed the copy of the mod in $scope scope for ${pp:-a project} with the old marketplace. To install it there again: cd $(shq "${pp:-.}") && claude plugin install $PLUGIN --scope $scope"
- done << COPIES
- $COPIES
- COPIES
- fi
- }
- # --- 4. Auto-update ------------------------------------------------------------
- SUM_AUTO=
- AUTO_ON=
- UNDO_AUTO=
- PROBLEM=
- manual_auto_update() {
- say " To turn on auto-update yourself: in Claude Code, type /plugin, go to Marketplaces," >&2
- say " select $MARKETPLACE, then select Enable auto-update. Or add this to $1:" >&2
- cat >&2 << EOF
- "extraKnownMarketplaces": {
- "$MARKETPLACE": {
- "source": { "source": "github", "repo": "$MARKETPLACE_REPO" },
- "autoUpdate": true
- }
- }
- EOF
- }
- # Auto-update turned on: $1 is created or changed, $2 the file.
- auto_on() {
- AUTO_ON=1
- if [ "$1" = created ]; then
- note "Made $(tilde "$2") with extraKnownMarketplaces.$MARKETPLACE.autoUpdate = true."
- SUM_AUTO="on ($(tilde "$2"), new file)"
- return 0
- fi
- note "Set extraKnownMarketplaces.$MARKETPLACE.autoUpdate = true in $(tilde "$2")."
- note "All other settings are kept. The file before this auto-update change: $(tilde "$2").bak-iui"
- note "(It has the changes of step 3 already: the backup undoes only the auto-update change.)"
- SUM_AUTO="on ($(tilde "$2"))"
- UNDO_AUTO="copy $(tilde "$2").bak-iui (the file before the auto-update change only) back to $(tilde "$2")"
- }
- auto_update() {
- local dir file result rc t
- step "4. Auto-update for the $MARKETPLACE marketplace"
- if on "${IUI_NO_AUTO_UPDATE:-}"; then
- note "Skipped (IUI_NO_AUTO_UPDATE is set)."
- SUM_AUTO="not changed (IUI_NO_AUTO_UPDATE is set)"
- return 0
- fi
- dir=${CLAUDE_CONFIG_DIR:-$HOME/.claude}
- file=$(settings_file)
- case $dir in
- /*) ;;
- *)
- warn "CLAUDE_CONFIG_DIR ($dir) is not an absolute path, so the settings file is not known. Nothing was changed."
- manual_auto_update "your settings.json"
- SUM_AUTO="NOT turned on (refer to the warning above)"
- PROBLEM=1
- return 0
- ;;
- esac
- if ! command -v perl > /dev/null 2>&1; then
- warn "perl is not installed, so $(tilde "$file") was not changed."
- manual_auto_update "$(tilde "$file")"
- SUM_AUTO="NOT turned on (refer to the warning above)"
- PROBLEM=1
- return 0
- fi
- if [ ! -e "$file" ] && [ ! -L "$file" ]; then mkdir -p "$dir"; fi
- rc=0
- # Only stdout is the result; perl's stderr goes to the screen.
- result=$(json settings "$file" "$file.bak-iui" ${AUTO_OFF:+off}) || rc=$?
- t="~"
- result=${result//"$HOME"/$t}
- case $rc:$result in
- 0:unchanged)
- note "Auto-update is on already ($(tilde "$file")). Not changed."
- SUM_AUTO="on (it was on already)"
- AUTO_ON=1
- ;;
- 0:off)
- note "Auto-update is off: you turned it off (extraKnownMarketplaces.$MARKETPLACE.autoUpdate = false in $(tilde "$file")). Not changed."
- SUM_AUTO="off (your choice; not changed)"
- ;;
- 0:created | 0:changed)
- if [ -z "$AUTO_OFF" ]; then
- auto_on "$result" "$file"
- else
- note "Auto-update stays off for the new source, as you set it: extraKnownMarketplaces.$MARKETPLACE.autoUpdate = false in $(tilde "$file")."
- if [ "$result" = changed ]; then note "The file before this change: $(tilde "$file").bak-iui"; fi
- SUM_AUTO="off (your choice; kept for the new source)"
- fi
- ;;
- *)
- warn "$(tilde "$file") was not changed: ${result:-an unknown error}"
- manual_auto_update "$(tilde "$file")"
- SUM_AUTO="NOT turned on (refer to the warning above)"
- PROBLEM=1
- ;;
- esac
- }
- # --- 5. Pictures in iTerm2 and herdr -------------------------------------------
- # The mod's own setup block (SETUP_START, SETUP_END and setupBlock() of
- # hooks/lib/setup.ts, byte for byte): Claude Code shows pictures in iTerm2 and
- # herdr only with CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 when it starts. The mod's
- # /iui setup sees this block as done, and /iui setup remove removes it.
- SETUP_START='# >>> cc-intelligent-ui: Claude Code pictures in iTerm2 >>>'
- SETUP_END='# <<< cc-intelligent-ui <<<'
- # shellcheck disable=SC2016 # the shell reads these lines later, not now
- SETUP_SH='if { [ "$TERM_PROGRAM" = "iTerm.app" ] || [ "$TERM_PROGRAM" = "herdr" ]; } && [ -z "$TMUX" ] && [ -z "$STY" ]; then export CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1; fi'
- # shellcheck disable=SC2016
- SETUP_FISH='if test "$TERM_PROGRAM" = "iTerm.app" -o "$TERM_PROGRAM" = "herdr"; and not set -q TMUX; and not set -q STY; set -gx CLAUDE_CODE_FORCE_TERMINAL_IMAGES 1; end'
- # Puts the block in a start file as the mod's withSetup() does: an older block
- # of the mod is replaced, one blank line goes before the block, and the exact
- # block already there changes nothing. Args: FILE START LINE END BACKUP. A link
- # keeps its place and its file changes. Prints created, changed (block added),
- # updated (an older block replaced) or unchanged. Exit 2: not changed (the reason on stdout).
- setup_pl() {
- cat << 'PERL'
- use strict; use warnings;
- use Fcntl;
- my ($file, $start, $line, $end, $bak) = @ARGV;
- sub refuse { print "$_[0]\n"; exit 2 }
- my $real = $file;
- if (-l $file) {
- require Cwd;
- $real = Cwd::realpath($file);
- refuse("$file is a link to a file that is not there") unless defined $real && -e $real;
- }
- my $old;
- if (-e $real) {
- refuse("$file is not a regular file") unless -f $real;
- refuse("$file is larger than 4 MB") if -s $real > 4 * 1024 * 1024;
- open(my $fh, '<:raw', $real) or refuse("can not read $file: $!");
- local $/; $old = <$fh>; close $fh;
- refuse("can not read $file") unless defined $old;
- }
- my $text = $old // '';
- my $block = "$start\n$line\n$end\n";
- if (index($text, $block) >= 0) { print "unchanged\n"; exit 0 }
- # withoutSetup(): each START ... END block goes, with one blank line before it.
- my @lines = split /\n/, $text, -1;
- my @out;
- my $replaced = 0;
- for (my $i = 0; $i < @lines; $i++) {
- if ($lines[$i] ne $start) { push @out, $lines[$i]; next }
- my $e = -1;
- for my $j ($i .. $#lines) { if ($lines[$j] eq $end) { $e = $j; last } }
- if ($e < 0) { push @out, $lines[$i]; next }
- pop @out if @out && $out[-1] eq '';
- $i = $e;
- $replaced++;
- }
- my $base = join("\n", @out);
- $base =~ s/\n*\z//;
- my $new = $base . ($base ne '' ? "\n\n" : '') . $block;
- # Writes: a new file in the same folder, then one rename.
- sub put {
- my ($path, $data, $fmode, $then) = @_;
- my $tmp = "$path.iui-$$";
- unlink $tmp;
- sysopen(my $fh, $tmp, O_WRONLY | O_CREAT | O_EXCL, defined $fmode ? 0600 : 0666) or die "can not write $tmp: $!\n";
- binmode $fh;
- unless ((print {$fh} $data) && close $fh) { my $e = $!; unlink $tmp; die "can not write $tmp: $e\n" }
- chmod($fmode, $tmp) if defined $fmode;
- # The backup only when the new file is written.
- if ($then) { eval { $then->(); 1 } or do { unlink $tmp; die $@ } }
- rename($tmp, $path) or do { my $e = $!; unlink $tmp; die "can not write $path: $e\n" };
- }
- # A file that is not writable, or one with more names (hard links), is not replaced.
- if (defined $old) {
- my $nl = (stat $real)[3];
- refuse("$file is not writable") unless -w $real;
- refuse("$file has $nl hard links, and a new file would break them") if $nl > 1;
- }
- my $fmode = defined $old ? (stat $real)[2] & 07777 : undef;
- eval {
- put($real, $new, $fmode, defined $old ? sub { put($bak, $old, $fmode) } : undef);
- 1;
- } or do { chomp(my $why = $@); refuse($why) };
- print !defined $old ? "created\n" : $replaced ? "updated\n" : "changed\n";
- PERL
- }
- # 0 when iTerm2 is installed (macOS). IUI_TEST_ROOT is only for the tests.
- has_iterm() {
- local p
- [ "$OS" = macos ] || return 1
- for p in "${IUI_TEST_ROOT:-}/Applications/iTerm.app" "$HOME/Applications/iTerm.app"; do
- if [ -d "$p" ]; then return 0; fi
- done
- command -v mdfind > /dev/null 2>&1 || return 1
- # Spotlight, stopped after 5 s.
- p=$(perl -e 'alarm 5; exec @ARGV' mdfind "kMDItemCFBundleIdentifier == 'com.googlecode.iterm2'" < /dev/null 2> /dev/null | grep -m 1 '\.app$' || true)
- [ -n "$p" ]
- }
- SUM_SHELL=
- UNDO_SHELL=
- shell_setup() {
- local apps='' name file kind line result rc t f
- step "5. Pictures in iTerm2 and herdr"
- if on "${IUI_NO_SHELL_SETUP:-}"; then
- note "Skipped (IUI_NO_SHELL_SETUP is set)."
- SUM_SHELL="not changed (IUI_NO_SHELL_SETUP is set)"
- return 0
- fi
- if has_iterm; then apps=iTerm2; fi
- if [ -n "$(find_tool herdr)" ]; then apps=${apps:+$apps and }herdr; fi
- if [ -z "$apps" ]; then
- note "No iTerm2 or herdr found. Not needed: other terminals need no setup."
- SUM_SHELL="not needed (no iTerm2 or herdr)"
- return 0
- fi
- note "$apps found. Claude Code shows pictures there only with CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1."
- # The start file of the login shell, as the mod's shellRcOf() picks it.
- name=${SHELL:-}
- name=${name##*/}
- case $name in
- zsh) file=${ZDOTDIR:-$HOME}/.zshrc kind='sh' ;;
- bash)
- kind='sh'
- file=$HOME/.bashrc
- if [ "$OS" = macos ]; then
- # Login bash reads only the first of these that exists: a new .bash_profile would hide the others.
- file=$HOME/.bash_profile
- for f in .bash_profile .bash_login .profile; do
- if [ -e "$HOME/$f" ] || [ -L "$HOME/$f" ]; then
- file=$HOME/$f
- break
- fi
- done
- fi
- ;;
- fish) file=${XDG_CONFIG_HOME:-$HOME/.config}/fish/conf.d/cc-intelligent-ui.fish kind='fish' ;;
- *)
- note "Your shell (${name:-not known}) is not one that the mod knows, so no file was changed."
- note "Add this to your shell's start file: export CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 (only in iTerm2 and herdr, not in tmux or screen)"
- SUM_SHELL="NOT added (your shell is not known; refer to the lines above)"
- return 0
- ;;
- esac
- if [ "$kind" = fish ]; then line=$SETUP_FISH; else line=$SETUP_SH; fi
- if ! command -v perl > /dev/null 2>&1; then
- result="perl is not installed"
- rc=2
- else
- if [ "$kind" = fish ] && [ ! -e "$file" ] && [ ! -L "$file" ]; then mkdir -p "${file%/*}"; fi
- rc=0
- # Only stdout is the result (LC_ALL=C: no perl locale warnings).
- result=$(LC_ALL=C perl -e "$(setup_pl)" "$file" "$SETUP_START" "$line" "$SETUP_END" "$file.bak-iui") || rc=$?
- fi
- t="~"
- result=${result//"$HOME"/$t}
- case $rc:$result in
- 0:unchanged)
- note "$(tilde "$file") has the Intelligent UI block already. Not changed."
- SUM_SHELL="set already in $(tilde "$file")"
- ;;
- 0:created)
- note "Made $(tilde "$file") with the Intelligent UI block."
- SUM_SHELL="added to $(tilde "$file") (open a new tab or pane)"
- ;;
- 0:changed)
- note "Added the Intelligent UI block to $(tilde "$file")."
- note "The file before this change: $(tilde "$file").bak-iui"
- SUM_SHELL="added to $(tilde "$file") (open a new tab or pane)"
- ;;
- 0:updated)
- note "Updated the Intelligent UI block in $(tilde "$file") (an older block of the mod is replaced)."
- note "The file before this change: $(tilde "$file").bak-iui"
- SUM_SHELL="updated in $(tilde "$file") (open a new tab or pane)"
- ;;
- *)
- warn "$(tilde "$file") was not changed: ${result:-an unknown error}"
- say " To set it yourself, add these lines to $(tilde "$file"), or run /iui setup in Claude Code in iTerm2 or herdr:" >&2
- printf ' %s\n' "$SETUP_START" "$line" "$SETUP_END" >&2
- SUM_SHELL="NOT added (refer to the warning above)"
- PROBLEM=1
- return 0
- ;;
- esac
- UNDO_SHELL="/iui setup remove in Claude Code, or delete the lines from '$SETUP_START' to '$SETUP_END' in $(tilde "$file")"
- }
- # --- 6. Summary ----------------------------------------------------------------
- summary() {
- step "Done"
- note "Typst: $SUM_TYPST"
- note "Mod: $SUM_PLUGIN"
- note "Auto-update: $SUM_AUTO"
- note "Pictures in iTerm2/herdr: $SUM_SHELL"
- say ""
- say "Restart Claude Code, or type /reload-plugins in a session that runs now."
- say "Intelligent UI works best in fullscreen mode: type /tui fullscreen in Claude Code."
- say "Pictures show only in some terminals (kitty, Ghostty, iTerm2 and others). To see why"
- say "pictures do or do not show, type /iui details. Docs: https://github.com/razorback16/cc-intelligent-ui"
- say ""
- say "To undo:"
- if [ -n "$UNDO_TYPST" ]; then note "Typst: $UNDO_TYPST"; fi
- note "Mod: claude plugin uninstall $PLUGIN"
- note "Marketplace: claude plugin marketplace remove $MARKETPLACE (also removes its settings entry)"
- if [ -n "$UNDO_MORE" ]; then printf '%s' "$UNDO_MORE" | sed 's/^/ /'; fi
- if [ -n "$AUTO_ON" ]; then
- note "Auto-update: /plugin > Marketplaces > $MARKETPLACE > Disable auto-update"
- note " (it also sets extraKnownMarketplaces.$MARKETPLACE.autoUpdate to false in settings.json)"
- if [ -n "$UNDO_AUTO" ]; then note " or $UNDO_AUTO"; fi
- fi
- if [ -n "$UNDO_SHELL" ]; then note "Shell setup: $UNDO_SHELL"; fi
- case $SUM_AUTO in off*)
- say ""
- say "Auto-update is off, as you set it. To turn it on: in Claude Code, type /plugin, go to"
- say "Marketplaces, select $MARKETPLACE, then select Enable auto-update."
- ;;
- esac
- }
- main() {
- init_output
- trap cleanup EXIT
- trap 'exit 130' INT
- trap 'exit 143' TERM
- say "${BOLD}Intelligent UI for Claude Code: installer${PLAIN}"
- say "It installs Typst $TYPST_VERSION (when no Typst $TYPST_MIN or later is found), the mod $PLUGIN,"
- say "turns on auto-update for the $MARKETPLACE marketplace, and sets up pictures in iTerm2 and herdr."
- say "It never uses sudo."
- step "1. Checks"
- check_platform
- check_claude
- install_typst
- cleanup
- WORK=
- install_plugin
- auto_update
- shell_setup
- summary
- if [ -n "$PROBLEM" ]; then
- say ""
- say "Finished with a problem: refer to the warning above."
- exit 1
- fi
- }
- main "$@"
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.