Glossa

Your vault, in context. Your edits, under control.

A local-first AI workspace for reading, researching, and changing real notes without losing sight of the source.

中文说明 · Latest release · Changelog

Glossa turns the sidebar into a working surface, not a separate chatbot. The active note can enter context automatically, explicit attachments stay grounded as the task target, and every file-changing action goes through visible tools and approval rules.

What Glossa Does

What's New

• 2026-07-25 — Browse the workspace, then edit it as one safe transaction. 0.7.3 adds the folder discovery requested in Issue #1: the Agent can list bounded, filtered vault-relative paths inside user-selected workspace folders, then pass them directly to note, PDF, and edit tools. Same-turn edits to one file now share one diff, approval, and write; multi-file patches are fully prepared and fingerprinted before the first write, with rollback on any failure. The unified edit engine preserves BOMs, line endings, trailing newlines, and Unicode while making fuzzy matching an explicit high-confidence last resort. Cropped native PDFs, provider-reported token usage, context breakdowns, compact outgoing links, and race-safe screenshot paste reduce extra work without weakening approvals.
• 2026-07-22 — Translation keeps its place and typesets the math. 0.7.2 keeps the quick-translation panel available while its source document scrolls, pins it to the visible top edge after the selection passes out of view, and leaves sidebars, ribbons, and menus usable without dismissing it. Clearly flattened PDF notation is reconstructed as Obsidian-compatible LaTeX and rendered once after streaming completes; ordinary prose stays on the fast text path, and a missing math delimiter can trigger at most one focused correction.
• 2026-07-22 — Translation can now meet you at the selection. 0.7.1 adds three deliberate trigger modes: keep selection translation off, show a clear Glossa action beside a stable selection, or translate each new PDF, Markdown, or HTML selection automatically after 350 ms. The translation window carries its own Auto switch, URL/formula/code-only selections are filtered before any request, sidebar streaming no longer closes an active translation, and dropped images can no longer leak into the PDF behind the composer. Release provenance is also restored safely: main.js and styles.css receive separate attestations that are verified before upload.
• 2026-07-20 — Quick translation now stays readable without losing the source. 0.7.0 lets the streaming translation panel grow with its answer before scrolling, then move or resize within the visible workspace. Native PDF selection remains highlighted while the panel is open, and a conservative text-layer boundary repair prevents high-zoom selections such as training from becoming a neighboring fragment such as e trainin. Compatibility returns to app version 1.12.0, with searchable settings still enabled automatically on 1.13 and newer.
• 2026-07-17 — Settings search and release checks now agree with the host. 0.6.11 adopts the 1.13 declarative settings index, so model, translation, Agent, context, tool, privacy, and storage options can be found from settings search without replacing Glossa's task-focused layout. Selection geometry now stays fully typed under the directory scanner, deprecated controls are gone, and GitHub Actions publishes freshly validated standard assets without the shared multi-file attestation bundle rejected by the plugin directory verifier. This release requires app version 1.13.0 or newer.
• 2026-07-17 — Translate where you are, without adding another chat turn. 0.6.10 opens a focused, streaming translation panel beside selected text after a double press of Enter or an assigned hotkey. Paper titles and technical terms choose the right Chinese/English target more reliably, PDF line wraps are cleaned without flattening real paragraphs, and translation can use a dedicated endpoint and model instead of the sidebar model. Saved translations and PDF markers remain out of this release while their interaction design is refined separately.
• 2026-07-13 — ✅ Community checks are now part of the build, not an afterthought. 0.6.9 adds the official eslint-plugin-obsidianmd rules to the same zero-warning gate as strict TypeScript lint, tests, dependency audit, production build, source review, CSS compatibility, and release metadata. Settings headings and DOM helpers now follow host conventions; native HTTP and DNS fallbacks validate every value crossing the Node bridge; Web Crypto handles hashes; and regression tests keep browser-first networking, private-address blocking, and older-WebView CSS compatibility intact.
• 2026-07-12 — 🎛️ Settings that explain themselves. 0.6.8 reorganizes configuration into five task-focused areas: General, Models & web, Agent, Tools & Skills, and Data & advanced. A compact status header keeps the active model, mode, and Auto/EN/中文 language control visible, while one keyboard-accessible selector keeps labels, checkmarks, arrows, and row geometry aligned throughout the plugin.
• 2026-07-12 — 🧩 Every tool and Skill is visible before you trust it. The new searchable capability catalog shows which tools load by default, which arrive on demand, what can run automatically, what requires approval, and which actions are read-only. Bundled and vault Skills expose their source, trigger guidance, required tools, and validation status instead of behaving like an opaque prompt folder.
• 2026-07-12 — 🧠 Reasoning controls no longer second-guess you. Choose off, none, minimal, low, medium, high, xhigh, max, or ultra. OpenAI-compatible requests send the selected value unchanged, off omits the field, Anthropic-style endpoints use explicit budgets, and an unsupported model or gateway returns its real error with the attempted effort identified. Export chat and Settings also have direct header buttons instead of living behind a generic overflow menu.

