0.2.5

Glean v0.2.5 Release Notes

Highlights

This release introduces MCP (Model Context Protocol) server support, enabling AI assistants (e.g., Claude Desktop) to search and interact with your Glean RSS subscriptions. A full API token management system was added to support secure authentication for MCP clients.

🚀 New Features

MCP Server

A built-in MCP server exposing Glean's core functionality to LLM clients via Streamable HTTP transport. Available tools:

• search_entries — Search articles by keyword across title, content, and summary
• get_entry — Retrieve full details of a specific article
• list_entries_by_date — List articles within a date range, with optional read status and feed filters
• list_subscriptions — List RSS feed subscriptions with unread counts

API Token Management

A complete token lifecycle system for MCP authentication:

• Create named, long-lived API tokens with optional expiration (30 days / 90 days / 1 year / never)
• Tokens are hashed with bcrypt at rest; the plain token is only shown once upon creation
• List, revoke tokens, and automatically track last-used timestamps

Settings UI — API Tokens Tab

A new tab in the Settings page for managing API tokens from the browser:

• Token creation dialog with name and expiration options
• One-click copy-to-clipboard for newly created tokens
• Revocation with confirmation dialog
• Built-in MCP configuration guide showing Claude Desktop JSON config with the current domain auto-filled

Glean v0.2.5 发布说明

亮点

本次发布引入了 MCP（Model Context Protocol）服务器支持，使 AI 助手（如 Claude Desktop）可以搜索和访问你在 Glean 中订阅的 RSS 内容。同时新增了完整的 API Token 管理系统，用于 MCP 客户端的安全认证。

🚀 新功能

MCP 服务器

内置 MCP 服务器，通过 Streamable HTTP 传输协议向 LLM 客户端暴露 Glean 核心功能。可用工具：

• search_entries — 按关键词搜索文章，匹配标题、正文和摘要
• get_entry — 获取指定文章的完整详情
• list_entries_by_date — 按日期范围列出文章，支持已读状态和订阅源筛选
• list_subscriptions — 列出 RSS 订阅源及未读数量

API Token 管理

为 MCP 认证提供完整的令牌生命周期管理：

• 创建命名的长期有效 API Token，可选过期时间（30 天 / 90 天 / 1 年 / 永不过期）
• Token 以 bcrypt 哈希存储，明文仅在创建时展示一次
• 支持列出、吊销令牌，并自动记录最近使用时间

设置页面 — API Tokens 标签页

在设置页面新增标签页，可在浏览器中管理 API Token：

• Token 创建对话框，支持设置名称和过期时间
• 新创建的 Token 支持一键复制到剪贴板
• 吊销操作带确认对话框
• 内置 MCP 配置指南，展示 Claude Desktop JSON 配置示例并自动填充当前域名

Full Changelog: v0.2.4...v0.2.5

⚠️ v0.2.5-alpha.4 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.4
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.4
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.4

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.4

  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.4

  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.4

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

Full Changelog: v0.2.5-alpha.3...v0.2.5-alpha.4

⚠️ v0.2.5-alpha.3 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.3
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.3
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.3

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.3

  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.3

  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.3

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

Full Changelog: v0.2.5-alpha.2...v0.2.5-alpha.3

⚠️ v0.2.5-alpha.2 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.2
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.2
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.2

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.2

  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.2

  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.2

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

Full Changelog: v0.2.5-alpha.1...v0.2.5-alpha.2

⚠️ v0.2.5-alpha.1 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.1
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.1
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.1

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.5-alpha.1

  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.5-alpha.1

  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.5-alpha.1

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

Full Changelog: v0.2.4...v0.2.5-alpha.1

0.2.4

Glean v0.2.4 Release Notes

🚀 New Features

Desktop & PWA Support

• Electron Desktop App: Native desktop application support for Windows, macOS, and Linux
• Progressive Web App (PWA): Install Glean as a standalone app on mobile and desktop browsers
• Improved Server Configuration: Enhanced API configuration dialog with health checks, timeout management, and URL validation

User Management

• Default Admin Account: Automatically creates default admin account on first startup for easier deployment
• Admin Creation Script: New command-line script for creating admin users (backend/scripts/create-admin.py)
• Simplified Setup: Removed password strength requirements for more flexible user management

UI/UX Enhancements

• Enhanced Mobile Navigation: Improved mobile UI with better transitions and navigation experience
• Article Reader Improvements: Enhanced button visibility and accessibility in ArticleReader and sidebar components
• Smart Sorting: Optimized smart sorting logic for folders and feeds
• Better Layout: Improved settings page layout with adjusted grid spacing

🐛 Bug Fixes

