Settings

Customize Vigilare to match your workflow. Access all preferences through the Settings window and configure everything from window behavior to list archiving.

Accessing settings

Multiple ways to open preferences.

From main window

Settings button

Look for ⚙ (gear) icon in window title bar
Click to open Settings window
Fastest method when window visible

Keyboard shortcut

⌘, (Command + Comma)

Standard macOS settings shortcut
Works when Vigilare window focused
Opens Settings immediately

Settings window layout

Understanding the settings organization.

Page structure

Single scrolling page

Settings open as one scrolling page, not a tabbed sidebar
Sections are stacked top to bottom
Scroll to reach the section you need

Sections

General — Launch at Login
Window — window level and Space display
Lists — archive management
MCP — register Vigilare’s MCP server with AI agents, plus the background service
About — app information and privacy policy

Window size

Fixed dimensions

Settings window opens at predefined size
Not resizable (by design)
Optimized for all settings to fit
Consistent experience

General settings

Configure core app behavior and window management.

What it does

Starts Vigilare automatically when you log in to macOS
App launches in background
Window appears in last position
Reminders visible immediately

How to enable

Open Settings → General section
Find “Launch at Login” option
Check the checkbox
Change applies immediately

When to use

Daily Vigilare Users:
- Check tasks every morning
- Want reminders always visible
- Forget to launch apps manually
→ Enable launch at login

Occasional Users:
- Only need Vigilare sometimes
- Prefer manual launch
- Minimize startup apps
→ Keep disabled

Technical note

Registers as a macOS login item (ServiceManagement / SMAppService)
Doesn’t slow down login
Can disable anytime
No persistent background processes

Window level

Three options

Always on Top (Floating)
Normal
Desktop

See detailed explanation in Window Management → Window Levels

Quick summary

Always on Top

Window stays above all others
Perfect for fullscreen work
Never gets hidden

Normal

Standard window behavior
Can be covered by other windows
Good for multitasking

Desktop

Sits below all windows
Visible when desktop shown
Minimal intrusion

How to change

Settings → Window section
Find “Window Level”
Pick your preferred level from the segmented control
Change applies immediately
No restart needed

Space display

Two options

All Spaces — window visible on every Space
Current Space Only — window stays on one Space

See detailed explanation in Window Management → Multi-Space Support

Quick summary

All Spaces

Window follows you between Spaces
Always visible
Good for constant task awareness

Current Space Only

Window stays on creation Space
Disappears when switching Spaces
Good for dedicated workspaces

How to change

Settings → Window section
Find “Space Display”
Pick an option from the segmented control
Requires app restart
Quit and relaunch Vigilare

Important — Space display changes require app restart to take effect.

Lists settings

Manage which lists appear in Vigilare.

Archive management

Purpose

Hide completed or inactive lists
Reduce clutter in list dropdown
Keep lists in Apple Reminders
Nothing is deleted

Interface

List of all your Reminders lists
Toggle switch for each list
ON = Active (visible in Vigilare)
OFF = Archived (hidden from Vigilare)

How to archive a list

Settings → Lists section
Find list you want to archive
Toggle switch to OFF
List immediately hidden from Vigilare
Still exists in Apple Reminders

How to unarchive

Settings → Lists section
Find archived list (toggle OFF)
Toggle switch to ON
List immediately appears in Vigilare
All tasks still intact

See detailed explanation in List Management → Archiving Lists

What archiving affects

In Vigilare

List removed from dropdown
Tasks not shown in “All” view
Search doesn’t include archived tasks
Reduces visual clutter

In Apple Reminders

List completely unchanged
All tasks still visible
Still syncs normally
Other devices not affected (unless also using Vigilare)

Common archive scenarios

Completed projects

Project Alpha finished:
1. Mark all tasks complete in list
2. Settings → Lists
3. Archive "Project Alpha"
4. List hidden from Vigilare
5. Reference available in Reminders if needed

Seasonal work

Tax preparation:
- Archive after April
- Unarchive next January
- Tasks preserved
- Reduces year-round clutter

