Repository navigation
v0.1.0
The first release: a self-hosted LaTeX workspace with an AI assistant.
Editor and PDF
- LaTeX editor with tabs, autosave and syntax highlighting.
- Compilation with Tectonic, which fetches the packages a document needs; errors and warnings listed with file and line, each with Fix with AI.
- Named
fontspecfamilies (\setmainfont{Open Sans}) work without changing the document: Refract uses the project's own font files, the TeX bundle's Latin Modern and TeX Gyre, or downloads the family from Google Fonts (REFRACT_FONT_DOWNLOADS=0turns downloads off). By Lorena Jimenez in #1. - PDF preview with SyncTeX in both directions (⌘J, and ⌘-click in the PDF), and a right-click menu in the PDF.
- Command palette (⌘K) and a shortcut overlay.
- English and Spanish interface, light and dark themes, installable as an app from the browser.
- Smooth transitions between pages, without reloads.
Assistant
- An agent that reads, searches, edits and compiles the project in a separate git worktree, and hands back its changes as a review: accept or reject all at once or file by file.
- Shows the model's reasoning when the model provides it; each chat remembers its model and reasoning level.
- Quick actions on a selection (improve, shorten, fix grammar, table, explain, free instruction) shown as inline word diffs.
References
- Finds published papers (OpenAlex) and arXiv preprints that support a passage, and places
\citeas a change to review. - Bibliography entries always come from the publisher's or arXiv's metadata.
Projects, history and sync
- Import Prism exports (.zip) and folders; export any project as a .zip.
- Every project is a git repository: history with diffs, and restoring a file or the whole project.
- Push and pull to any https git remote, or to GitHub repositories picked or created from Refract; optional auto-push.
AI models
- Your ChatGPT plan through "Sign in with ChatGPT" (
refract login). - API keys for OpenAI, Anthropic, Google Gemini, OpenRouter, Mistral, DeepSeek, xAI and Groq; local models through Ollama; any OpenAI-compatible endpoint.
- One model picker for all of them, grouped by provider, with search and the reasoning levels each model supports.
Accounts and security
- Several users, each with their own projects, chats and connections.
- Sign-in through Cloudflare Access, Refract's own sign-in page (passwords, and optionally OpenID Connect), or no sign-in on a private network.
refract usersto add, rename, sign out, unlock and remove accounts.- Sign-in attempts limited per account and per address; credentials and API keys encrypted at rest; a strict Content-Security-Policy.
Distribution
refractbinaries for macOS, Linux and Windows (amd64 and arm64).- A Docker image for amd64 and arm64 on GitHub Container Registry, with Tectonic and SyncTeX included.