fix

Model validation pop-up issue

feat

Using minecontext heatmaps

fixed

After modifying the prompt in version 0.1.5, some models performed poorly, so this modification was rolled back in version 0.1.6.

What's Changed in Version Granite

Release Period: November 1, 2025 - November 14, 2025

Just as Granite is renowned for its immense durability and enduring presence, this update establishes a new foundation of stability and seamless experience for our product.

Stability & Trust: The exceptional hardness of Granite symbolizes the robust security and trust brought by Apple Notarization, eliminating the need for command-line workarounds and ensuring a solid, reliable installation.

Seamless Continuity: The enduring nature of Granite reflects the Automatic Updates and Chat History Saving features. They work together as the persistent bedrock, ensuring your workflow and creative conversations are maintained effortlessly across versions, without interruption or loss.

✨ New Features

feat: Build is now notarized by Apple, eliminating the need for command-line permission overrides in subsequent versions.

feat: Introduced automatic update checks, enabling seamless version upgrades without requiring full re-downloads.

feat: Conversation history is now preserved across both Home and Creation pages.

feat: Debug information is automatically saved in the background during operations.

What's Changed in Version Opal

Release Period: October 24, 2025 - October 31, 2025

Just like the Opal gemstone reveals a dazzling play of colors from different angles, this update brings the internal processes of our product to life with clarity and brilliance.

Visualization: The "play-of-color" in Opal symbolizes how we transform the previously hidden, complex intermediate processes into dynamic, intuitive, and easily understandable visual information.

Background Operation: The inherent body color of the Opal represents the stable, continuous background services (like MineContext), which serve as the essential foundation that makes all the brilliant visual effects possible.

✨ New Features

• feat: Added tray icon controls on Windows and macOS. You can choose to continue or stop recording, and recording persists even after closing the window.

• feat: Recording UI now shows real-time recording status, including how many images have been processed.

• refactor: Rebuilt the screenshot processing module. Switched from parsing multiple images in a single pass to coroutine-based concurrent parsing of single images with merging, improving parsing accuracy.
• feat: Improved the content quality of daily reports.
• feat: On Windows, added support for choosing a custom installation data directory.

🐛 Bug Fixes

• bug: fix settings page API
• bug: fix screen process and add log

What's changed in Version Stibnite

Release Period: October 17, 2025 - October 24, 2025

Stibnite
Stibnite is a mineral known for its lead-gray color, metallic luster, and distinct crystal formations. This release reflects its essence — enhanced compatibility, a refined interface, and sharper developer tools — mirroring the ore’s defining qualities.

Why Stibnite
Multi-Platform Support → Broad Adaptability
Just as stibnite forms diverse crystal structures, this release strengthens cross-platform compatibility — with improved Windows installation, cross-platform build scripts, and port configuration — allowing the application to “crystallize” across more environments.

Enhanced Developer Tools → Precision Debugging
New additions like the processor monitor, debugging utilities, and performance logs act like stibnite’s sharp edges — offering developers more incisive tools for diagnosing issues and analyzing performance.

✨ New Features

Platform & Installation

• Windows Installation Improvements: Enhanced Windows installation with better executable location detection and path handling #150
• Windows Build Support: Improved Windows compatibility with proper PyInstaller configuration #105
• Cross-platform Build Script: Added comprehensive Python build script supporting multiple operating systems #83
• Port Configuration: Changed default port from 8000 to 1733 to prevent common port conflicts #142

UI/UX Enhancements

• Brand New Top Bar: Complete redesign of the top navigation bar with improved user experience and modern interface #129
  #111 #110
• Daily Summary Display: Added daily summary to creation panel with direct navigation support from tips #130
• Settings Screenshot Preview: Integrated screen snapshot preview directly in settings modal for better visual context #136
• Copy & Edit Features: Implemented content copy functionality and edit change tracking #87

Developer Tools & Debugging

• Processor Monitor: Added comprehensive processor monitoring dashboard with real-time metrics #145
• Custom Settings Panel: Introduced customizable settings interface for advanced configuration #145
• Prompt Debugging: Implemented prompt debugging tools for AI interaction analysis #145
• Generation Record Tracking: Added generation record system for debugging and audit purposes #108
• Performance Logging: Enhanced performance monitoring with detailed logs and improved file naming conventions #107

Core Functionality

• Chat Context Streaming: Enabled real-time streaming output for chat responses, improving perceived responsiveness #84

🐛 Bug Fixes

• Custom Platform Config: Fixed issue where original configuration wasn't properly restored when switching to Custom Platform #147
• Compilation Errors: Resolved various compilation errors affecting the build process #149
• Model Validation: Added picture format validation to model validation checks #131
• Empty State Handling: Fixed issues with empty todo lists, report generation failures, and screen prompt errors #128
• Max Token Validation: Removed incorrect max token limit validation from model settings #125
• Windows PyInstaller: Disabled binary stripping in Windows builds to prevent runtime crashes #100
• Loading Errors: Fixed various loading-related errors during application startup #94

