Synapse - Prompt/Context/Knowledge Manager

A native macOS app for organizing and managing reusable prompts, context information, and knowledge items for LLM workflows.

Features

📁 Three Main Sections

• Prompts: Reusable prompt templates with placeholder support (e.g., {topic}, {context})
• Contexts: Background information, data snippets, and reference materials
• Knowledge: Facts, summaries, and knowledge base items

🏗️ Organized Structure

• Groups: Organize items into custom categories (e.g., "Work Projects", "Creative Writing")
• Tags: Tag items for easy filtering and search
• Favorites: Star important items for quick access

✨ Rich Features

• AI-Powered Prompt Generation: Generate relevant prompts using OpenRouter API integration with multiple LLM models
• Basic Search: Full-text search across all content, titles, and tags
• Advanced Search & Filtering: Comprehensive search capabilities with multiple filter options
• Import/Export: JSON-based data exchange for backup and sharing
• Visual Editor: Rich text editing with placeholder templates
• Metadata Tracking: Creation and modification timestamps
• Copy Functions: Easy copying of content or JSON data to clipboard

🔍 Advanced Search & Filtering

• Field-Specific Search: Search within specific fields (title, content, tags, or all)
• Multi-Criteria Filtering: Combine text search with advanced filters
• Section Filtering: Scope searches to specific sections (Prompts, Contexts, Knowledge)
• Group Filtering: Filter by specific groups across all sections
• Tag-Based Filtering: Filter by one or multiple tags with visual selection
• Favorites Filtering: Show only your starred items
• Date Range Filtering: Filter by creation/modification dates with presets (Today, This Week, etc.) or custom ranges
• Saved Search Queries: Save frequently used search configurations for quick access
• Smart Collections: Built-in collections (Favorites, Recent, Today) with automatic updates
• Custom Collections: Create your own smart collections based on any filter combination

🤖 AI Prompt Generation

• Multiple LLM Models: Support for Gemini 2.5 Pro, Claude 3.5 Sonnet, GPT-4o, GPT-4o Mini, and Llama 3.2 90B Vision
• OpenRouter Integration: Secure API key management with comprehensive model selection
• Template Variable Support: Generated prompts include {variable} placeholders for dynamic content
• Smart Organization: Auto-organize generated prompts into existing groups with relevant tags
• Batch Generation: Generate 3-5 contextually relevant prompts from any input text
• Flexible Token Limits: Configurable response length from 500 tokens to unlimited for complete responses
• Real-time Testing: Built-in connection testing to validate API configuration

🚀 Workflow Enhancements

• Global Hotkey (Show/Hide): Toggle the application instantly from anywhere in macOS with ⌘H.
• Global Hotkey (New Prompt): Create a new prompt in the default folder from anywhere using ⌘⌥H.
• AI Generation Access: Prominent "Generate with AI" button in toolbar for instant prompt creation
• Advanced Search Access: Quick access to advanced search and saved searches via toolbar buttons
• Recently Used Items: (Coming Soon) A dedicated list showing the last 20 items you've viewed or edited.
• Keyboard Navigation: (Coming Soon) Navigate between the sidebar, item list, and editor using only the keyboard.

🎨 Native macOS Experience

• Three-Panel Layout: Sidebar → Group List → Item Editor
• Native Navigation: SwiftUI with native macOS controls
• File Management: Automatic data persistence in the Documents folder.

Getting Started with AI Features

Prerequisites

1. OpenRouter Account: Sign up at openrouter.ai for API access
2. API Key: Generate your free API key from the OpenRouter dashboard

Setup Instructions

1. Open LLM Settings: Click the menu button (⋯) → "LLM Settings"
2. Configure API Key: Enter your OpenRouter API key in the secure field
3. Select Model: Choose from supported models (default: Gemini 2.5 Pro)
4. Adjust Settings:
   • Temperature: 0-2 (creativity level)
   • Max Tokens: 500-4000 or "No Limit" for complete responses
5. Test Connection: Use the "Test Connection" button to verify setup
6. Save & Done: Your settings are securely stored

Using AI Prompt Generation

1. Click "Generate with AI" in the toolbar
2. Enter your text to analyze (articles, documents, notes, etc.)
3. Select target group and add relevant tags
4. Generate prompts - AI creates 3-5 contextually relevant prompts
5. Review and select the prompts you want to keep
6. Add selected prompts to your collection

The AI will generate prompts with {variable} placeholders that you can customize using the existing template variable system.

Data Storage

• Location: ~/Documents/synapse_data.json
• Format: Human-readable JSON
• Backup: Use the export feature to create timestamped backups.

Building from Source

This is a standard Xcode project:

1. Open synapse.xcodeproj in Xcode.
2. Add the HotKey package dependency using the Swift Package Manager: https://github.com/soffes/HotKey.
3. Build and run for the macOS target.
4. Minimum deployment target: macOS 15.5

Tech Stack

• SwiftUI - Modern declarative UI framework
• Swift 5.0 - Native performance and memory safety
• JSON - Human-readable data persistence
• NavigationSplitView - Native three-panel layout
• HotKey - Library for global keyboard shortcut management
• OpenRouter API - Multi-model LLM access through unified interface
• URLSession - Native HTTP networking for API communication

---

Transform your LLM workflows with organized, reusable content management.