LocalXiv v0.0.11

LocalXiv 0.0.11

This early preview updates visual Overviews and long-form Blog explanations. LocalXiv remains a local paper library and reader with EPUB export and optional AI features.

Overviews use separately authored panels with layout and readability checks. The reader can open the complete drawing for closer inspection. Blogs generate focused figures separately, with bounded repair attempts and omission when a drawing cannot be accepted. Blog generation works without a saved Overview.

The Blog review workflow carries unresolved findings between reviews and checks figure references before repair. Two known cases remain: findings on the same passage can share an ID and overwrite one another, and a finding targeting an omitted figure can bypass anchor validation. Generated explanations can contain scientific errors even after automated review. Check important claims against the paper.

The README now explains setup, provider choices, data handling, and experimental AI limitations. LocalXiv was developed primarily with GPT-6 Astra in Codex; the app uses the provider and model selected in Settings.

Verification and limitations

This release starts from checkpoint a9d991b. Release preparation updates version metadata, documentation, and test coverage in CI. The release workflow checks the source, builds the portable app, and verifies its packaged runtime. The attached verification report and runtime manifest describe the built artifact. Offline tests do not establish live-provider reliability or scientific correctness.

Local release checks completed 333 tests with 17 skips and no failures. Another 40 Blog figure, SVG, and edge-alignment tests passed with native rendering enabled. JavaScript UI checks, source compilation, shell syntax, workflow YAML parsing, and the dependency source-collector self-check passed. The skipped optional and renderer-specific checks are not counted as passes; CI separately runs renderer checks against the built helper.

AI generation may take several minutes or fail. It sends selected paper content and, where applicable, images to the configured provider and may incur charges. Importing and reading papers do not require AI credentials.

Installation

Requires Apple Silicon and macOS 26 or newer. Download the DMG and drag LocalXiv into Applications. Finish active jobs before updating. Your local library and settings are retained.

This preview is ad hoc signed, without Apple Developer ID signing or notarization. macOS may block the first launch. The Sparkle update feed is signed separately with the project's local update key.

LocalXiv v0.0.10

LocalXiv 0.0.10

Overview previews now fit within the reading window. Newly generated Overviews have a compact header, a total height limit, and a smaller word budget. Their instructions lead with the paper's contribution, supported finding and limits, using one focused illustration with compact architecture context. Existing saved generations remain readable.

Generation now follows application-controlled planning, authoring, rendering and evidence review. Each plan links claims and visual relationships to source passages. Provider failures stop the run, repairs start with the current draft and corrections, and identical rejected drafts cannot keep cycling. Approval completes generation without another model turn.

DeepSeek authoring uses low reasoning effort. Diagnostics retain bounded provider error details, elapsed time and reported cache/reasoning usage without repeatedly storing the full request history. Bundled drawing guidance matches the renderer's supported markup.

Validation and limits

Local verification passed 84 tests, with one optional Keychain test skipped, plus the UI checks. Coverage includes provider failures, independent repair contexts, cancellation, existing exports, compact height and scaled-label readability. These checks do not establish live-provider speed or fresh generation quality. Packaged runtime verification is recorded separately by the release workflow.

Installation

Requires Apple Silicon and macOS 26 or newer. This preview is ad hoc signed and not notarized. Finish active jobs before updating. Papers and settings remain in the local library. Blog PDF export requires separately installed XeLaTeX.

LocalXiv v0.0.9

LocalXiv 0.0.9

Overview illustrations now emphasize concrete inputs, visible operations, and resulting outputs. Review checks arrow direction, required inputs, comparison scope, and misleading omissions. Native rendering rejects SVG labels that fall below 14px when the image is displayed at 640px wide, including smaller text within labels.

Blogs use the Overview and its editable source as reference. They must adapt focused figures to the surrounding sections; direct asset reuse and identical source copies are rejected.