Inactive clients

Client on hold:
- Archive client list
- Cleans up active lists
- Easy to unarchive when project resumes

Shortcuts reference

Vigilare lists its keyboard shortcuts in a popover you open from the ? button at the bottom of the main window’s sidebar — not from Settings.

What it shows

A flat list of every shortcut with its key combination and a short description
Read-only — shortcuts are fixed and can’t be customized

Shortcuts listed

⌘E — Iconify window
⌘Return — Add new task
Enter — Edit selected reminder
Space — Toggle completion
↑ / ↓ — Move selection up / down
⌘S — Save changes (in the editor)

See the complete guide in Keyboard Shortcuts.

About information

App details and credits.

What’s included

App version

Current version number
Build number if applicable
Useful for bug reports
Check if you’re up to date

Description

What Vigilare does
Brief app summary
Developer information

Links

Privacy policy

Links to https://labee.jp/privacy
How your data is handled
No tracking or analytics
Local-only operation

About Labee LLC

Links to https://labee.jp
Developer/company information
Other products
Contact information

When to check About

Bug reports

Always include version number
Helps diagnose issues
Different versions may have different bugs

Privacy questions

Read full privacy policy
Understand data handling
No surprises

Credits

See who built Vigilare
Attribution for open source components
Acknowledgments

Settings persistence

How your settings are saved.

Automatic saving

All changes save immediately

No “Save” or “Apply” button needed
Toggle switches save on change
Selections save instantly
Close Settings window anytime

Where settings stored

macOS User Defaults system
Local preferences file
~/Library/Preferences/jp.labee.floating-reminders.plist
Not synced across devices (by design)

Why not synced

Window position is machine-specific
Display configurations differ
Archived lists are personal preference
Each Mac can have different setup

Resetting settings

If needed

Quit Vigilare completely

Delete preferences file:

~/Library/Preferences/jp.labee.floating-reminders.plist

Restart Vigilare
All settings reset to defaults
Window appears at default position

What gets reset

Window position
Window level
Space display
Launch at login
Archived lists (all unarchived)

What doesn’t change

Your actual reminders (safe)
Lists in Apple Reminders (safe)
iCloud data (safe)

Common settings configurations

Recommended setups for different workflows.

The fullscreen worker

Best for: Developers, writers in fullscreen

Settings:
- Launch at Login: ON
- Window Level: Always on Top
- Space Display: All Spaces
- Lists: Archive non-current projects

Why:
- Tasks visible in fullscreen apps
- Follows between Spaces
- Boots with system
- Only see relevant lists

The multi-tasker

Best for: Project managers, support roles

Settings:
- Launch at Login: ON
- Window Level: Normal
- Space Display: All Spaces
- Lists: Keep most lists active

Why:
- Works with many windows
- Visible but not intrusive
- Easy to bring to front (⌘Tab)
- All projects accessible

The context switcher

Best for: Freelancers, consultants

Settings:
- Launch at Login: ON
- Window Level: Normal
- Space Display: Current Space Only
- Lists: Archive inactive clients

Why:
- Dedicated Spaces per client
- Tasks only where relevant
- Clean separation
- Focus per Space

The minimalist

Best for: Occasional users, clean desktop lovers

Settings:
- Launch at Login: OFF
- Window Level: Desktop
- Space Display: Current Space Only
- Lists: Archive most lists

Why:
- Launch when needed
- Never covers work
- Minimal visual presence
- Single-focus approach

Troubleshooting settings

Settings won’t open

Try

Click ⚙ button again
Try ⌘, keyboard shortcut
Restart Vigilare if persistent

Changes not applying

Check

Space Display changes require restart
Other changes apply immediately
Close and reopen window to verify
Check if system settings override

Lost settings

If settings reset

Preferences file may have been deleted
macOS update may have reset
Restore from Time Machine backup
Or reconfigure manually (takes 1 minute)

Window Management — Window level and space display details
List Management — Archive functionality
Keyboard Shortcuts — Complete shortcut reference