• Settings UI: Fixed overlapping appearance selector in settings page
• Smart Filters: Clarified smart filter behavior and updated conditional rendering in ReaderPage
• Electron Build: Resolved Electron build issues
• Deployment: Fixed deployment-related issues
• Session Management: Updated session management in create-admin script

📚 Documentation

• Updated Best Practices: Added guidelines for using window vs globalThis in browser-specific APIs
• Deployment Guide: Enhanced deployment documentation with new admin account setup instructions
• Improved Comments: Enhanced code comments to clarify filter behavior

---

Glean v0.2.4 发布说明

🚀 新功能

桌面端与 PWA 支持

• Electron 桌面应用：支持 Windows、macOS 和 Linux 原生桌面应用
• 渐进式 Web 应用 (PWA)：可在移动端和桌面浏览器上安装为独立应用
• 改进的服务器配置：增强 API 配置对话框，支持健康检查、超时管理和 URL 验证

用户管理

• 默认管理员账户：首次启动时自动创建默认管理员账户，简化部署流程
• 管理员创建脚本：新增命令行脚本用于创建管理员用户 (backend/scripts/create-admin.py)
• 简化设置：移除密码强度要求，提供更灵活的用户管理

界面与交互优化

• 增强的移动端导航：改进移动端界面，优化过渡动画和导航体验
• 文章阅读器改进：增强文章阅读器和侧边栏组件的按钮可见性和可访问性
• 智能排序：优化文件夹和订阅源的智能排序逻辑
• 布局优化：改进设置页面布局，调整网格间距

🐛 错误修复

• 设置界面：修复设置页面中外观选择器重叠的问题
• 智能过滤器：明确智能过滤器行为，更新 ReaderPage 中的条件渲染
• Electron 构建：解决 Electron 构建问题
• 部署问题：修复部署相关问题
• 会话管理：更新创建管理员脚本中的会话管理

📚 文档

• 最佳实践更新：添加在浏览器特定 API 中使用 window 与 globalThis 的指南
• 部署指南：增强部署文档，添加新的管理员账户设置说明
• 注释改进：增强代码注释以阐明过滤器行为

🔧 依赖更新

• 更新 react-i18next 至 v16.5.3
• 更新 typescript-eslint 至 v8.53.0
• 更新 turbo 至 v2.7.4
• 更新 zod 至 v4.3.5
• 更新 @tanstack/react-query 至 v5.90.16
• 更新 react-hook-form 至 v7.69.0

Full Changelog: v0.2.3...v0.2.4

⚠️ v0.2.4-alpha.1 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.4-alpha.1
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.4-alpha.1
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.4-alpha.1

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.4-alpha.1

  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.4-alpha.1

  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.4-alpha.1

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

What's Changed

• chore(deps): update dependency react-hook-form to v7.69.0 by @renovate[bot] in #82
• chore(deps): update dependency turbo to v2.7.2 by @renovate[bot] in #84
• chore(deps): update typescript-eslint monorepo to v8.50.1 by @renovate[bot] in #81
• feat: enable default admin account creation on first startup by @LeslieLeung in #88
• feat: improve electron server setting experience by @LeslieLeung in #87
• feat: add script for creating admin user by @LeslieLeung in #94
• chore(deps): update dependency zod to v4.3.5 by @renovate[bot] in #93
• chore(deps): update dependency @tanstack/react-query to v5.90.16 - autoclosed by @renovate[bot] in #90

Full Changelog: v0.2.3...v0.2.4-alpha.1

0.2.3

Glean v0.2.3 Release Notes

🚀 New Features

Full-Text Content Extraction

• Bookmark Full-Text Content: Automatically extract and display full article content for bookmarks, making it easier to read and search saved content
• RSS Full Content Support: Enhanced RSS parser to extract complete article content from feeds
• Improved HTML Processing: Better handling of HTML content with inline code formatting support

Security & Code Quality

• XSS Protection: Added HTML sanitization with DOMPurify to prevent cross-site scripting attacks
• Pre-commit Checks: Implemented automated code quality checks before commits

🐛 Bug Fixes

• Embedding System: Fixed Milvus connection issues and race conditions that caused "collection not found" errors
• Database Sessions: Resolved database session management issues in embedding functionality
• HTML Processing: Removed duplicate scripts and improved HTML content processing
• Admin UI Settings: Updated embedding functionality and admin UI settings

---

Glean v0.2.3 发布说明

🚀 新功能

全文内容提取

• 书签全文内容：自动提取并显示书签的完整文章内容，让阅读和搜索保存的内容更加便捷
• RSS 全文支持：增强 RSS 解析器，可从订阅源中提取完整的文章内容
• 改进的 HTML 处理：更好地处理 HTML 内容，支持行内代码格式化

安全性与代码质量