📚 Documentation

• Windows Download Link: Added Windows download link to documentation and README #116 #76
• README Formatting: Improved formatting and spacing consistency in documentation #103 #102
• Privacy Protection Guide: Added comprehensive privacy protection documentation #96
• GitHub Trending Badge: Added GitHub trending badge to showcase project popularity #92
• Community Best Practices: Published community best practice guide #88
• Development Documentation: Added capture and processor development guide #85
• Frontend Build Guide: Updated frontend build documentation #78
• README Updates: Various improvements to README content #79

🔧 Other Changes

• Code Formatting: Implemented automated code formatting and style standards #86
• EditorConfig: Added EditorConfig to standardize code style across different editors #95
• Code Refactoring: Refactored time-related logic and improved code style specifications [Multiple commits]

What Changed in Version Fluorite

Release Period: October 11, 2025 - October 15, 2025

Fluorite naturally exhibits multiple colors & fluorescence, mirroring the diversity of features in this update: open-source frontend, custom models, auto-refresh/cleanup, and critical bug fixes. Its glow symbolizes the system’s newfound clarity and self-optimization—turning complex upgrades into a seamless experience.

✨ New Features

• feat: Open-sourced frontend code
• feat: Support for custom model selection
• feat: Support for new activity auto-refresh interface (5s polling)
• feat: Added screenshot auto-cleanup feature (keep for 15 days, execute once daily)
• feat: Changed F12 developer tools from global shortcut to in-application shortcut
• feat: Added error prompts and popups for model settings save failures
• feat: Changed default screenshot interval to 15 seconds

🐛 Bug Fixes

• fix: Fixed oversized dock icon display issue
• fix: Screenshot reading failure due to mismatch between file path and timestamp
• fix: Activity list data display confusion across dates and historical date polling issues
• fix: Cleaned up some debug logs and fixed interface icon display issues
• fix: Fixed incompatibility between message.error() and React 19, restored API key popup

📚 Documentation

• docs: Added documentation for custom model usage
• docs: Added documentation for backend debugging interface
• docs: Added documentation for frontend framework and development

Release Date: October 15, 2025
Previous Release: v0.1.1 (October 10, 2025)

What Changed

Release Period: September 30, 2025 - October 11, 2025

Moss Agate
A foundational renewal, fostering new growth within a more structured and stable core.

Why Moss Agate?
This stone is valued for its intricate, web-like internal patterns, not just its surface. Similarly, this release's significance lies in its major refactoring—weaving a new, more robust foundation. New features and bug fixes are like the "moss" growing within this stable structure. With comprehensive documentation, the entire system's architecture becomes clear and traceable, marking a mature evolution from the initial v0.1.0 release.

✨ New Features

• feat: enable uv pkg management - @qin-ctx (538efe0)

  • Migrated from pip/requirements.txt to modern pyproject.toml with uv support
  • Faster, more reliable dependency management
  • Added .python-version for consistent Python environment
  • Updated build scripts to use uv workflow

• feat: Optimize the API key handling logic for retrieving and updating model settings, and add an API key masking feature to enhance security. - @fanrenaz (abe44d3)

  • Enhanced API key security with masking functionality in settings
  • Improved handling of sensitive credentials in UI

• feat: Update the model settings data structure, the apiKey field returns a masked value to enhance security. - @fanrenaz (38fb32a)

  • API keys now returned with masked values in responses

🐛 Bug Fixes

• fix: add start args, avoid port conflict - @qin-ctx (8f2e3d4)

  • Added --port, --host, and --config CLI arguments
  • Prevents port conflicts when running multiple instances
  • Priority: Command-line args > Config file > Defaults

• fix: repeated generation of daily reports - @qin-ctx (0bac59d)

  • Resolved issue causing duplicate daily reports
  • Improved scheduling logic for report generation

• fix: init config first - @qin-ctx (fc0a730)

  • Config now properly initialized before server start
  • Prevents startup errors related to missing configuration

• fix: optimize chat & todo - @qin-ctx (10852a4)

  • Enhanced chat interface responsiveness
  • Improved todo list management and display
  • Better state management in context agent

• fix: optimize tool desc - @qin-ctx (afb7c85)

  • Improved clarity and accuracy of tool descriptions
  • Better prompt engineering for tool usage

• fix: add link - @qin-ctx (8b80b4d)

  • Added download link fixes

• fix: remove unused code & add contribute doc - @qin-ctx (486bbcd)

  • Cleaned up unused code
  • Added contributing documentation

📚 Documentation

• docs: fix link for github issue and weChat group README.md - @WuMingDao (e064582)

  • Updated GitHub issue links in README.md
  • Corrected feedback form URLs

