AI Providers Customization Agent MinerU Custom System Prompt (Optional) Add custom instructions to the default system prompt (leave empty to use default only) View default system prompt Show "Add Text" in reader selection popup Disable this if you prefer not to show the Add Text option in Zotero's text selection popup menu. Plugin Font Size 120% Reset Adjusts text size in the chat panel and standalone window. You can also use Cmd/Ctrl + and Cmd/Ctrl − while a panel is focused (Cmd/Ctrl 0 to reset). Message typography Message Paragraph Spacing 8px Reset Adjusts spacing between normal rendered message paragraphs only. Tables and code blocks keep their current spacing. Message Line Spacing 150% Reset Adjusts line height inside normal rendered message paragraphs. Tables and code blocks keep their current spacing. Message Word Spacing 0px Reset Adjusts spacing between words in normal rendered message text only. Message Font Family Reset Comma-separated font family fallback stack. Leave empty to use the plugin default. Semantic Search Uses vector embeddings for meaning-aware search. When disabled, only keyword matching (BM25) is used. Language Auto (follow Zotero) English 中文 (简体) Restart Zotero to apply language change. Enable Agent Mode (Beta) Shows the "Agent (beta)" toggle in the context bar, enabling the agentic multi-step assistant. Off by default — enable only if you want to experiment with the beta feature. Codex App Server First-class Codex runtime integration. Run codex login before enabling it; Zotero keeps local tool approvals in its own confirmation cards. Enable Codex App Server integration When enabled, Zotero shows the Codex button in the chat header so you can switch between upstream chat and Codex. Off On Runtime defaults These values control how Codex runs inside Zotero by default. Model Reasoning Auto Low Medium High XHigh Enter a Codex app-server model ID, for example gpt-5.4, gpt-5.3-codex, or gpt-5.2-codex. Use the model name accepted by your installed Codex CLI. Codex CLI Path (optional) Test connection Zotero MCP tools Lets native Codex and Claude Code use a curated local MCP server for Zotero library/PDF reading and guarded Zotero operations. Write and destructive tools still use Zotero confirmation or tool-specific safety checks. Enable Zotero MCP tools for native Codex and Claude Code turns Install/update Zotero MCP config For Codex, Zotero writes a local bearer-token protected MCP entry into Codex config and asks app-server to reload MCP servers. Claude Code receives a scoped MCP server directly for each turn. User-level Codex skills, plugins, and other MCP setup remain owned by Codex. Claude Code Integration This panel configures the embedded Claude runtime. You enter Claude Code mode from the chat header, not from settings. Enable Claude Code integration When enabled, Zotero shows the Claude button in the chat header so you can switch between upstream chat and Claude Code. Off On Connection Zotero sends Claude requests to this local bridge service. Bridge URL Config source Choose where Claude should load its settings from. Most users should keep default. Claude Config Source default — user + project + local user-only — only your global Claude config zotero-only — only Zotero-managed configs Show config locations and advanced details default loads user + project + local. Priority: local > project > user. user-only loads only your machine-wide Claude settings. zotero-only loads only Zotero-managed shared and per-conversation settings. Trace logs Save Claude runtime traces for debugging and copy the log directory path. Enabled Copy path Claude Code settings guide Runtime defaults These values control how Claude runs inside Zotero by default. Default Model This sets the default capability tier for new Claude conversations. haiku, sonnet, and opus are strength tiers, so the runtime may map them to different underlying models. sonnet opus haiku Permission Mode safe is recommended. yolo affects Claude Code bridge permissions only; Zotero MCP and tool-specific safety checks may still require confirmation or block unsafe actions. safe yolo Default Reasoning The reasoning effort Claude uses by default for new runs. auto low medium high xhigh max Enable block streaming Show Claude answers chunk by chunk while they stream, instead of waiting until the final answer is assembled. Enable auto-compact Automatically send /compact before a new Claude turn when context usage crosses the threshold below. Advanced: Runtime CLAUDE.md instructions This controls the text injected between <!-- LLM-FOR-ZOTERO:CLAUDE-MANAGED-BEGIN --> and <!-- LLM-FOR-ZOTERO:CLAUDE-MANAGED-END --> inside the runtime CLAUDE.md. Existing files are preserved. Clicking Update only refreshes that managed block. If you are not already comfortable editing Claude Code project instructions, leave this unchanged. Update runtime CLAUDE.md Reset to default Notes Directory Configure a local directory for saving notes as files. Note format and templates are managed through skills — type / in chat to see available skills, or edit skill files directly. Nickname How you refer to this directory — the agent will recognize it when you mention it Notes Directory Path Absolute path to the directory where notes are saved as files Default Folder Default subfolder for notes (the agent can write to any folder if you specify) Attachments Folder Folder for images, relative to vault root (e.g., assets, Notes/imgs) Test Write Access MinerU PDF Parsing Extract high-quality structured text from PDFs with preserved math formulas, tables, and figures. MinerU dramatically improves how the AI understands your papers. Enable MinerU PDF Parsing Sync MinerU cache with Zotero file sync Creates companion ZIP attachments for MinerU full.md, manifest.json, content_list.json, and PDF figure crops. Requires Zotero file sync or WebDAV. Sync existing MinerU caches now Delete synced MinerU packages Auto-parse newly added items Ready Processing Failed Cloud Local API Key (Required) An API key is required. Get a free key from mineru.net. Connects directly to mineru.net. Parsing model pipeline vlm (recommended) vlm uses a vision-language model — generally better at chapter structure, figures, and formulas; may be slower than pipeline. Local API Base URL Uses a self-hosted mineru-api server. Test Connection only checks that the server process is reachable. Backend pipeline vlm hybrid Switching backend triggers a cold start: the first parse afterwards may take noticeably longer while the model loads. Note: Pause stops the queue, but an already-running local parse keeps executing on the mineru-api server — it has no cancel endpoint. To abort immediately (e.g. to switch backend right away), restart your mineru-api process manually. Force OCR Use OCR even when MinerU would normally auto-detect PDF text. Leave off to keep MinerU's default detection. Test Connection Advanced parsing filters Skip files over pages Start All, Start Filtered, Start Selected, and auto-parse skip PDFs above this page count. Exclude PDFs by Filename Comma-separated patterns. Matching filenames are skipped by your rule. Wrap in /slashes/ for regex. Manage Files 0 / 0 Start All Repair Cache Delete All Cache ● Title Author Year Added Process This Item Show in File Manager Delete MinerU Cache