Your code is never stored. Processing exclusively in EU data centers. GDPR-compliant.
View our security standards System
Notifications
Native desktop notifications and intelligent context reminders. Never miss important events again.
Task complete (3min): Security review finished
Notification Types
From desktop alerts to intelligent context reminders - everything you need.
Desktop Notifications
Native alerts for all platforms
Receive native desktop notifications when Lurus Code needs your attention. Supports macOS (osascript), Linux (notify-send/zenity) and Windows (PowerShell).
Task Completion Alerts
Notification after long tasks
For tasks taking longer than 60 seconds, you automatically receive a desktop notification when work is complete. Perfect for background work.
Action Required Prompts
When your input is needed
When Lurus Code is waiting for your input (e.g. permission request), you receive a desktop notification. You can focus on other work in peace.
Workflow Notifications
Orchestrate workflows completed
For complex multi-agent workflows (Orchestrate), you receive a notification when all agents are done - including success or error status.
Session Notifications
Session end and important events
Receive notifications on session end, timeout or when the session ends unexpectedly. Never lose work again.
Context Reminders
Intelligent in-context hints
The reminder system injects contextual hints into the conversation: token budget, truncated files, compaction events and warnings.
Intelligent Context Reminders
The reminder system injects contextual hints directly into the conversation. This way the AI model always knows about token budget, truncated files and important events.
token_usage Current token usage (persistent)
file_truncated File was too large and truncated
output_truncated Tool output was truncated
response_cut_off Response hit token limit
compaction_happened Auto-compaction was performed
context_warning Context approaching limit
// Token usage reminder (persistent)
reminderService.updateTokenUsage({
used: 45000,
total: 200000,
remaining: 155000,
utilization: 0.225
});
// File truncation notice (one-shot)
reminderService.notifyFileTruncated(
'large-file.ts',
500
);
// Context warning at 80%
reminderService.updateContextWarning(0.8);
// → "Context is 80% full. Consider wrapping up."
// Consume all reminders for injection
const message = reminderService.consumeAll();
// → Combined system message for AI Platform Support
Native notifications for all major operating systems.
macOS
osascript Native macOS Notification Center
Linux
notify-send / zenity libnotify or zenity as fallback
Windows
PowerShell Windows Forms NotifyIcon
Platform-specific Implementation
osascript -e 'display notification
"message" with title
"Lurus Code"' notify-send "Lurus Code"
"message"
# Fallback:
zenity --notification
--text="message" $n = New-Object
System.Windows.Forms.NotifyIcon
$n.ShowBalloonTip(5000,
'Lurus Code',
'message') {
"notifications": true,
// Weitere relevante Einstellungen:
"model": "sonnet",
"maxTokens": 16000,
"truncateToolOutput": 40000
} notifications: true — Enable desktop notifications notifications: false — Disable desktop notifications (default) Simple Configuration
Enable desktop notifications with a single setting. Disabled by default for uninterrupted work.
Opt-in Design
Notifications are off by default
Project Level
Also configurable in .lurus/settings.json
Non-Blocking
Notification errors never block
All Reminder Types
The reminder system supports various types for different situations.
token_usage Current token usage (persistent)
file_truncated File was too large and truncated
output_truncated Tool output was truncated
response_cut_off Response hit token limit
compaction_happened Auto-compaction was performed
context_warning Context approaching limit
model_switch Model was switched
file_modified_externally File was modified externally
diagnostics_detected New diagnostics detected
cost_warning Cost warning
balance_warning Balance warning
Use Cases
When notifications improve your workflow.
Long Background Tasks
Start a security review or code refactoring and switch to other tasks. You'll be notified when the work is done.
$ lurus --prompt "/security-review"
# Switch to browser, work on docs...
🔔 Lurus Code: Task complete (5min) Permission Requests
When Lurus Code needs confirmation for an action, you'll be notified immediately - even if the terminal is in the background.
⚠️ Lurus Code needs your input
# Permission request waiting...
Allow Bash: npm install? [y/n] Multi-Agent Workflows
For complex orchestrate workflows with multiple agents, you receive a summary when all are done.
$ lurus orchestrate "Refactor auth system"
# 3 agents working in parallel...
🔔 Workflow "auth-refactor" completed Context Warnings
The reminder system proactively warns when context reaches 70%, 80% or 90% - so you can react in time.
⚠ Context is 80% full.
Consider wrapping up or compacting.
/compact to free up space Ready to revolutionize your development?
Thousands of developers already trust Lurus Code. Get started today.