This release also removes the retired illustration pipeline, its dependencies and prototype assets, refreshes the bundled Attention sample, and includes conversion and content-fidelity regression tests. Existing saved generations are not rewritten.

Validation and limits

Scripted agent tests exercise generation, review, and rejection behavior. Native rendering checks cover scaled labels and nested text. These checks do not establish the quality of a fresh live-model generation or readability below 640px. Packaged runtime verification is recorded separately by the release workflow.

Installation

Requires Apple Silicon and macOS 26 or newer. This preview is ad hoc signed and not notarized. Finish active jobs before replacing the app. Papers and settings remain in the local library. Blog PDF export requires separately installed XeLaTeX.

LocalXiv v0.0.8

LocalXiv 0.0.8

This patch fixes reasoning and tool-call history handling for DeepSeek and OpenRouter during Overview and Blog generation.

• DeepSeek requests retain reasoning_content on every assistant turn, including turns without tool calls. Tool selection uses auto so thinking can remain enabled.
• OpenRouter requests retain reasoning fields, including signed and encrypted reasoning_details blocks in their original order.
• Both providers retain native tool calls and match each result to its call ID. Provider behavior is selected by the exact hostname in the configured API base URL. Other endpoints keep their existing behavior.
• Reasoning is retained in memory for subsequent requests and excluded from saved generation traces. Retained reasoning counts toward the configured context bound.

Validation and limits

Provider, agent, and reading regression checks passed with scripted responses through the real agent loop, including text-only turns, multiple tool calls, reasoning preservation, and exact hostname matching. No live DeepSeek or OpenRouter calls were made. The packaged release report records the separate runtime and export checks.

Installation

Use LocalXiv > Check for Updates… from an updater-enabled version, or download the DMG and drag LocalXiv to Applications. Finish active jobs before updating. Papers and settings remain in your local library.

Requires Apple Silicon and macOS 26 or newer. This preview is ad hoc signed and not notarized. The update archive and feed use Sparkle signatures. Blog PDF export requires separately installed XeLaTeX.

LocalXiv v0.0.7

LocalXiv 0.0.7

This preview replaces new Excalidraw bento generation with paper-specific HTML/SVG explanations and a smolagents ToolCallingAgent workflow.

• Overview illustrations adapt to architecture, methodology, survey and other paper types. Native WebKit renders static PNG and PDF exports; editable HTML retains the SVG source.
• Blogs combine cited prose with HTML/SVG figures. They can reuse a current, reviewed overview without regenerating unchanged figures. Blog-only users can generate directly from the paper without creating an overview first.
• Generated explanations pass markup, citation and layout checks before model review. Vision review remains optional. Bounded retries preserve the previous saved result on failure.
• Import recovery shares one conversion path, retains useful failure artifacts, and preserves a previously readable paper when a retry fails. Export handling is shared across the app.
• Existing saved Excalidraw artwork remains available until regenerated. CodeAgent execution and Manim are not included.

Validation and limits

Local validation ran 293 tests with one skipped, plus workflow diagram checks and visual inspection. Earlier Gemini runs exercised the ToolCallingAgent workflow; the newest overview-reuse path was tested with scripted provider responses. These checks do not establish the quality of every generated illustration. The packaged release report records the separate runtime and export checks.

Installation

Use LocalXiv > Check for Updates… from an updater-enabled version, or download the DMG and drag LocalXiv to Applications. Finish active jobs before updating. Papers and settings remain in your local library.

Requires Apple Silicon and macOS 26 or newer. This preview is ad hoc signed and not notarized. The update archive and feed use Sparkle signatures. Blog PDF export requires separately installed XeLaTeX.

LocalXiv v0.0.6

LocalXiv 0.0.6

This preview adds in-app updates and improves the shared reading used for paper overviews and blogs.