• XSS 防护：使用 DOMPurify 添加 HTML 清理功能，防止跨站脚本攻击
• 提交前检查：实现提交前自动代码质量检查

🐛 错误修复

• 嵌入系统：修复 Milvus 连接问题和竞态条件导致的"集合未找到"错误
• 数据库会话：解决嵌入功能中的数据库会话管理问题
• HTML 处理：移除重复脚本，改进 HTML 内容处理
• 管理界面设置：更新嵌入功能和管理界面设置

Docker Images

This release includes the following Docker images:

• ghcr.io/LeslieLeung/glean-backend:v0.2.3
• ghcr.io/LeslieLeung/glean-web:v0.2.3
• ghcr.io/LeslieLeung/glean-admin:v0.2.3

Desktop Apps

Download the desktop application for your platform from the assets below.

Quick Start

# Download docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/LeslieLeung/glean/main/docker-compose.yml -o docker-compose.yml

# Start Glean
docker compose up -d

# Access at http://localhost

See README for full documentation.

What's Changed

• chore(deps): update actions/checkout action to v6 by @renovate[bot] in #50
• chore(deps): update actions/setup-node action to v6 by @renovate[bot] in #51
• chore(deps): update dependency pnpm to v10 by @renovate[bot] in #54
• chore(deps): update softprops/action-gh-release action to v2 by @renovate[bot] in #62
• chore(deps): update dependency node to v24 by @renovate[bot] in #53
• chore(deps): update pnpm/action-setup action to v4 by @renovate[bot] in #55
• chore(deps): update actions/cache action to v5 by @renovate[bot] in #49
• fix(deps): update dependency i18next-browser-languagedetector to v8 by @renovate[bot] in #65
• fix: milvus connection; collection not found due to race conditions by @LeslieLeung in #67
• fix(deps): update dependency date-fns to v4 by @renovate[bot] in #63
• fix(deps): update dependency i18next to v25 by @renovate[bot] in #64
• fix(deps): update dependency react-i18next to v16 by @renovate[bot] in #66
• chore(deps): update dependency zod to v4.2.1 by @renovate[bot] in #69
• feat: add pre release workflow by @LeslieLeung in #70
• fix: db session by @LeslieLeung in #75
• Fix db session and admin UI improvement by @LeslieLeung in #78
• chore: bump version to 0.2.3-alpha.3 by @LeslieLeung in #79
• Extract Full-text by @LeslieLeung in #80
• chore(deps): update pnpm to v10.26.2 by @renovate[bot] in #72
• fix(deps): update dependency lucide-react to ^0.562.0 by @renovate[bot] in #77
• chore(deps): update dependency react-router-dom to v7.11.0 by @renovate[bot] in #73
• chore(deps): update dependency eslint-plugin-react-refresh to v0.4.26 by @renovate[bot] in #68
• chore: bump version to 0.2.3 by @LeslieLeung in #83

Full Changelog: v0.2.2...v0.2.3

⚠️ v0.2.3-alpha.3 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.3-alpha.3
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.3-alpha.3
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.3-alpha.3

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.3-alpha.3
  
  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.3-alpha.3
  
  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.3-alpha.3

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

What's Changed

• Fix db session and admin UI improvement by @LeslieLeung in #78
• chore: bump version to 0.2.3-alpha.3 by @LeslieLeung in #79

Full Changelog: v0.2.3-alpha.2...v0.2.3-alpha.3

⚠️ v0.2.3-alpha.2 (Alpha)

⚠️ This is a Alpha

Warning: This is a pre-release version intended for testing purposes only.
Do not use in production environments.

Docker Images

This pre-release includes the following Docker images:

# Pull images
docker pull ghcr.io/LeslieLeung/glean-backend:v0.2.3-alpha.2
docker pull ghcr.io/LeslieLeung/glean-web:v0.2.3-alpha.2
docker pull ghcr.io/LeslieLeung/glean-admin:v0.2.3-alpha.2

Testing with Docker Compose

Create a docker-compose.override.yml file:

version: '3.8'

services:
  backend:
    image: ghcr.io/LeslieLeung/glean-backend:v0.2.3-alpha.2
  
  web:
    image: ghcr.io/LeslieLeung/glean-web:v0.2.3-alpha.2
  
  admin:
    image: ghcr.io/LeslieLeung/glean-admin:v0.2.3-alpha.2

Then run:

docker compose up -d

Desktop Apps

Download the desktop application for your platform from the assets below.

Note: Desktop apps for pre-release versions will NOT auto-update.

Feedback

Found an issue? Please report it at:
https://github.com/LeslieLeung/glean/issues

---

Changelog

What's Changed

• fix: db session by @LeslieLeung in #75

Full Changelog: v0.2.3-alpha.1...v0.2.3-alpha.2