setup
/setup
Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.
- Author
- dianzuan ↗
- Repository
- zotron ↗
- Licence
- AGPL-3.0
- Last repository change
- 13.07.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 7
No signals detected. Repository changed on 13.07.2026, without references to retired models or APIs.
AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.
What it does and when to use it
Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.
Original author description
Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.
How it works
- Goal
- Distribution model
- Procedure
- Mirror Controls
SKILL.md preview
---
name: setup
description: Set up Zotron — verify `zotron ping` works; if missing, download the release XPI to Downloads and guide Zotero's native install dialog. Use when the user asks to install, configure, bootstrap, or verify Zotron.
---
# Zotron Setup
Run this when the user has just installed the Zotron plugin or when `zotron ping` cannot reach Zotero.
## Goal
End state: `zotron ping` succeeds and the agent can call the single `zotron` CLI. OCR and RAG are subcommands: `zotron ocr ...` and `zotron rag ...`.
## Distribution model
The repository does not track `zotron.xpi`. New installs download the release XPI. If GitHub is unavailable, set `ZOTRON_XPI_URLS` to one or more mirror URLs. If a local file is already available, set `ZOTRON_XPI_PATH=/path/to/zotron.xpi`.
If Zotron is already installed but the setup target version is newer, do not reinstall from setup. Tell the user to use Zotero's native update flow:
```text
Tools -> Plugins -> Zotron -> gear icon -> Check for Updates -> restart Zotero
```
## Procedure
1. Check that the `zotron` CLI is installed. If missing, run the cascading install script below. It tries four methods in order and stops at the first success.
```bash
#!/usr/bin/env bash
set -euo pipefail
if command -v zotron >/dev/null 2>&1; then
echo "zotron already installed: $(command -v zotron)"
exit 0
fi
INSTALL_DIR="${HOME}/.local/bin"
mkdir -p "$INSTALL_DIR"
# --- Detect platform ---
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)
case "$ARCH" in aarch64|arm64) ARCH=arm64 ;; x86_64|amd64) ARCH=amd64 ;; esac
case "$OS" in
linux) PLATFORM="linux-${ARCH}" ;;
darwin) PLATFORM="macos-${ARCH}" ;;
*) PLATFORM="windows-amd64.exe" ;;
esac
# Release binaries are versioned (zotron-<version>-<platform>), so resolve the
# latest tag first, then build the download URL for that exact asset.
# `|| true` + the empty check keep a failed/blocked API call (rate-limit,
# offline) from aborting the script under `set -e` — we just fall through to
# the other install methods below.
TAG=$(curl -fsSL https://api.github.com/repos/dianzuan/zotron/releases/latest 2>/dev/null \
| grep -m1 '"tag_name"' | sed -E 's/.*"tag_name": *"([^"]+)".*/\1/' || true)
if [ -n "$TAG" ]; then
GITHUB_URL="https://github.com/dianzuan/zotron/releases/download/${TAG}/zotron-${TAG#v}-${PLATFORM}"
else
GITHUB_URL="" # tag unresolved — skip the direct download, use fallbacks
fi
installed=false
# --- Method 1: cargo binstall (prebuilt binary via cargo-binstall) ---
if ! $installed && command -v cargo-binstall >/dev/null 2>&1; then
echo "[1/4] Trying cargo binstall zotron ..."
if cargo binstall zotron --no-confirm 2>/dev/null; then
installed=true
fi
fi
# --- Method 2: Direct download from GitHub Releases ---
if ! $installed; then
echo "[2/4] Trying direct download from GitHub Releases ..."
if curl -fL --connect-timeout 15 --max-time 120 -o "${INSTALL_DIR}/zotron" "$GITHUB_URL" 2>/dev/null; then
chmod +x "${INSTALL_DIR}/zotron"
installed=true
fi
fi
# --- Method 3: Mirror fallback (for users behind GFW) ---
if ! $installed; then
MIRRORS=(
"https://gh-proxy.com/${GITHUB_URL}"
"https://gh.llkk.cc/${GITHUB_URL}"
"https://hub.gitmirror.com/${GITHUB_URL}"
)
for mirror in "${MIRRORS[@]}"; do
echo "[3/4] Trying mirror: ${mirror%/*} ..."
if curl -fL --connect-timeout 15 --max-time 120 -o "${INSTALL_DIR}/zotron" "$mirror" 2>/dev/null; then
chmod +x "${INSTALL_DIR}/zotron"
installed=true
break
fi
done
fi
# --- Method 4: cargo install (compile from source, last resort) ---
if ! $installed && command -v cargo >/dev/null 2>&1; then
echo "[4/4] Trying cargo install zotron (compiling from source) ..."
if cargo install zotron 2>/dev/null; then
installed=true
fi
fi
if $installed; then
echo "zotron installed successfully: $(command -v zotron || echo "${INSTALL_DIR}/zotron")"
else
echo "ERROR: All install methods failed. Please install manually from:"
echo " ${GITHUB_URL}"
exit 1
fi
```
Make sure `~/.local/bin` is on PATH. If not, add it: `export PATH="$HOME/.local/bin:$PATH"`
2. Run the setup script to verify and bootstrap the XPI.
```bash
PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
bash "$PLUGIN_ROOT/scripts/setup-zotron.sh"
```
3. If the bridge is live at the expected version, stop.
4. If the bridge is live but the plugin version is older, tell the user to update inside Zotero using the update flow above.
5. If the bridge is down, the script downloads or stages `zotron.xpi` into the user's real Downloads folder and prints the path as Zotero will see it.
6. Tell the user:
```text
In Zotero:
1. Tools -> Plugins
2. Gear icon -> Install Add-on From File
3. Choose zotron.xpi from the path printed by setup
4. Install, then restart Zotero
```
7. After restart, verify:
```bash
zotron ping
zotron system version
zotron --help # should show all command groups
```
## Mirror Controls
```bash
ZOTRON_XPI_URLS='https://mirror.example/zotron.xpi https://github.com/dianzuan/zotron/releases/latest/download/zotron.xpi' \
bash "$PLUGIN_ROOT/scripts/setup-zotron.sh"
```
Use `ZOTRON_XPI_PATH=/path/to/zotron.xpi` only when the file has already been downloaded through another channel.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · dianzuan/zotron | 100 | AGPL-3.0 |
| HwangSlater/harness-fit | 100 | MIT |
| nesquikm/dev-process-toolkit | 100 | MIT |
| userKael/rastro | 100 | MIT |
| als-apg/osprey | 100 | BSD-3-Clause |
| dedujeong/gemba | 100 | Apache-2.0 |
| eigenwise/eigenwise-toolshed | 100 | MIT |
| awrshift/agent-memory-kit | 100 | MIT |
| lifecycle-innovations-limited/claude-ops | 100 | MIT |
Database snapshot: 13.11.2026 · package version f7bfb31199a2 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100zotero
Manage the user's Zotero library — search papers, add/organize items, export citations, OCR PDFs, and run semantic search (RAG). Use whenever the user mentions Zotero, "我的文献库", finding/adding/citing papers, "参考文献", "文献综述", or wants to read/extract content from their PDFs.… - 100zotero
面向不同研究领域的 Zotero 技能:原文定位问答、全文翻译与精读、原生高亮和中文批注、双语 PDF/逐段 Markdown、论文证据对比表、综述与引用追踪;支持 OpenAlex / Crossref / 知网导出文件三种文献来源,术语和数字复核、可追溯纠错,另有归集分类、BibTeX 和草稿引用。用户提到 Zotero、解释论文、翻译、精读、标注、文献比较、综述、中文文献或知网时使用。 - 100zotero-paper-fetching
Full pipeline for batch literature search, PDF download, and Zotero intake. Use when the user provides a paper/citation list (Markdown numbered list, references excerpt, DOI list, arXiv IDs, etc.) and asks to "search, download, and file them into Zotero", "add these papers to… - 100zotero-cli
Read and write a Zotero library from the shell with the `zotero-cli` command - search papers by keyword or meaning, read PDF full text and page ranges, get and set metadata, manage collections, tags, notes and annotations, add items by DOI/URL/ISBN, and export bibliographies.… - 90che-zotero-mcp
Guide for using Zotero MCP tools to manage references, search academic papers, generate citations, and build knowledge graphs. Use when user asks about Zotero, citations, bibliography, literature review, academic search, or knowledge graph. - 100zotero-library
Find, add and file papers in the user's Zotero library for the current project without changing anything the user already has. Use when a task needs the user's own papers, their PDFs' full text, citations from their library, or adding a paper to the project's reading list.