papilot 0.8.0 → 0.8.2

package/README.ko.md

@@ -0,0 +1,110 @@
+<div align="center">
+
+<h1>
+  <img src="docs/assets/wordmark.svg#gh-light-mode-only" width="280" height="88" alt="Papilot">
+  <img src="docs/assets/wordmark-dark.svg#gh-dark-mode-only" width="280" height="88" alt="Papilot">
+</h1>
+
+<p><b>AI로 LaTeX 논문을 수정하고, PDF에서 변경 사항을 검토하세요.</b></p>
+
+<p><a href="https://papilot.ai">웹사이트</a> · <a href="docs/guide.md">문서</a></p>
+
+<p data-language-switcher><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-Hant.md">繁體中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.it.md">Italiano</a> · <a href="README.sv.md">Svenska</a></p>
+
+[![CI](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml/badge.svg)](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/papilot?color=2563eb&logo=npm)](https://www.npmjs.com/package/papilot)
+[![License: MIT](https://img.shields.io/badge/license-MIT-2563eb)](LICENSE)
+
+<p><img src="docs/assets/demo.gif" alt="Papilot: PDF의 구절을 표시해 에이전트에게 전달하고 조판된 변경 사항을 검토" width="100%"></p>
+
+</div>
+
+Papilot은 AI 에이전트와 함께 LaTeX 논문을 작성하고 수정하기 위한 로컬 워크스페이스입니다. PDF에서 구절과 수식을 표시해 에이전트가 별도의 소스 사본을 편집하도록 한 다음, 조판된 변경 사항을 검토하고 반영할 항목을 선택하세요.
+
+<a id="features"></a>
+
+## 기능
+
+<table>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-note.jpg"><img src="docs/assets/readme-note.jpg" alt="PDF에 색상별로 묶인 구절 주석과 상자로 지정된 수식 주석"></a>
+<h3>PDF에 주석 달기</h3>
+문장을 선택하거나 수식을 상자로 지정하고 수정할 내용을 입력하세요. 관련된 주석을 색상별로 묶어 여러 구절에 하나의 지시를 내릴 수 있습니다.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-review.jpg"><img src="docs/assets/readme-review.jpg" alt="수락, 거절, 댓글 버튼이 있는 페이지의 변경 전후 조판 비교"></a>
+<h3>각 변경 사항 검토</h3>
+수식 번호 재지정 등 다른 위치의 변경 사항을 포함해 조판된 페이지의 변경 전후를 비교하세요. 각 편집 내용을 수락하거나 거절하고 댓글을 남길 수 있으며, 검토 중에 결정을 실행 취소할 수도 있습니다.
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-deliver.jpg"><img src="docs/assets/readme-deliver.jpg" alt="수락한 편집 내용을 원고에 적용"></a>
+<h3>편집 내용 반영 방식 선택</h3>
+새로운 각 작업은 논문의 독립된 사본에서 진행됩니다. 편집 내용을 검토한 후 **원고에 커밋**을 선택해 이 작업을 현재 브랜치의 단일 커밋으로 저장하거나, **워크스페이스에 적용**을 선택해 커밋하지 않은 상태로 편집 내용을 반영하세요. 그사이에 동일한 구절이 변경된 경우 AI가 자동으로 충돌을 해결하며, 의도한 내용이 불분명할 때만 사용자에게 확인을 요청합니다. 저장하기 전에 병합된 PDF를 검토하세요. 준비가 되면 Git 패널에서 푸시할 수 있습니다.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-git.jpg"><img src="docs/assets/readme-git.jpg" alt="스테이징된 파일, 생성된 커밋 메시지, 커밋 그래프가 표시된 Git 패널"></a>
+<h3>Git으로 작업</h3>
+워크스페이스에서 파일을 스테이징 및 커밋하고 풀과 푸시를 수행하세요. 에이전트가 커밋 메시지 초안을 작성하고 병합 충돌 해결을 도울 수 있으며, 커밋 그래프에는 각 작업의 작업 트리가 표시됩니다.
+</td>
+</tr>
+</table>
+
+- **[스킬](docs/guide.md#skills) 및 [첨부 파일](docs/guide.md#task-attachments):** `/` 스킬을 실행해 문장을 다듬거나 교정하고 수식을 점검할 수 있으며, 설정에서 사용자 지정 스킬을 정의하고 작업 및 메시지에 참고 파일이나 이미지를 첨부할 수 있습니다.
+- **열람 및 워크스페이스:** PDF 목차와 전체 텍스트 검색으로 원고를 탐색할 수 있으며, 라이트 및 다크 테마와 영어 또는 중국어 인터페이스를 지원합니다.
+
+<a id="quick-start"></a>
+
+## 빠른 시작
+
+macOS 및 Linux 데스크톱 앱과 로컬 빌드 방법은 [Papilot Desktop](desktop/README.md)을 참고하세요. 데스크톱 CI는 Apple Silicon 및 Intel Mac 설치 프로그램과 Linux x64용 AppImage 및 deb 패키지를 빌드합니다.
+
+Papilot을 사용하려면 **Node.js 22.22+**, **Git**, 그리고 `latexmk`와 `synctex`가 포함된 전체 **TeX** 배포판([MacTeX](https://www.tug.org/mactex/) 또는 [TeX Live](https://www.tug.org/texlive/))이 필요합니다. 논문을 수정하려면 구성된 [에이전트](#agents)도 최소 하나 이상 필요합니다.
+
+```sh
+npm install -g papilot
+papilot demo
+```
+
+[http://127.0.0.1:7274](http://127.0.0.1:7274)를 열고 사이드바에서 **원고**를 선택해 기본 제공되는 예제 논문을 살펴보세요.
+
+직접 작성한 원고로 작업하려면 `papilot`을 실행하고 **논문 추가…**를 선택해 로컬 LaTeX 폴더나 ZIP 압축 파일을 여세요. Papilot은 메인 `.tex` 파일을 찾고, 필요한 경우 Git 기록을 준비한 뒤 컴파일을 시도합니다. 메인 파일이 불분명하거나 빌드에 실패하면 가져오기 대화상자를 통해 파일을 선택하거나 문제를 해결할 수 있습니다.
+
+**설정 → 런타임**의 **에이전트** 또는 **LaTeX** 항목에서 설정 상태를 확인하세요. `papilot doctor`를 실행해 환경을 점검하거나, `papilot doctor --repo /path/to/paper`를 실행해 원고도 함께 점검할 수 있습니다([진단](docs/guide.md#diagnostics)).
+
+<a id="agents"></a>
+
+## 에이전트
+
+<!-- BEGIN AGENT ICONS -->
+<p align="center">
+  <a href="docs/guide.md#agents">
+    <picture>
+      <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/assets/readme-agents/compact-dark.svg">
+      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme-agents/desktop-dark.svg">
+      <source media="(max-width: 600px)" srcset="docs/assets/readme-agents/compact.svg">
+      <img src="docs/assets/readme-agents/desktop.svg" alt="Codex, Claude, Cursor, Copilot, Grok, Antigravity, Kimi, GLM, DeepSeek, Qwen, OpenCode" width="816">
+    </picture>
+  </a>
+</p>
+<!-- END AGENT ICONS -->
+
+각 작업마다 에이전트와 모델을 선택할 수 있습니다. 연동 방식에 따라 Papilot은 로컬 CLI 로그인 정보나 사용자가 제공한 제공자 API 자격 증명을 사용해 에이전트를 실행하며, 키를 별도로 저장하지 않습니다.
+
+**설정 → 런타임 → 에이전트**를 열어 상태, 모델 및 설정 방법(예: `papilot codex login`)을 확인하세요. Papilot 실행 중에 에이전트를 설치하거나 로그인한 경우 **다시 연결**을 클릭하고, 환경 변수를 변경한 경우에는 `papilot`을 재시작하세요. 에이전트별 요구 사항과 기능은 [에이전트 가이드](docs/guide.md#agents)를 참고하세요.
+
+<a id="documentation-and-community"></a>
+
+## 문서 및 커뮤니티
+
+- **문서:** 워크스페이스 워크플로, 구성, [앱 내 업데이트](docs/guide.md#updates), [Tailscale을 이용한 원격 액세스](docs/guide.md#remote-access-with-tailscale), [공동 작업자를 위한 패스키 공유](docs/guide.md#collaborators)에 관한 자세한 내용은 [사용자 가이드](docs/guide.md)를 참고하세요.
+- **설계 및 변경 기록:** 공식 설계 논문과 증명은 [`examples/papilot-paper`](examples/papilot-paper)에서 살펴보고, 릴리스 노트는 [변경 로그](CHANGELOG.md)에서 확인하세요.
+- **커뮤니티 및 지원:** [Discussions](https://github.com/PapilotAI/papilot/discussions)에서 질문하거나, [Issues](https://github.com/PapilotAI/papilot/issues)에서 버그를 제보하고, [CONTRIBUTING.md](CONTRIBUTING.md)를 읽고 프로젝트에 기여해 보세요.
+
+---
+
+[MIT](LICENSE) © 2026 PapilotAI
+
+파트너: [LINUX DO](https://linux.do/).

package/README.md

@@ -1,169 +1,102 @@
 <div align="center">
 
 <h1>
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
-    <img src="docs/assets/logo.svg" width="48" height="48" align="absmiddle" alt="Papilot logo">
-  </picture>
-  Papilot
+  <img src="docs/assets/wordmark.svg#gh-light-mode-only" width="280" height="88" alt="Papilot">
+  <img src="docs/assets/wordmark-dark.svg#gh-dark-mode-only" width="280" height="88" alt="Papilot">
 </h1>
 
-<p><b>A Cursor-like workspace for your papers: annotate and review PDFs directly without ever touching LaTeX.</b></p>
+<p><b>Revise LaTeX papers with AI, and review the changes on the PDF.</b></p>
 
-<p>English · <a href="README.zh-CN.md">简体中文</a></p>
+<p><a href="https://papilot.ai">Website</a> · <a href="docs/guide.md">Documentation</a></p>
 
-[![CI](https://github.com/cu1ch3n/papilot/actions/workflows/ci.yml/badge.svg)](https://github.com/cu1ch3n/papilot/actions/workflows/ci.yml)
+<p data-language-switcher><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-Hant.md">繁體中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.it.md">Italiano</a> · <a href="README.sv.md">Svenska</a></p>
+
+[![CI](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml/badge.svg)](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/papilot?color=2563eb&logo=npm)](https://www.npmjs.com/package/papilot)
 [![License: MIT](https://img.shields.io/badge/license-MIT-2563eb)](LICENSE)
-[![Node.js](https://img.shields.io/badge/node-%E2%89%A522.22-5FA04E?logo=nodedotjs&logoColor=white)](https://nodejs.org)
-[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
-[![React](https://img.shields.io/badge/React-19-087EA4?logo=react&logoColor=white)](https://react.dev)
-[![LaTeX](https://img.shields.io/badge/LaTeX-008080?logo=latex&logoColor=white)](https://www.latex-project.org)
-[![PRs welcome](https://img.shields.io/badge/PRs-welcome-22c55e)](https://github.com/cu1ch3n/papilot/pulls)
-
-**Contents:** [Features](#-features) · [Quick start](#-quick-start) · [Agents](#-agents) · [Documentation](#-documentation) · [Community](#-community) · [Friends](#-friends) · [License](#-license)
 
-<img src="docs/assets/demo.gif" alt="Papilot: mark up a passage of the PDF, hand it to an agent, accept the typeset change and commit it" width="100%">
+<p><img src="docs/assets/demo.gif" alt="Papilot: mark up a passage on the PDF, hand it to an agent, and review the typeset change" width="100%"></p>
 
 </div>
 
-You read and mark up the PDF the way a supervisor marks up a draft. An AI agent makes the edits in LaTeX, and every change comes back to you as a before-and-after of the typeset page. Nothing touches your paper until you accept it.
+Papilot is a local workspace for writing and revising LaTeX papers with AI agents. Mark up passages and equations on the PDF, let an agent edit a separate copy of the source, then review the typeset changes and choose which ones to keep.
 
-> [!TIP]
-> **New in 0.7:** a redesigned workspace, color-grouped notes, files and images in tasks, a skill library, and a choice of where accepted changes go. See the [changelog](CHANGELOG.md).
-
-## ✨ Features
+## Features
 
 <table>
 <tr>
 <td width="50%" valign="top">
-<img src="docs/assets/readme-note.jpg" alt="Two passages in a yellow note group and a region note on an equation">
-<h3>📝 Mark up the PDF</h3>
-Select a sentence or box an equation and say what should change. SyncTeX hands the agent the exact LaTeX lines. Color related notes into a group and give the whole group one instruction.
-</td>
-<td width="50%" valign="top">
-<img src="docs/assets/readme-review.jpg" alt="A change shown before and after on the typeset page, with Accept, Reject and Comment">
-<h3>✅ Approve change by change</h3>
-Each edit comes back as a typeset diff, together with the places it moves elsewhere, such as renumbered equations and the table of contents. Accept, reject or comment, and undo any decision.
-</td>
-</tr>
-<tr>
-<td width="50%" valign="top">
-<img src="docs/assets/readme-deliver.jpg" alt="The finished review with an agent-written commit message, Apply to working directory and Commit">
-<h3>📦 Choose where it goes</h3>
-Accepted changes stay inside the task until you finish reviewing. Then apply them to your working directory, or commit them to a separate <code>papilot/…</code> branch with a message the agent writes.
+<a href="docs/assets/readme-note.jpg"><img src="docs/assets/readme-note.jpg" alt="Color-grouped passage notes and a boxed equation note on the PDF"></a>
+<h3>Annotate the PDF</h3>
+Select a sentence or box an equation and say what should change. Group related notes by color to give several passages one instruction.
 </td>
 <td width="50%" valign="top">
-<img src="docs/assets/readme-git.jpg" alt="The Git panel with a staged file, a generated commit message, task worktrees and the commit graph">
-<h3>🌿 Git without leaving the page</h3>
-Stage files and commit them with a message an agent writes, then pull and push. Every task's worktree shows in the commit graph, and an agent can resolve conflicts when you merge a co-author's changes.
+<a href="docs/assets/readme-review.jpg"><img src="docs/assets/readme-review.jpg" alt="Before-and-after typeset diff on the page with Accept, Reject, and Comment buttons"></a>
+<h3>Review each change</h3>
+Compare the typeset pages before and after, including changes elsewhere such as renumbered equations. Accept, reject, or comment on each edit, and undo decisions as you review.
 </td>
 </tr>
 <tr>
 <td width="50%" valign="top">
-<img src="docs/assets/readme-contents.jpg" alt="The PDF viewer with its contents panel open">
-<h3>📖 Read it like a real PDF</h3>
-Jump to any section from the contents, search every page and zoom in sharply. Selecting text picks exactly the printed words.
+<a href="docs/assets/readme-deliver.jpg"><img src="docs/assets/readme-deliver.jpg" alt="Apply accepted edits to the manuscript"></a>
+<h3>Choose where edits go</h3>
+Each new task works on its own copy of the paper. Review the edits, then choose **Commit to manuscript** to save this task as one commit on your current branch, or **Apply to workspace** to leave the edits uncommitted. If the same passage changed meanwhile, AI resolves the conflict automatically and asks you only when the intended content is unclear. Review the merged PDF before saving. Push from the Git panel when you are ready.
 </td>
 <td width="50%" valign="top">
-<h3>🧰 And more</h3>
-<ul>
-<li>✨ <b>Skills</b> such as Polish, Proofread and Check math, one <code>/</code> away. Write your own in Settings.</li>
-<li>📎 <b>Files and images</b> attached to any task or message</li>
-<li>🤖 <b>Codex, Claude, Cursor, Kimi Code, GLM, DeepSeek, Qwen Code, OpenCode or Antigravity</b>: whichever is on your computer, with your own login</li>
-<li>🌳 <b>A Git worktree for every task</b>, up to two running at once</li>
-<li>🌗 <b>Light and dark</b>, in English or Chinese</li>
-<li>📱 <b>Runs on your computer</b>, and you can open it from your phone</li>
-</ul>
+<a href="docs/assets/readme-git.jpg"><img src="docs/assets/readme-git.jpg" alt="Git panel with staged files, generated commit message, and commit graph"></a>
+<h3>Work with Git</h3>
+Stage and commit files, pull, and push from the workspace. An agent can draft commit messages and help resolve merge conflicts; the commit graph shows each task’s worktree.
 </td>
 </tr>
 </table>
 
-## 🚀 Quick start
-
-> [!NOTE]
-> You need **Node.js 22.22+**, **Git** and a full **TeX** distribution ([MacTeX](https://www.tug.org/mactex/) or [TeX Live](https://www.tug.org/texlive/)). Revising also needs one [signed-in agent](#-agents).
-
-```sh
-npm install -g papilot
-papilot demo
-```
-
-Open **http://127.0.0.1:7274** and choose **Manuscript** in the sidebar. The demo adds an example paper to revise: a 26-page LaTeX paper about Papilot itself, full of equations. When you are ready, run `papilot` and choose **Add paper…** from the paper menu to select a LaTeX folder or drop a ZIP. Papilot identifies the main file, prepares Git history and tries compilation, with help for any errors during import.
+- **[Skills](docs/guide.md#skills) and [attachments](docs/guide.md#task-attachments):** Run `/` skills to polish prose, proofread, or check math, define custom skills in Settings, and attach reference files or images to tasks and messages.
+- **Reading and workspace:** Navigate manuscripts with the PDF table of contents and full-text search, with light and dark themes and an English or Chinese interface.
 
-## 🤖 Agents
+## Quick start
 
-| Agent | Sign in once | How Papilot runs it |
-| --- | --- | --- |
-| **Codex** | `papilot codex login` | Through the Codex app server, in its workspace sandbox. Papilot uses your `codex` if you have one, or installs it on first start. |
-| **Claude** | Install [Claude Code](https://code.claude.com) and run `claude auth login`, or start `papilot` with `ANTHROPIC_API_KEY` set | With Claude Code installed, runs `claude -p` on your own login (your Claude plan or a key), in Claude Code's sandbox. Without it, through the Claude Agent SDK, which needs an API key. |
-| **Cursor** | Start `papilot` with `CURSOR_API_KEY` set | Through the Cursor SDK, downloaded the first time, in Cursor's sandbox. The SDK does not use the Cursor app or CLI login. |
-| **Kimi Code** | Install [Kimi Code CLI](https://www.kimi.com/code/docs/en/kimi-code-cli/guides/getting-started) and run `kimi login` | Runs `kimi acp` with your local configuration; streams replies, resumes sessions and forwards tool approvals. |
-| **GLM** | Start `papilot` with `ZHIPU_API_KEY` (or `ZAI_API_KEY`) set | Claude Code on Zhipu's Anthropic-compatible endpoint, as Zhipu documents for GLM Coding Plan. |
-| **DeepSeek** | Install [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`npm install -g @deepseek-ai/dsh`) and set up a model in it | Runs `dsh acp` in its workspace sandbox; anything outside the worktree asks for approval. |
-| **Qwen Code** | Install [Qwen Code](https://github.com/QwenLM/qwen-code) and sign in by running `qwen` | Runs `qwen --acp` in Auto Edit mode: edits go ahead, commands ask for approval. |
-| **OpenCode** | Install [OpenCode](https://opencode.ai) and connect a provider with `opencode auth login` | Runs `opencode acp` with your providers; commands and anything outside the worktree ask for approval. |
-| **Antigravity** | Install Antigravity and sign in to `agy` | `agy -p`, one process per turn, editing files only. If your region needs it, set `PAPILOT_AGY_PROXY`. |
+For the macOS and Linux desktop apps and local build instructions, see [Papilot Desktop](desktop/README.md). Desktop CI builds Apple Silicon and Intel Mac installers, plus Linux x64 AppImage and deb packages.
 
-Papilot finds the agents on your computer by itself and offers only those; Codex is always there. After installing or signing in to one while Papilot is running, select **Reconnect**. If a CLI is not on the server’s `PATH`, point `PAPILOT_KIMI_BIN`, `PAPILOT_DSH_BIN`, `PAPILOT_QWEN_BIN` or `PAPILOT_OPENCODE_BIN` at it. See the [agent guide](docs/guide.md#agents) for what each one supports and the tested versions.
-
-Papilot never stores your credentials. CLI agents use their own login, and a key you set for Claude, Cursor or GLM goes only to that service. An agent that is found but not signed in shows as unavailable.
-
-Having trouble getting started? Open **Settings → Runtime** and choose **Agents** for agent setup or **LaTeX** for the detected distribution, version, and location, or run `papilot doctor` for environment checks and fixes and `papilot doctor --repo /path/to/paper` to check a paper too. Add `--json` for a machine-readable report. Diagnostics do not install software, start the server or change your paper. See the [diagnostics guide](docs/guide.md#diagnostics) for what is checked.
-
-<details>
-<summary><b>⚙️ Options and remote access</b></summary>
-
-<br>
+Papilot requires **Node.js 22.22+**, **Git**, and a full **TeX** distribution with `latexmk` and `synctex` ([MacTeX](https://www.tug.org/mactex/) or [TeX Live](https://www.tug.org/texlive/)). Revising a paper also requires at least one configured [agent](#agents).
 
 ```sh
-papilot --port 4400            # another local port
-papilot --data ~/papilot-data  # keep state somewhere else (default ~/.papilot)
-papilot service install        # macOS: start after login, restart if it exits
-npm uninstall -g papilot       # remove it; your state stays in ~/.papilot until you delete it
-```
-
-When a release is available, **New version** appears next to **Settings**. Click it to install from the browser. Papilot waits for tasks and PDF builds to finish, restarts, and reconnects the page. Updates keep your data and preserve the previous installation for rollback. See [Updates](docs/guide.md#updates).
-
-Papilot listens only on `127.0.0.1`. To use it from another device, publish it on your tailnet with Tailscale Serve and set `PAPILOT_PUBLIC_ORIGIN` and `PAPILOT_TAILSCALE_LOGIN`. Papilot then checks the host, the browser origin and the Tailscale identity of every request. The [guide](docs/guide.md#remote-access-with-tailscale) has the steps.
-
-To invite an advisor or co-authors, give Papilot a public HTTPS address with `PAPILOT_ACCOUNT_ORIGIN` and open **Settings → Sharing**: each person signs in with a passkey and sees only the papers you share. Invite only people you would trust with access to the computer Papilot runs on; see [Collaborators](docs/guide.md#collaborators).
-
-</details>
-
-<details>
-<summary><b>🛠️ Develop</b></summary>
-
-<br>
-
-```sh
-git clone https://github.com/cu1ch3n/papilot && cd papilot
-npm ci && npm run setup:review
-npm run build && npm start
+npm install -g papilot
+papilot demo
 ```
 
-Run `npm run typecheck`, `npm test` and `npm run test:ui` before sending a pull request.
+Open [http://127.0.0.1:7274](http://127.0.0.1:7274) and select **Manuscript** in the sidebar to explore the bundled example paper.
 
-</details>
+To work on your own manuscript, run `papilot` and choose **Add paper…** to open a local LaTeX folder or ZIP archive. Papilot looks for the main `.tex` file, prepares Git history when needed, and attempts compilation. If the main file is ambiguous or the build fails, the import dialog helps you choose a file or fix the problem.
 
-## 📚 Documentation
+Check your setup in **Settings → Runtime**, under **Agents** or **LaTeX**. Run `papilot doctor` for environment checks, or `papilot doctor --repo /path/to/paper` to check a manuscript too ([diagnostics](docs/guide.md#diagnostics)).
 
-The **[guide](docs/guide.md)** covers every part of the workspace, the configuration variables, recovery after restarts, and development. The example paper in [`examples/papilot-paper`](examples/papilot-paper) explains the design in depth, with proofs. What changed in each release is in the [changelog](CHANGELOG.md).
+## Agents
 
-## 💬 Community
+<!-- BEGIN AGENT ICONS -->
+<p align="center">
+  <a href="docs/guide.md#agents">
+    <picture>
+      <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/assets/readme-agents/compact-dark.svg">
+      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme-agents/desktop-dark.svg">
+      <source media="(max-width: 600px)" srcset="docs/assets/readme-agents/compact.svg">
+      <img src="docs/assets/readme-agents/desktop.svg" alt="Codex, Claude, Cursor, Copilot, Grok, Antigravity, Kimi, GLM, DeepSeek, Qwen, OpenCode" width="816">
+    </picture>
+  </a>
+</p>
+<!-- END AGENT ICONS -->
 
-- 💡 **Questions and ideas**: [Discussions](https://github.com/cu1ch3n/papilot/discussions)
-- 🐛 **Something broke**: [open an issue](https://github.com/cu1ch3n/papilot/issues/new/choose)
-- 🤝 **Want to help**: pick a [good first issue](https://github.com/cu1ch3n/papilot/labels/good%20first%20issue) and read [CONTRIBUTING.md](CONTRIBUTING.md)
+You can choose an agent and model for each task. Depending on the integration, Papilot runs agents using their local CLI sign-in or provider API credentials you supply, without storing your keys.
 
-If Papilot saves you time on a paper, a ⭐ helps other researchers find it.
+Open **Settings → Runtime → Agents** to check status, models, and setup instructions (such as `papilot codex login`). Click **Reconnect** after installing or signing in to an agent while Papilot is running, or restart `papilot` after changing environment variables. See the [agent guide](docs/guide.md#agents) for per-agent requirements and capabilities.
 
-<a href="https://github.com/cu1ch3n/papilot/graphs/contributors"><img src="https://contrib.rocks/image?repo=cu1ch3n/papilot" alt="Papilot contributors"></a>
+## Documentation and community
 
-## 🔗 Friends
+- **Documentation:** Read the [User Guide](docs/guide.md) for workspace workflows, configuration, [in-app updates](docs/guide.md#updates), [remote access with Tailscale](docs/guide.md#remote-access-with-tailscale), and [passkey sharing for collaborators](docs/guide.md#collaborators).
+- **Design and history:** Explore [`examples/papilot-paper`](examples/papilot-paper) for the formal design paper and proofs, and check the [Changelog](CHANGELOG.md) for release notes.
+- **Community and support:** Ask questions in [Discussions](https://github.com/PapilotAI/papilot/discussions), report bugs in [Issues](https://github.com/PapilotAI/papilot/issues), or read [CONTRIBUTING.md](CONTRIBUTING.md) to contribute.
 
-[LINUX DO](https://linux.do/)
+---
 
-## 📄 License
+[MIT](LICENSE) © 2026 PapilotAI
 
-[MIT](LICENSE) © 2026 Cui Chen. The bundled review engine in [`vendor/latex-review`](vendor/latex-review) is also MIT-licensed.
+Friends: [LINUX DO](https://linux.do/).

package/README.pt.md

@@ -0,0 +1,110 @@
+<div align="center">
+
+<h1>
+  <img src="docs/assets/wordmark.svg#gh-light-mode-only" width="280" height="88" alt="Papilot">
+  <img src="docs/assets/wordmark-dark.svg#gh-dark-mode-only" width="280" height="88" alt="Papilot">
+</h1>
+
+<p><b>Aprimore artigos em LaTeX com IA e revise as alterações no PDF.</b></p>
+
+<p><a href="https://papilot.ai">Site</a> · <a href="docs/guide.md">Documentação</a></p>
+
+<p data-language-switcher><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-Hant.md">繁體中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.it.md">Italiano</a> · <a href="README.sv.md">Svenska</a></p>
+
+[![CI](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml/badge.svg)](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/papilot?color=2563eb&logo=npm)](https://www.npmjs.com/package/papilot)
+[![License: MIT](https://img.shields.io/badge/license-MIT-2563eb)](LICENSE)
+
+<p><img src="docs/assets/demo.gif" alt="Papilot: marque um trecho no PDF, entregue a um agente e revise a alteração diagramada" width="100%"></p>
+
+</div>
+
+O Papilot é um espaço de trabalho local para escrever e aprimorar artigos em LaTeX com agentes de IA. Marque trechos e equações no PDF, deixe um agente editar uma cópia separada do código-fonte e, em seguida, revise as alterações diagramadas e escolha quais manter.
+
+<a id="features"></a>
+
+## Funcionalidades
+
+<table>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-note.jpg"><img src="docs/assets/readme-note.jpg" alt="Anotações de trechos agrupadas por cor e uma anotação de equação emoldurada no PDF"></a>
+<h3>Faça anotações no PDF</h3>
+Selecione uma frase ou contorne uma equação e indique o que deve mudar. Agrupe anotações relacionadas por cor para aplicar uma mesma instrução a vários trechos.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-review.jpg"><img src="docs/assets/readme-review.jpg" alt="Comparação visual de antes e depois na página diagramada com botões Aceitar, Rejeitar e Comentar"></a>
+<h3>Revise cada alteração</h3>
+Compare as páginas diagramadas antes e depois, incluindo alterações em outras partes, como equações renumeradas. Aceite, rejeite ou comente cada edição e desfaça decisões durante a revisão.
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-deliver.jpg"><img src="docs/assets/readme-deliver.jpg" alt="Aplicar edições aceitas ao manuscrito"></a>
+<h3>Escolha o destino das edições</h3>
+Cada nova tarefa funciona em sua própria cópia do artigo. Revise as edições e escolha **Fazer commit no manuscrito** para salvar a tarefa como um único commit no branch atual, ou **Aplicar ao espaço de trabalho** para manter as edições sem commit. Se o mesmo trecho tiver sido alterado nesse meio-tempo, a IA resolve o conflito automaticamente e só pergunta a você quando o conteúdo pretendido não estiver claro. Revise o PDF mesclado antes de salvar. Faça push pelo painel do Git quando estiver tudo pronto.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-git.jpg"><img src="docs/assets/readme-git.jpg" alt="Painel do Git com arquivos preparados, mensagem de commit gerada e grafo de commits"></a>
+<h3>Trabalhe com o Git</h3>
+Prepare arquivos e faça commit, pull e push diretamente do espaço de trabalho. Um agente pode redigir mensagens de commit e ajudar a resolver conflitos de mesclagem; o grafo de commits mostra a árvore de trabalho de cada tarefa.
+</td>
+</tr>
+</table>
+
+- **[Habilidades](docs/guide.md#skills) e [anexos](docs/guide.md#task-attachments):** Execute habilidades com `/` para aprimorar a redação, revisar o texto ou verificar expressões matemáticas, defina habilidades personalizadas nas Configurações e anexe arquivos de referência ou imagens a tarefas e mensagens.
+- **Leitura e espaço de trabalho:** Navegue pelos manuscritos usando o sumário do PDF e a busca em texto completo, com temas claro e escuro e interface em inglês ou chinês.
+
+<a id="quick-start"></a>
+
+## Início rápido
+
+Para os aplicativos desktop para macOS e Linux e as instruções de compilação local, consulte [Papilot Desktop](desktop/README.md). O CI do aplicativo desktop gera instaladores para Mac com Apple Silicon e Intel, além de pacotes AppImage e deb para Linux x64.
+
+O Papilot requer **Node.js 22.22+**, **Git** e uma distribuição **TeX** completa com `latexmk` e `synctex` ([MacTeX](https://www.tug.org/mactex/) ou [TeX Live](https://www.tug.org/texlive/)). A revisão de um artigo também requer pelo menos um [agente](#agents) configurado.
+
+```sh
+npm install -g papilot
+papilot demo
+```
+
+Abra [http://127.0.0.1:7274](http://127.0.0.1:7274) e selecione **Manuscrito** na barra lateral para explorar o artigo de exemplo incluído.
+
+Para trabalhar em seu próprio manuscrito, execute `papilot` e escolha **Adicionar artigo…** para abrir uma pasta LaTeX local ou um arquivo ZIP. O Papilot procura o arquivo `.tex` principal, prepara o histórico do Git quando necessário e tenta realizar a compilação. Se o arquivo principal for ambíguo ou a compilação falhar, a janela de importação ajudará você a escolher um arquivo ou corrigir o problema.
+
+Verifique sua configuração em **Configurações → Ambiente de execução**, em **Agentes** ou **LaTeX**. Execute `papilot doctor` para verificações do ambiente ou `papilot doctor --repo /path/to/paper` para verificar também um manuscrito ([diagnóstico](docs/guide.md#diagnostics)).
+
+<a id="agents"></a>
+
+## Agentes
+
+<!-- BEGIN AGENT ICONS -->
+<p align="center">
+  <a href="docs/guide.md#agents">
+    <picture>
+      <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/assets/readme-agents/compact-dark.svg">
+      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme-agents/desktop-dark.svg">
+      <source media="(max-width: 600px)" srcset="docs/assets/readme-agents/compact.svg">
+      <img src="docs/assets/readme-agents/desktop.svg" alt="Codex, Claude, Cursor, Copilot, Grok, Antigravity, Kimi, GLM, DeepSeek, Qwen, OpenCode" width="816">
+    </picture>
+  </a>
+</p>
+<!-- END AGENT ICONS -->
+
+Você pode escolher um agente e um modelo para cada tarefa. Dependendo da integração, o Papilot executa os agentes usando a autenticação da CLI local de cada um ou as credenciais de API do provedor fornecidas por você, sem armazenar suas chaves.
+
+Abra **Configurações → Ambiente de execução → Agentes** para verificar o status, os modelos e as instruções de configuração (como `papilot codex login`). Clique em **Reconectar** após instalar ou fazer login em um agente enquanto o Papilot estiver em execução, ou reinicie o `papilot` após alterar variáveis de ambiente. Consulte o [guia de agentes](docs/guide.md#agents) para ver os requisitos e recursos de cada agente.
+
+<a id="documentation-and-community"></a>
+
+## Documentação e comunidade
+
+- **Documentação:** Leia o [Guia do Usuário](docs/guide.md) para conhecer os fluxos de trabalho do espaço de trabalho, a configuração, as [atualizações no aplicativo](docs/guide.md#updates), o [acesso remoto com Tailscale](docs/guide.md#remote-access-with-tailscale) e o [compartilhamento de chaves de acesso para colaboradores](docs/guide.md#collaborators).
+- **Arquitetura e histórico:** Explore [`examples/papilot-paper`](examples/papilot-paper) para ler o artigo formal de projeto e as demonstrações, e consulte o [Changelog](CHANGELOG.md) para ver as notas de lançamento.
+- **Comunidade e suporte:** Tire dúvidas em [Discussions](https://github.com/PapilotAI/papilot/discussions), relate problemas em [Issues](https://github.com/PapilotAI/papilot/issues) ou leia [CONTRIBUTING.md](CONTRIBUTING.md) para contribuir.
+
+---
+
+[MIT](LICENSE) © 2026 PapilotAI
+
+Amigos: [LINUX DO](https://linux.do/).

package/README.sv.md

@@ -0,0 +1,110 @@
+<div align="center">
+
+<h1>
+  <img src="docs/assets/wordmark.svg#gh-light-mode-only" width="280" height="88" alt="Papilot">
+  <img src="docs/assets/wordmark-dark.svg#gh-dark-mode-only" width="280" height="88" alt="Papilot">
+</h1>
+
+<p><b>Revidera LaTeX-artiklar med AI och granska ändringarna i PDF:en.</b></p>
+
+<p><a href="https://papilot.ai">Webbplats</a> · <a href="docs/guide.md">Dokumentation</a></p>
+
+<p data-language-switcher><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-Hant.md">繁體中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.it.md">Italiano</a> · <a href="README.sv.md">Svenska</a></p>
+
+[![CI](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml/badge.svg)](https://github.com/PapilotAI/papilot/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/papilot?color=2563eb&logo=npm)](https://www.npmjs.com/package/papilot)
+[![License: MIT](https://img.shields.io/badge/license-MIT-2563eb)](LICENSE)
+
+<p><img src="docs/assets/demo.gif" alt="Papilot: markera ett avsnitt i PDF:en, lämna över det till en agent och granska den typsatta ändringen" width="100%"></p>
+
+</div>
+
+Papilot är en lokal arbetsyta för att skriva och revidera LaTeX-artiklar med AI-agenter. Markera avsnitt och ekvationer i PDF:en, låt en agent redigera en separat kopia av källkoden, granska sedan de typsatta ändringarna och välj vilka du vill behålla.
+
+<a id="features"></a>
+
+## Funktioner
+
+<table>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-note.jpg"><img src="docs/assets/readme-note.jpg" alt="Färggrupperade avsnittsanteckningar och en inramad ekvationsanteckning i PDF:en"></a>
+<h3>Annotera PDF:en</h3>
+Markera en mening eller rama in en ekvation och beskriv vad som ska ändras. Gruppera relaterade anteckningar efter färg för att ge flera avsnitt en gemensam instruktion.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-review.jpg"><img src="docs/assets/readme-review.jpg" alt="Typsatt jämförelse före och efter på sidan med knapparna Godkänn, Avvisa och Kommentera"></a>
+<h3>Granska varje ändring</h3>
+Jämför de typsatta sidorna före och efter, inklusive följdändringar på andra ställen såsom omnumrerade ekvationer. Godkänn, avvisa eller kommentera varje ändring och ångra beslut under granskningen.
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-deliver.jpg"><img src="docs/assets/readme-deliver.jpg" alt="Tillämpa godkända ändringar i manuskriptet"></a>
+<h3>Välj var ändringarna hamnar</h3>
+Varje ny uppgift arbetar på en egen kopia av artikeln. Granska ändringarna och välj sedan **Committa till manuskript** för att spara denna uppgift som en commit på din aktuella gren, eller **Tillämpa i arbetsytan** för att lämna ändringarna utan commit. Om samma avsnitt har ändrats under tiden löser AI:n konflikten automatiskt och frågar dig endast när det avsedda innehållet är oklart. Granska den sammanfogade PDF:en innan du sparar. Gör en push från Git-panelen när du är redo.
+</td>
+<td width="50%" valign="top">
+<a href="docs/assets/readme-git.jpg"><img src="docs/assets/readme-git.jpg" alt="Git-panel med stageade filer, genererat commit-meddelande och commit-graf"></a>
+<h3>Arbeta med Git</h3>
+Stagea och committa filer samt gör pull och push från arbetsytan. En agent kan skriva utkast till commit-meddelanden och hjälpa till att lösa sammanslagningskonflikter; commit-grafen visar varje uppgifts arbetsträd.
+</td>
+</tr>
+</table>
+
+- **[Färdigheter](docs/guide.md#skills) och [bilagor](docs/guide.md#task-attachments):** Kör `/`-färdigheter för att finslipa prosa, korrekturläsa eller kontrollera matematik, definiera egna färdigheter i Inställningar och bifoga referensfiler eller bilder till uppgifter och meddelanden.
+- **Läsning och arbetsyta:** Navigera i manuskript med PDF:ens innehållsförteckning och fulltextsökning, med ljust och mörkt tema samt ett gränssnitt på engelska eller kinesiska.
+
+<a id="quick-start"></a>
+
+## Snabbstart
+
+För skrivbordsapparna till macOS och Linux samt instruktioner för att bygga lokalt, se [Papilot Desktop](desktop/README.md). Desktop CI bygger installationsprogram för Apple Silicon- och Intel-Mac, samt x64 AppImage- och deb-paket för Linux.
+
+Papilot kräver **Node.js 22.22+**, **Git** och en fullständig **TeX**-distribution med `latexmk` och `synctex` ([MacTeX](https://www.tug.org/mactex/) eller [TeX Live](https://www.tug.org/texlive/)). För att revidera en artikel krävs även minst en konfigurerad [agent](#agents).
+
+```sh
+npm install -g papilot
+papilot demo
+```
+
+Öppna [http://127.0.0.1:7274](http://127.0.0.1:7274) och välj **Manuskript** i sidofältet för att utforska den medföljande exempelartikeln.
+
+För att arbeta med ditt eget manuskript kör du `papilot` och väljer **Lägg till artikel…** för att öppna en lokal LaTeX-mapp eller ett ZIP-arkiv. Papilot letar efter den huvudsakliga `.tex`-filen, förbereder Git-historik vid behov och försöker kompilera. Om huvudfilen är tvetydig eller om bygget misslyckas hjälper importdialogen dig att välja en fil eller åtgärda problemet.
+
+Kontrollera din konfiguration i **Inställningar → Körmiljö**, under **Agenter** eller **LaTeX**. Kör `papilot doctor` för miljökontroller, eller `papilot doctor --repo /path/to/paper` för att även kontrollera ett manuskript ([diagnostik](docs/guide.md#diagnostics)).
+
+<a id="agents"></a>
+
+## Agenter
+
+<!-- BEGIN AGENT ICONS -->
+<p align="center">
+  <a href="docs/guide.md#agents">
+    <picture>
+      <source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/assets/readme-agents/compact-dark.svg">
+      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme-agents/desktop-dark.svg">
+      <source media="(max-width: 600px)" srcset="docs/assets/readme-agents/compact.svg">
+      <img src="docs/assets/readme-agents/desktop.svg" alt="Codex, Claude, Cursor, Copilot, Grok, Antigravity, Kimi, GLM, DeepSeek, Qwen, OpenCode" width="816">
+    </picture>
+  </a>
+</p>
+<!-- END AGENT ICONS -->
+
+Du kan välja en agent och modell för varje uppgift. Beroende på integrationen kör Papilot agenter via deras lokala CLI-inloggning eller med API-uppgifter från leverantören som du anger, utan att lagra dina nycklar.
+
+Öppna **Inställningar → Körmiljö → Agenter** för att kontrollera status, modeller och installationsanvisningar (till exempel `papilot codex login`). Klicka på **Anslut igen** efter att du har installerat eller loggat in i en agent medan Papilot körs, eller starta om `papilot` efter att ha ändrat miljövariabler. Se [agentguiden](docs/guide.md#agents) för krav och funktioner för respektive agent.
+
+<a id="documentation-and-community"></a>
+
+## Dokumentation och gemenskap
+
+- **Dokumentation:** Läs [användarhandboken](docs/guide.md) för arbetsflöden i arbetsytan, konfiguration, [uppdateringar i appen](docs/guide.md#updates), [fjärråtkomst med Tailscale](docs/guide.md#remote-access-with-tailscale) och [delning av passkeys för samarbetspartner](docs/guide.md#collaborators).
+- **Design och historik:** Utforska [`examples/papilot-paper`](examples/papilot-paper) för den formella designartikeln och bevisen, och läs [ändringsloggen](CHANGELOG.md) för versionsinformation.
+- **Gemenskap och support:** Ställ frågor i [Discussions](https://github.com/PapilotAI/papilot/discussions), rapportera fel i [Issues](https://github.com/PapilotAI/papilot/issues) eller läs [CONTRIBUTING.md](CONTRIBUTING.md) för att bidra.
+
+---
+
+[MIT](LICENSE) © 2026 PapilotAI
+
+Vänner: [LINUX DO](https://linux.do/).