• Portable builds include LocalXiv > Check for Updates…. Updates require confirmation and wait until paper jobs finish before replacing the app.
• Update archives and feeds are signed on the maintainer’s Mac. The private signing key stays in Keychain and is never sent to GitHub Actions.
• Imports prepare a cached AI reading when AI authentication is configured. Overview and Blog reuse that reading. Without authentication, import remains available and reading waits until an overview is requested after setup.
• Figure-aware reading can include supported paper images when the image-reading option is enabled. Cached figure notes inform both overviews and blogs.
• Bento planning supports varied card sizes and visual explanations. The optional Fiziko renderer uses an existing MetaPost installation.
• Reader layout and navigation are refined, and an offline Attention Is All You Need example is included.

Installation

Download the DMG and drag LocalXiv to Applications. Existing versions need this one manual replacement to gain the updater. Finish active jobs and stop the old background service before replacing an existing installation. Papers and settings stay in your local library.

Requires Apple Silicon and macOS 26 or newer. This preview is ad hoc signed and not notarized. Sparkle update signing does not remove macOS security or Keychain approval prompts. Blog PDF export and optional MetaPost visuals require separately installed TeX tools.

LocalXiv v0.0.5

LocalXiv 0.0.5

This preview updates the paper overview and sharing workflow. Download the DMG and drag LocalXiv to Applications. Finish active jobs and stop the old background service before replacing an existing installation; papers and settings remain in your local library.

• Overview now displays an editable Excalidraw bento; the long-form explanation is called Blog and is generated on request.
• Bento generation selects grounded content, plans the layout, then renders 4–9 cards with natural headings. Narrow screens use a portrait layout.
• Blog explanations connect the problem, previous work, method choices, figure interpretation, evidence and core insights.
• The Share menu contains EPUB and PDF exports, bento PNG and editable source, and a collapsed Send to Kindle section. The Aa bar contains reading controls.
• Automatic overview generation follows the saved opt-in preference.
• PNG rendering uses the bundled SVG converter, including for blog figures.

Existing overviews retain their artwork until regenerated. Blog PDF export requires XeLaTeX through MacTeX; it is not bundled. This Apple Silicon build requires macOS 26. It is ad hoc signed and not notarized. No live provider or Kindle delivery checks are included in local verification.

LocalXiv v0.0.4

LocalXiv v0.0.4

This preview reduces the app's bundled dependencies and adds paper removal from the Library screen.

Changes

• Remove a paper, its saved files, overview and chat history after confirmation. Exported files and copies sent to Kindle remain available. Removal waits for imports and work on the paper to finish.
• Package only the Java modules EPUBCheck needs, the Ghostscript executable and resources, and the JavaScript modules used by equation and SVG rendering. Exclude Python's test suite and unused renderer dependencies.
• Enforce release size limits of 650 MiB for app file contents and 350 MiB for the DMG. Each build includes a component size report.
• Reduce library polling responses and avoid overlapping refresh requests. Check conversion memory use every five seconds.
• Clarify the README and build instructions. Remove obsolete local build artifacts while retaining original paper inputs and current verification evidence.

Local source validation ran 240 Python tests, with 239 passing and one skipped, plus UI and extension checks. The removal dialog was checked at 320px width for overflow, touch-target size and keyboard focus. The release workflow separately verifies the packaged app, sandboxed conversion, PDF extraction and SVG rendering before publication. See the attached verification and size reports for this build's results.

Install or update

For Apple Silicon Macs running macOS 26 or newer. Download the DMG and drag LocalXiv into Applications. Finish active jobs and stop the old background service before replacing the app. Papers and settings remain in the local library; API keys remain in Keychain.

This preview is ad hoc signed, without Apple Developer ID signing or notarization. Independent-machine installation, live AI output quality and actual Kindle delivery are not established by automated release checks.

Assets include the verified DMG, app source, collected dependency source inputs, runtime inventory, size and verification reports, and SHA-256 checksums. The dependency inventory retains provenance and corresponding-source review limitations.