Typical Workflows

Open a paper
  -> ask for the method or a figure
  -> Glossa chooses text pages or visual evidence
  -> answer stays grounded to page-level content

Name a public paper and a vault folder
  -> bounded source discovery
  -> title and response validation
  -> save the real PDF
  -> inspect the downloaded paper

Request a note change
  -> read only the relevant source
  -> preview and approve the edit
  -> write the smallest patch
  -> verify the changed region

Context That Behaves Naturally

• The active Markdown note is refreshed when the request is sent.
• A named attachment or explicit selection is treated as the primary target.
• Source language and response language are separate, so an English paper does not override a Chinese request.
• Long chats keep recent evidence complete, compact older tool output, and preserve corrections, URLs, paths, failures, and next actions.
• Persisted chat data strips repeated image payloads and model-only context while keeping useful text and metadata.

Safety by Design

• Plan mode and read-only permissions are the conservative starting point.
• Write approvals can be scoped by tool, path, folder, or session.
• Checkpoints snapshot affected files before destructive edits.
• Network tools use bounded responses, redirect checks, private-network blocking, and explicit download intent.
• Validated downloads enforce size limits and file signatures before writing.
• Community builds do not execute shell commands, read system identity, or use direct system filesystem access.

Glossa itself is not a hosted AI service. Conversation content and selected context are sent to the model endpoint you configure; web content is accessed only for the web action being performed. See Privacy and Security for the exact boundaries.

Install

Plugin Marketplace

Open Settings → Community plugins → Browse, search for Glossa, then install and enable it.

Open Glossa in the plugin marketplace

GitHub Release

Download main.js, manifest.json, and styles.css from the latest release, then place them in:

<your-vault>/.obsidian/plugins/glossa/

Reload the app and enable Glossa under Community plugins.

Start in a Minute

1. Open Glossa from the ribbon or command palette.
2. Add an OpenAI-compatible, Anthropic-compatible, or local HTTP model endpoint.
3. Open a note, attach a file with @, or select text.
4. Ask directly. Stay in Plan for read-only work; switch to Act when you want file changes.
5. Review approvals before writes or downloads.

Build and Verify

git clone https://github.com/yiiwang118/obsidian-glossa.git
cd obsidian-glossa
npm install
npm run check

npm run check runs TypeScript checks, review and strict lint, directive auditing, the complete test suite, dependency audit, production build, generated-bundle review scanning, and release metadata validation.

For development builds:

GLOSSA_PLUGIN_DIR="/path/to/vault/.obsidian/plugins/glossa" npm run dev

Project

• Desktop-only in the current release.
• Compatible with app version 1.12.0 and newer; settings search is enhanced automatically on 1.13+.
• New installations default to Plan mode with read-only permissions.
• Release assets are rebuilt and validated by GitHub Actions before publication.
• Issues and focused, reproducible bug reports are welcome.
• This open-source project recognizes the LINUX DO community.

License

MIT © yiiwang