Skip to content

Releases: aguiarsc/numen

v1.0.1

24 Apr 13:53
@aguiarsc aguiarsc
v1.0.1
7c22d16

Choose a tag to compare

View all tags
v1.0.1 Latest
Latest

🚀 Numen v1.0.1 Release Notes

Welcome to Numen v1.0.1, your AI-powered terminal notepad. This release introduces significant new features, improvements, and fixes, making note-taking more efficient, flexible, and user-friendly. From template management to version history and enhanced installation options, Numen continues to evolve to meet your needs.

🆕 New Features & Enhancements

📋 Template System

Numen’s powerful new template system makes creating structured notes easier than ever.

Core Functionality:

  • Default Templates: 5 built-in templates to get you started:
    • Meeting Notes
    • Daily Journal
    • Code Snippet
    • Event Planning
    • Project Outline
  • Variable Substitution: Templates now support dynamic variables:
    • {{title}}: Note title
    • {{date}}: Current date
    • {{time}}: Current time
    • {{datetime}}: Full timestamp
  • Template Management: Full CRUD (Create, Read, Update, Delete) functionality:
    • Create custom templates
    • Edit existing templates
    • Delete templates
    • Reset default templates to their original state

Implementation Details:

  • A dedicated templates/ module has been created.
  • Templates are stored as Markdown files with frontmatter.
  • Integrated with the note creation system for seamless usage.

CLI Commands:

# Create notes from templates
numen new "Meeting Notes" -t meeting

# Manage templates
numen templates list
numen templates create book-review
numen templates edit meeting
numen templates show journal
numen templates delete custom-template
numen templates reset meeting

📜 Version History

Now you can track changes to your notes with version history, allowing you to save, view, and restore previous versions with ease.

Core Functionality:

  • Automatic Versioning: Auto-saves versions when editing notes.
  • Version Indexing: Simple numeric access (0 = oldest version).
  • Content Comparison: Visual diff between versions for easy tracking.
  • Restore Points: Revert to any previous version with a click.
  • Backup Protection: Auto-backup before restoring a version to ensure data safety.

Implementation Details:

  • A dedicated history/ module has been created.
  • Added version metadata with timestamps and messages.
  • Color-coded diff visualization for better version tracking.

CLI Commands:

# Create and list versions
numen history save my-note -m "Added new section"
numen history list my-note

# Access by index (0 = oldest)
numen history view my-note 0
numen history restore my-note 1
numen history diff my-note 0 1

# Clean up
numen history remove my-note

⚙️ Installation & Uninstallation Improvements

Installation Enhancements:

  • Improved Arch Linux Support: Enhanced pipx integration for Arch Linux users.
  • AI Provider Options: Interactive AI provider selection for customization.
  • Directory Structure: Added templates/ and history/ directories to improve organization.

Uninstallation Scripts:

  • Complete Removal: Uninstall scripts for both Windows and Linux.
  • Data Preservation: Option to keep your notes intact during uninstallation.
  • Safe Experience: Confirmation prompts before performing destructive actions.

Installation Usage:

# Standard installation
./install.sh

# Installation with all AI features
./install.sh --all-ai

Uninstallation Usage:

# Uninstall Numen
./uninstall.sh

# Force uninstallation without prompts (Windows)
./uninstall.ps1 -force

📝 Documentation Updates

  • README Enhancements: Added comprehensive information about new features and functionality.
  • Command Reference: All CLI command tables have been updated with new options and examples.
  • Installation Guide: Installation instructions for different platforms have been improved for clarity.
  • In-code Documentation: Detailed docstrings and help text for all new functionality.

📦 How to Update

To update to the latest version of Numen, follow these commands depending on your installation method:

If Installed with pip:

pip install --upgrade numen

If Installed with pipx:

pipx upgrade numen

For a Fresh Install:

git clone https://github.com/aguiarsc/numen.git
cd numen
./install.sh --all-ai
Assets 3
Loading