LocalXiv v0.0.3

LocalXiv v0.0.3

This preview improves paper retrieval, conversion, and checks for lost content.

Changes

• Recover through exact-version arXiv HTML when source conversion fails, while keeping the original PDF available.
• Handle more equations, source macros, bibliography forms, and table layouts.
• Restore citation links and independently captioned figure anchors.
• Preserve nested table grids with one shared caption and anchor, including numeric columns and commented column specifications.
• Permit title and contribution notes before the abstract without accepting a missing or empty abstract.
• Add a retained paper corpus, metamorphic tests, and checks for missing prose, figures, equations, tables, and internal links.

The retained 64-paper sample now produces 51 validated EPUBs. All 49 previous successes still convert; the latest citation/table repairs recover two more papers. Thirteen inputs remain unsuccessful: three have no usable retrieved source/HTML, and ten have unsupported processing constructs. This development sample is not an estimate of failure probability across arXiv.

Source validation passed 231 application tests with one skipped and 86 robustness tests. Recovered outputs passed both EPUB profiles and targeted content/visual checks. See the verification report for scope and remaining limits.

Install or update

For Apple Silicon Macs running macOS 26 or newer. Download the DMG and drag LocalXiv into Applications. Finish active jobs and stop the old background service before replacing the app. Papers and settings remain in the local library; API keys remain in Keychain.

This preview is ad hoc signed, without Apple Developer ID signing or notarization. Independent-machine installation, live AI output quality, and actual Kindle delivery are not established by the automated release checks.

Assets include the verified DMG, app source, collected dependency source inputs, runtime inventory, verification report, and SHA-256 checksums. The dependency inventory retains provenance and corresponding-source review limitations.

LocalXiv v0.0.2

LocalXiv v0.0.2

This preview improves paper overviews and reorganizes Settings.

Changes

• The summarizer reads up to three consecutive sections per request, with smaller batches when the context limit requires them.
• Overview plans define a central question and a connected narrative. Drafting and review preserve technical detail, explain unfamiliar concepts, and check transitions.
• Figures explain mechanisms, compare ideas, or summarize evidence. New figures use SVG in the reader and EPUB exports.
• Overview language and length are independent settings. Language options are Casual, Semi-formal, and Formal. Length targets are about 750 words, 750 to 1,250 words, or 1,500 to 2,000 words, with longer articles when needed. Casual and Medium are the defaults.
• Settings groups overview preferences, AI connection, Kindle delivery, and help. Save and Cancel remain visible while the controls scroll.
• Article and figure planning request JSON output explicitly. Invalid plans get one correction attempt before generation stops.
• Missing or invalid passage citations get one regeneration attempt against the original evidence. Invalid citations are never accepted.
• The bundled Node runtime uses its own OpenSSL configuration, so sandboxed equation rendering does not depend on Homebrew files.
• A GitHub Actions workflow builds and verifies DMGs. Version tags publish prereleases with checksums, reports, and source bundles.

Install or update

Use an Apple Silicon Mac running macOS 26 or newer. Download the DMG and drag LocalXiv into Applications.

Before replacing an older version, finish active jobs and stop its background service. Restarting the Mac stops the service. Your library remains in ~/Library/Application Support/LocalXiv/library, and API keys remain in Keychain.

Generate or regenerate an overview to use the new writing preferences. Existing overviews stay unchanged.

Verification and limits

Local checks passed for code signatures, DMG integrity, a relocated app, sandboxed EPUB conversion, PDF text extraction, and SVG rendering. The release includes an artifact-specific verification report and SHA-256 checksums.

This preview is ad hoc signed, without Apple Developer ID signing or notarization. Independent-machine installation, live AI writing quality, and actual Kindle delivery have not been verified for this release.

The release includes app source and collected dependency source inputs. The source inventory retains outstanding review items, including embedded dependency provenance and corresponding-source completeness. See dependency licenses and source distribution.