# Zinc > Zinc is a fast, native, Zotero-compatible reference manager for Windows, Linux and macOS: a GPU-drawn library and PDF reader on your Zotero data, Zotero's own translators and sync, a Word add-in and a browser connector that work with the app closed (Windows), and a built-in MCP server for AI agents. Zinc opens the same kind of library as Zotero (it imports a Zotero data folder read-only and syncs with zotero.org) and speaks the Zotero connector protocol. Every page below is plain Markdown. All of them in one file: [llms-full.txt](https://aborakati.github.io/zinc/llms-full.txt). ## About - [README](https://aborakati.github.io/zinc/readme.md): what Zinc is, its features, how it compares with Zotero, how to install it ## Overview - [Zinc documentation](https://aborakati.github.io/zinc/overview.md): Zinc is a native, Zotero-compatible reference manager for Windows, Linux and macOS. ## User guide - [User guide](https://aborakati.github.io/zinc/user-guide.md): How to install and use Zinc. - [Install](https://aborakati.github.io/zinc/user-guide/install.md): Zinc runs on Windows, Linux and macOS. - [First run](https://aborakati.github.io/zinc/user-guide/first-run.md): The first time you start Zinc on a machine, no library is configured. - [Library basics](https://aborakati.github.io/zinc/user-guide/library.md): The main window has three panes: the sidebar on the left (library views, saved searches, collections and tags), the item list in the middle, and the item pane on the right. - [Layouts](https://aborakati.github.io/zinc/user-guide/layouts.md): You can arrange the library's panes the way you work: put item details below the list instead of beside it, give Tags or Notes a pane of their own, stack panes as tabs, or hide what you do not use. - [Adding items](https://aborakati.github.io/zinc/user-guide/adding-items.md): There are several ways to get a reference into the library. - [The PDF reader](https://aborakati.github.io/zinc/user-guide/reader.md): Click Open PDF on an item, or choose Open from its menu, to open the PDF in a tab of the main window. - [Notes and web tabs](https://aborakati.github.io/zinc/user-guide/notes-and-web-tabs.md): An item can have any number of child notes, and you can also keep standalone notes that belong to no item. - [Find Full Text](https://aborakati.github.io/zinc/user-guide/find-full-text.md): Find Full Text looks for a PDF of an item and attaches it. - [Locate engines](https://aborakati.github.io/zinc/user-guide/locate-engines.md): The first four entries are always there. - [Citations and bibliographies](https://aborakati.github.io/zinc/user-guide/citations.md): Zinc formats citations and bibliographies with the CSL engine (citeproc-js). - [Better BibTeX](https://aborakati.github.io/zinc/user-guide/better-bibtex.md): Zinc has Better BibTeX (BBT) built in. - [Attachment storage (ZotMoov-style)](https://aborakati.github.io/zinc/user-guide/zotmoov-storage.md): By default Zinc keeps attachment files in its own storage folder, one subfolder per item, next to the library database. - [Sync](https://aborakati.github.io/zinc/user-guide/sync.md): Zinc can keep its library in step with your Zotero library in two different ways, and you choose one of them (or neither). - [Import and export](https://aborakati.github.io/zinc/user-guide/import-export.md): Zinc reads and writes the common reference formats itself, and can use Zotero's own translators for many more. - [Word add-in](https://aborakati.github.io/zinc/user-guide/word.md): The Zinc Word add-in is Windows only. - [MCP for AI agents](https://aborakati.github.io/zinc/user-guide/mcp.md): Zinc has two separate Model Context Protocol servers, so an AI agent such as Claude Code can work with your references: - [Plugins](https://aborakati.github.io/zinc/user-guide/plugins.md): Plugins add features to Zinc: menu commands, item list columns, item pane sections, settings panes, reader buttons, and tools for AI agents. - [Settings reference](https://aborakati.github.io/zinc/user-guide/settings.md): Open Settings with Ctrl+, or the Settings... - [Logs and Report a problem](https://aborakati.github.io/zinc/user-guide/logs-and-reports.md): Errors and crashes are written to a log on your computer. - [Updates](https://aborakati.github.io/zinc/user-guide/updates.md): Zinc can check a signed feed, download the update, verify it and install it: on Windows it runs the installer silently, on Linux it replaces its AppImage file, and on macOS it replaces Zinc.app. - [Troubleshooting and FAQ](https://aborakati.github.io/zinc/user-guide/troubleshooting.md): First look at the log. - [Comparison with Zotero 10](https://aborakati.github.io/zinc/user-guide/comparison.md): Zinc reads and writes a Zotero library and speaks the same connector protocol, but it is a different program. ## Developer guide - [Developer guide](https://aborakati.github.io/zinc/developer-guide.md): How Zinc is built, tested and released. - [Architecture](https://aborakati.github.io/zinc/developer-guide/architecture.md): Zinc is a desktop reference manager for Windows, Linux and macOS (Apple Silicon) that reads and writes a Zotero-format library kept in one SQLite file. - [Building from source](https://aborakati.github.io/zinc/developer-guide/building.md): This page covers building and running Zinc from a checkout, and producing the Windows installer, the Linux AppImage and the macOS disk image. - [Testing](https://aborakati.github.io/zinc/developer-guide/testing.md): Everything runs under Bun's test runner. - [The SQLite library and migrations](https://aborakati.github.io/zinc/developer-guide/database.md): All user data lives in one SQLite file, opened by openDb(path) in core/src/db.ts. - [HTTP API](https://aborakati.github.io/zinc/developer-guide/http-api.md): The core serves a local HTTP API for the app's UI, the Word sidebar and add-in, the browser connector, and MCP clients. - [Translators](https://aborakati.github.io/zinc/developer-guide/translators.md): Zinc runs Zotero's own translators, the ones Zotero and translation-server use, without a browser. - [Releasing](https://aborakati.github.io/zinc/developer-guide/releasing.md): How a build becomes an installer, and how an installer becomes an update that installed copies pick up. - [WASM plugins for Zinc: design index (phase 1)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins.md): Zinc's own plugin system: WebAssembly components with WIT interfaces. - [Writing a Zinc plugin](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/writing-a-plugin.md): A Zinc plugin is a WebAssembly component that implements the plugin world or one of its smaller family worlds (plugin-api/wit/world.wit). - [Agent skills for plugin authors](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/agent-skills.md): Zinc ships two skills for AI coding agents that write Zinc plugins. - [Plugin tools for AI agents (MCP)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/mcp.md): A plugin can offer tools to AI agents through Zinc's MCP server. - [Contributing](https://aborakati.github.io/zinc/developer-guide/contributing.md): This page expands CONTRIBUTING.md at the repository root. ## Other - [Design note: Zinc in the browser (the connector as a full app)](https://aborakati.github.io/zinc/design/browser-edition.md): Status: 2026-11-12, built (section 10). - [GPUIX issue: font registration for the WebAssembly build (draft)](https://aborakati.github.io/zinc/design/gpuix-web-fonts-request.md): Who posts it: the project owner, by hand, at the link below. - [Design note: the Zinc app inside the browser connector](https://aborakati.github.io/zinc/design/web-connector-wasm.md): Status: feasibility study, 2026-11-12. - [Releasing the browser extension](https://aborakati.github.io/zinc/developer-guide/extension-release.md): The Zinc Connector is the browser extension: it saves pages, and its library tab is the full Zinc app (WebAssembly). - [Customizable panes and layouts (design sketch)](https://aborakati.github.io/zinc/developer-guide/layouts.md): Status: proposal, nothing built. - [Layouts phase 2: docking (work plan and contract)](https://aborakati.github.io/zinc/developer-guide/layouts-phase2.md): Phase 2 of layouts.md (section 13): tab stacks, drag to dock, item pane sections as panes, keyboard move menus, undo. - [Extending Zinc's main window from a WASM plugin (extend)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/extend.md): Phase 1 design, 2026-11-18. - [WASM plugin API: library, search, batching, notifier](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/library.md): Area library. WIT: plugin-api/wit/library.wit. - [WASM plugins: package, lifecycle and capabilities (the lifecycle area)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/lifecycle.md): This is the phase 1 design report of the lifecycle agent (2026-11-18). - [Phase 2: AOT for plugins (feasibility spike)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-aot.md): Status: works on Windows with the Bun canary; experimental, off by default. - [Phase 2, core agent: the plugin host](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-core.md): Status 2026-11-18. Package: plugin-host/. - [Phase 2, data agent: library, change log, notifier, net, fs, clipboard, shell](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-data.md): Status 2026-11-18. Handlers: plugin-host/src/imports/ (files named below). - [Phase 2, extend agent: extension points in the main window](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-extend.md): Status 2026-11-18. WIT: extend.wit. - [Phase 2, integrate agent: one working system](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-integrate.md): Status 2026-11-18. Work done in plugin-host/ and gpui-ui/src/wasmplugins/. - [Phase 2, pkg agent: packages, permissions and the small host imports](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-pkg.md): Status 2026-11-18. Code: plugin-host/src/package/, plugin-host/src/permissions/, plugin-host/src/imports/{app,plugins,prefs,secrets,l10n,log,timers,util,permissions}. - [Phase 2, reader agent: reader, annotations and the note editor](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-reader.md): Status 2026-11-18. Check: bun scripts/shot-wasm-reader.tsx in gpui-ui/ (49 of 49 PASS, about 80 s, headless), bun test src/wasmplugins/reader (16 pass), bun check clean in gpui-ui/ for these files and in plugin-host/. - [Phase 2, Rust SDK agent: family worlds, a Rust SDK that compiles, samples, JS defaults](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-rust-sdk.md): Status 2026-11-18. bun plugin-api/samples/test.ts: PASS, 40 checks, 0 failed (word-count and highlight-export in Rust, quick-tags in JS). - [Phase 2, sdk agent: guest SDKs and sample plugins](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-sdk.md): Status 2026-11-18. Not finished: the Rust SDK and the two Rust samples have never been compiled, and samples/test.ts has never run. - [Phase 2, ui agent: the plugin UI](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-ui.md): Folder gpui-ui/src/wasmplugins/ui/, handler plugin-host/src/imports/ui.zinc.ts, check scripts gpui-ui/scripts/shot-wasm-ui.tsx. - [Phase 2, Wasmtime spike: a native plugin host to compare with the Bun host](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase2-wasmtime.md): Status 2026-11-18. Package: plugin-host-wasmtime/ (standalone Rust crate, its own empty [workspace], no file outside it was changed; plugin-api/ and plugin-host/ were only read). - [Phase 3: plugin MCP tools (report)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase3-mcp.md): Design and how-to: mcp.md. - [Phase 3, runner track: Wasmtime is the default plugin runner](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase3-runner.md): Status 2026-11-18. Built by the Gemini 4 Carbon agent (Paseo, Antigravity provider) and two helper agents. - [Phase 3, UI and WIT track (phase3-ui.md)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase3-ui.md): Date: 2026-11-18. Track: UI and WIT (items A1, B3, B4). - [Phase 3 plan: Wasmtime as the default plugin runner (2026-11-18)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/phase3-wasmtime-plan.md): Decision (user, 2026-11-18): plugins run in Wasmtime, precompiled to .cwasm on the user's machine. - [zhw NDJSON Stdio Protocol (protocol-ndjson.md)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/protocol-ndjson.md): Status: Phase 3 contract (2026-11-18). - [WASM plugin API: reader, annotations and the note editor](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/reader.md): Phase 1 (design only). - [Rules for the WASM plugin API agents, phase 1 (2026-11-18)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/rules.md): Zinc gets its own plugin system: WebAssembly components with WIT interfaces. - [Rules for the WASM plugin agents, phase 2 (2026-11-18)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/rules-phase2.md): Phase 1 designed Zinc's WASM plugin API (plugin-api/wit/.wit, reports in this folder; start with README.md). - [Plugin UI: the declarative tree](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/ui.md): Area: ui. Files: plugin-api/wit/ui.wit (interfaces ui and ui-events), plugin-api/ui-schema/ui-tree.schema.json. - [Zotero versions and their plugin APIs (7 to 11)](https://aborakati.github.io/zinc/developer-guide/wasm-plugins/zotero-versions.md): Status 2026-11-18. The current Zotero is 10 (10.0 released 17 August 2026).