Skip to content
Intelligent Notification System

System
Notifications

Native desktop notifications and intelligent context reminders. Never miss important events again.

🔔 Desktop Alerts ⏱️ Task Completion 🖥️ Cross-Platform 🧠 Context Reminders
Lurus Code now

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).

macOS: osascript Linux: notify-send Linux fallback: zenity Windows: PowerShell Timeout-protected Best-effort (never blocking)

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.

60-second threshold Automatic time tracking Task summary in notification Elapsed time shown Configurable

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.

Permission requests Interactive prompts Confirmation dialogs Instant notification Bring back focus

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.

Workflow name shown Success/error status Multi-agent support Complex pipelines Automatic on completion

Session Notifications

Session end and important events

Receive notifications on session end, timeout or when the session ends unexpectedly. Never lose work again.

Session end Graceful shutdown Unexpected termination Timeout warnings Auto-save confirmation

Context Reminders

Intelligent in-context hints

The reminder system injects contextual hints into the conversation: token budget, truncated files, compaction events and warnings.

Token usage tracking File truncation hints Output truncation alerts Response cut-off warnings Compaction notifications Context warnings (70/80/90%)
Reminder Service

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

reminder.service.ts
// 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

🍎 macOS
osascript -e 'display notification 
  "message" with title 
  "Lurus Code"'
🐧 Linux
notify-send "Lurus Code" 
  "message"

# Fallback:
zenity --notification 
  --text="message"
🪟 Windows
$n = New-Object 
  System.Windows.Forms.NotifyIcon
$n.ShowBalloonTip(5000, 
  'Lurus Code', 
  'message')
~/.lurus/settings.json
{
  "notifications": true,
  
  // Weitere relevante Einstellungen:
  "model": "sonnet",
  "maxTokens": 16000,
  "truncateToolOutput": 40000
}
notifications: true Enable desktop notifications
notifications: false Disable desktop notifications (default)
Configuration

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
Early Access Now Available

Ready to revolutionize your development?

Thousands of developers already trust Lurus Code. Get started today.

No credit card required · GDPR Compliant · Hosted in Europe
Register for

Register for Launch

Be among the first to hear about Lurus Code. Exclusive early access and bonus features for early registrants.

✓ From €5/month✓ No Spam✓ Unsubscribe Anytime

We respect your privacy. Unsubscribe anytime.