• docs: fix link for github issue and weChat group README_zh.md - @WuMingDao (484a557)

  • Fixed WeChat group links in README_zh.md

• docs: github Issue and PR template - @KashiwaByte (03e9aa2)

  • Added comprehensive GitHub templates:
    • Bug report template (.github/ISSUE_TEMPLATE/01_bug_report.yml)
    • Feature request template (.github/ISSUE_TEMPLATE/02_feature_request.yml)
    • Documentation advice template (.github/ISSUE_TEMPLATE/03_docs_advice.yml)
    • Pull request template (.github/PULL_REQUEST_TEMPLATE.md)
    • Issue configuration (.github/ISSUE_TEMPLATE/config.yml)

• docs: add contributing desc - @qin-ctx (1df0987)

  • Added comprehensive CONTRIBUTING.md
  • Clear guidelines for code contributions

• docs: add user guide with GIFs - @KashiwaByte (c3e3100)

  • Added comprehensive GIF tutorials:
    • Download-App.gif - Application download process
    • Quarantine.gif - macOS quarantine removal
    • Enter-API-Key.gif - API key configuration
    • Enable-Permissions.gif - System permissions setup
    • Screen-Settings.gif - Screen capture configuration
  • Step-by-step visual guides improve onboarding experience

• docs: add shield and star history - @KashiwaByte (ee2470e)

  • Added project shields (stars, issues, contributors, license)
  • Integrated Star History chart

🔄 Other Changes

Refactoring

• refactor: add single tool - @qin-ctx (46d1a2b)
  • Major refactoring of the retrieval tool system
  • Split monolithic tools into specialized, focused components:
    • activity_context_tool.py - Activity context retrieval
    • semantic_context_tool.py - Semantic search
    • intent_context_tool.py - Intent-based context
    • procedural_context_tool.py - Procedural context
    • state_context_tool.py - State management context
    • document_management_tool.py - Document operations
    • get_activities_tool.py - Activity retrieval
    • get_daily_reports_tool.py - Daily report generation
    • get_tips_tool.py - Tips retrieval
    • get_todos_tool.py - Todo management
  • Removed deprecated tools:
    • document_retrieval_tool.py
    • filter_context_tool.py
    • text_search_tool.py
  • Introduced base classes for better code organization:
    • base_context_retrieval_tool.py
    • base_document_retrieval_tool.py

Chores

• chore: translate notes and logging info into English in routes/settings.py - @fanrenaz (3a1f95e)
  • Improved code readability for international contributors

Internal Improvements

• vlm_request - @qin-ctx (84e85ff)
  • Enhanced vision-language model request handling

🎉 Contributors

Special thanks to all contributors who made this release possible:

• @qin-ctx - Core refactoring, features, and bug fixes
• @KashiwaByte (Betty) - Documentation and community features
• @WuMingDao - Documentation fixes
• @fanrenaz (Yifan Ren) - Security improvements and internationalization
• @MaojiaSheng - Bug fixes

Release Date: October 11, 2025
Previous Release: v0.1.0 (September 30, 2025)

MineContext is a proactive context-aware AI partner.

🚀 Key Features

MineContext focuses on five key features: effortless collection, intelligent resurfacing, and proactive delivery.

1. 📥 Effortless Collection
   Capable of gathering and processing massive amounts of context. Designed storage management enables extensive collection without adding mental burden.

2. 🚀 Proactive Delivery
   Delivers key information and insights proactively in daily use. It extracts summarized content from your context—such as daily/weekly summaries, tips, and todos—and pushes them directly to your homepage.

3. 💡 Intelligent Resurfacing
   Surfaces relevant and useful context intelligently during creation. Ensures assisted creativity without overwhelming you with information.

4. 🛡️ Privacy-First
   All data is stored locally, ensuring your privacy and security.

5. 🎯 Context Engineering Architecture
   Supports the complete lifecycle of multimodal, multi-source data—from capture, processing, and storage to management, retrieval, and consumption—enabling the generation of six types of intelligent context.

🏁 Quick Start

1. Installation
   Click Below Link or Github Latest Release to Download

2. Disable the quarantine attribute
   Enter the following command in the terminal to disable the quarantine attribute before running the application.

sudo xattr -d com.apple.quarantine "/Applications/MineContext.app"

3. Enter Your API-Key
   After the application loads, follow the instructions to enter your API-Key. We currently support Doubao and OpenAI, with more platforms and local Ollama models to be added in the future.

4. Start Recording
   Enter the 【Settings】 in 【Screen Monitor】 to set your screen sharing area, and click 【Start Recording】 to begin.

5. Forget it
   After starting recording, your Context will be gradually collected. Then, forget about it and focus on other tasks with peace of mind. MineContext will generate todos, tips, summaries, and activities for you one after another. Of course, you can also engage in proactive Q&A through 【Chat With AI】.