Skip to content

Remi transforms your macOS menu bar into a supercharged knowledge management system. It's your personal assistant for storing, organizing, and instantly accessing your knowledge.

Notifications You must be signed in to change notification settings

Ashref-dev/remi-notes-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

64 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Remi - Your AI-Powered Knowledge Hub

Remi App Icon

Lightning-fast access to your most valuable knowledge, right from your macOS menu bar.
Never lose a brilliant idea, useful command, or important note again.

Platform: macOS 12+ Swift 5.10 AI: Groq Powered License: MIT


🎯 What is Remi?

Remi transforms your macOS menu bar into a supercharged knowledge management system. It's your personal assistant for storing, organizing, and instantly accessing:

  • πŸ€– AI Prompts you use daily
  • πŸ’» Terminal commands and code snippets
  • πŸ“ Quick notes and brilliant ideas
  • πŸ”§ Useful tips and workflows
  • πŸ“š Reference materials and documentation

Access everything with a single hotkey. No more hunting through files, bookmarks, or sticky notes.

Remi in action


Your knowledge, instantly accessible from anywhere on macOS


✨ Key Features

πŸš€ Instant Access

  • Global hotkey (⌘+Shift+R) - summon Remi from anywhere
  • Tab navigation - cycle through nooks with Tab/Shift+Tab
  • Menu bar integration - always one click away
  • Lightning-fast search through all your nooks

🧠 AI-Powered Intelligence

  • Smart editing with Groq AI integration
  • Content enhancement - improve clarity and organization
  • Context-aware suggestions with modern, compact Quick Actions panel
  • Crash-safe operations with robust error handling

πŸ“ Nooks System

Organize your knowledge into focused "Nooks" - think of them as smart, AI-enhanced notepads:

πŸ“‚ My Nooks/
β”œβ”€β”€ πŸ€– AI Prompts/          # Daily prompts for ChatGPT, Claude, etc.
β”œβ”€β”€ 🐳 Docker Commands/     # Container management snippets
β”œβ”€β”€ πŸ”§ Terminal Shortcuts/  # Bash/Zsh one-liners
β”œβ”€β”€ πŸ’‘ Project Ideas/       # Brilliant thoughts and concepts
β”œβ”€β”€ πŸ“ Meeting Notes/       # Quick capture during calls
└── 🎯 Daily Workflows/     # Step-by-step processes

🎨 Beautiful, Native Design

  • macOS-native interface that feels right at home
  • Dark/Light mode support with persistent user preferences
  • Elegant typography and spacing
  • Smooth animations and modern hover effects
  • Modern card-based UI with gradient backgrounds and subtle shadows

πŸƒβ€β™‚οΈ Real-World Use Cases

For Developers

# Docker Nook
🐳 Quick Docker Commands

## Container Management
docker ps -a                    # List all containers
docker logs -f container_name   # Follow logs
docker exec -it container_name bash  # Interactive shell

## Cleanup Commands  
docker system prune -a          # Clean everything
docker volume prune             # Remove unused volumes

## Useful One-liners
docker run --rm -v $(pwd):/app node:16 npm install

For AI Power Users

# AI Prompts Nook
πŸ€– Daily AI Prompts

## Code Review
"Review this code for security, performance, and best practices. 
Provide specific suggestions with examples."

## Content Creation
"Transform this rough draft into polished, engaging content while 
maintaining the original tone and key messages."

## Problem Solving
"Break down this complex problem into manageable steps and suggest 
the most efficient approach."

For System Administrators

# Server Management Nook
πŸ–₯️ Server Commands

## System Monitoring
htop                             # Interactive process viewer
df -h                           # Disk usage
netstat -tulpn                  # Network connections
journalctl -f                   # Follow system logs

## Quick Diagnostics
curl -I website.com             # Check HTTP headers
ping -c 4 8.8.8.8              # Test connectivity

πŸš€ Getting Started

Installation

  1. Download the latest release from GitHub
  2. Extract the zip file and drag Remi to your Applications folder
  3. Install the unsigned app (since this is a development build):
    • Right-click on Remi.app in Applications
    • Select "Open" from the context menu
    • Click "Open" in the security warning dialog
    • macOS will remember this choice for future launches
  4. Launch Remi - it'll appear in your menu bar
  5. Set your hotkey in Preferences (default: ⌘+Shift+R)

Note: This is an unsigned development build. The right-click β†’ Open method is required only for the first launch to bypass macOS Gatekeeper security.

Quick Setup

  1. Create your first Nook - click the "+" button
  2. Add your content - paste in your most-used commands or notes
  3. Use the hotkey to access instantly from anywhere
  4. Optional: Add Groq API key for AI features


🎯 Latest Features & Improvements

πŸ›‘οΈ Crash-Safe Operations

Remi now includes robust error handling and null-safe operations:

  • Guard statements prevent crashes during undo/redo operations
  • Graceful error handling for network issues and API failures
  • Safe state management with proper validation

🎨 Modern AI Quick Actions Panel

The AI assistance has been completely redesigned:

  • Compact grid layout - 2-column design for better space utilization
  • Elegant hover effects - Smooth animations and visual feedback
  • Modern card design - Gradient backgrounds and subtle shadows
  • Collapsible interface - Clean, unobtrusive when not needed

πŸ’Ύ Persistent User Preferences

Your settings are now remembered across sessions:

  • Markdown/Plain text mode preference saved automatically
  • UI state persistence for Quick Actions panel
  • Theme preferences maintained between app launches

