Wren is a note-taking and to-do management system designed for simplicity and advanced functionality. It targets users who prefer plain-text files for task management, offering seamless cross-device synchronization and powerful features like cron-based scheduling and AI-driven summaries.

How It Works

Wren stores each note as a separate plain-text file, using the filename as the title. This file-centric approach simplifies synchronization and conflict resolution. Tasks can be scheduled using cron syntax for recurring items or prefixed with dates for future appearance. Its advanced capabilities stem from extensibility, including optional Telegram and Matrix bots for interactive management, an HTTP server for API access and browser-based interaction, and AI summarization features via LiteLLM.

Quick Start & Requirements

• Install via pip: $ pip install wren-notes or uv: $ uv tool install wren-tools
• For optional features (Telegram, HTTP, LLM): $ pip install "wren-notes[telegram,http,llm]" or $ uv tool install "wren-notes[telegram,http,llm]"
• Requires Python.
• Configuration details and examples are available in the README.

Highlighted Details

• Plain-text file-based storage for easy syncing.
• Supports cron syntax for recurring tasks.
• Integrations include Telegram bot, Matrix bot, and an HTTP server with API.
• Optional AI Assistant for daily summaries using LiteLLM.
• Tasks can be managed via CLI, bots, or HTTP interface.

Maintenance & Community

The project is maintained by bjesus. Further community or roadmap information is not explicitly detailed in the README.

Licensing & Compatibility

The README does not specify a license. Users should verify licensing for commercial or closed-source integration.

Limitations & Caveats

The README does not detail specific limitations, known bugs, or deprecation notices. The AI Assistant feature requires configuration of LiteLLM and an LLM model.