⚑ Native Performance

Streamlined architecture for better performance:

  • Native URLSession replaces third-party networking
  • Optimized animations with SwiftUI best practices
  • Efficient memory usage with proper state management

Pro Tips

  • Use descriptive nook names like "Docker Commands" or "AI Prompts"
  • Organize by context rather than by type
  • Keep frequently used items at the top of each nook
  • Tab through nooks to quickly browse your collection
  • Use the AI Quick Actions for instant content improvement
  • Enable markdown preview for rich text formatting
  • Leverage undo/redo (⌘Z/βŒ˜β‡§Z) for safe editing

πŸŽ›οΈ Configuration

Global Hotkey

Customize your hotkey in Settings:

  • Default: ⌘ + Shift + R
  • Choose any combination that works for your workflow

AI Integration

Add your Groq API key for intelligent features:

  1. Get a free key from console.groq.com
  2. Paste it in Remi's Settings
  3. Enjoy AI-powered editing and suggestions

Launch at Login

Enable in Settings to have Remi ready when you start your Mac.


πŸ—οΈ Technical Architecture

Remi is built with modern macOS development practices and focuses on native performance:

πŸ›οΈ Architecture Overview
β”œβ”€β”€ 🎯 SwiftUI Interface       # Native, responsive UI with modern components
β”œβ”€β”€ 🧠 AI Integration         # Native URLSession + Groq API
β”œβ”€β”€ πŸ“ File-based Storage     # Simple, portable nooks
β”œβ”€β”€ ⚑ Global Hotkey System   # System-wide accessibility
β”œβ”€β”€ 🎨 Theme Management       # Dark/Light mode with persistence
β”œβ”€β”€ πŸ›‘οΈ Error Handling        # Robust, crash-safe operations
└── πŸ”„ Undo/Redo System      # Native UndoManager integration

Project Structure

remi/
β”œβ”€β”€ App/                     # App lifecycle and configuration
β”‚   β”œβ”€β”€ AppDelegate.swift    # Menu bar setup and app coordination
β”‚   └── remiApp.swift       # SwiftUI app entry point
β”œβ”€β”€ Core/                    # Business logic and data management
β”‚   β”œβ”€β”€ Models/             # Data models (Nook)
β”‚   └── Services/           # Core services (AI, networking, settings)
β”œβ”€β”€ UI/                     # User interface components
β”‚   β”œβ”€β”€ Theme/              # Theme system and color management
β”‚   β”œβ”€β”€ ViewModels/         # MVVM architecture
β”‚   └── Views/              # SwiftUI views and components
β”‚       β”œβ”€β”€ Components/     # Reusable UI components
β”‚       β”œβ”€β”€ Reusable/       # Generic reusable views
β”‚       └── Settings/       # Settings and configuration views
└── Utils/                  # Utilities and helpers

Core Technologies

  • SwiftUI - Modern, declarative UI framework
  • Native URLSession - Reliable, lightweight networking
  • HotKey - Global keyboard shortcut management
  • Groq AI - Fast, efficient language model integration
  • UserDefaults - Persistent user preferences
  • NSUndoManager - Native undo/redo functionality

🀝 Contributing

We welcome contributions! Here's how you can help:

Development Setup

# Clone the repository
git clone https://github.com/Ashref-dev/remi-notes-project.git
cd remi-notes-project

# Open in Xcode
open remi.xcodeproj

# Build and run
⌘ + R

Ways to Contribute

  • πŸ› Report bugs or suggest features
  • πŸ“ Improve documentation
  • 🎨 Design improvements
  • πŸ”§ Code contributions
  • 🌍 Localization support

πŸ—ΊοΈ Roadmap

Coming Soon

  • πŸ”„ Sync across devices via iCloud
  • πŸ“± iOS companion app
  • 🏷️ Tags and smart filtering
  • πŸ“Š Usage analytics and insights
  • πŸ”— Integration with popular tools (Notion, Obsidian)
  • 🎯 Enhanced AI workflows with custom prompts
  • ⌨️ Nook hotkeys (⌘+Shift+1-9) - instantly jump to any nook

Recent Improvements βœ…

  • ⌨️ Tab navigation through nooks with Tab/Shift+Tab
  • 🎨 Improved nook cards with better visibility and simplified design
  • ✏️ Repositioned edit button for better accessibility
  • πŸ›‘οΈ Crash-safe undo/redo operations
  • 🎨 Modern AI Quick Actions panel with grid layout
  • ⚑ Native networking (removed Alamofire dependency)
  • πŸ’Ύ Persistent user preferences for UI state
  • πŸ–±οΈ Enhanced hover effects and smooth animations
  • πŸ“ Improved markdown/plaintext toggle with persistence

Future Vision

  • πŸ€– Advanced AI workflows
  • πŸ‘₯ Team collaboration features
  • πŸ”Œ Plugin system for extensibility
  • 🎯 Smart suggestions based on context

πŸ’¬ Community & Support


πŸ“„ License

Remi is open source software licensed under the MIT License. See LICENSE for details.


πŸ™ Acknowledgments

Built with ❀️ using:

Special thanks to the Swift community for excellent libraries and continuous innovation in macOS development.


Transform your workflow with Remi - where knowledge meets convenience.

⬇️ Download Latest Release Β· πŸ’¬ Join Community Β· πŸ› Report Bug

About

Remi transforms your macOS menu bar into a supercharged knowledge management system. It's your personal assistant for storing, organizing, and instantly accessing your knowledge.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •