Inbox & Notifications

The Inbox gathers all notifications (mentions, assignments, and more) into a single feed, letting you process them efficiently. Use keyboard shortcuts for quick actions and keep important work at the top of your queue.

Viewing the inbox

Press Ctrl + K to open the command palette and search for “Inbox”, or go to the Inbox page from the sidebar. The inbox shows:

Unread notifications from mentions, assignments, reactions, and follow updates
Actionable items like tasks, notifications with dismiss options (undo, dismiss all, undo all), and confirmed operations (invites, feedback)
Important tasks â\x80\x94 rows marked with the Important label appear first, in priority order and timeline-sorted (newest first)

Replying to notification emails

Reply directly to a task notification email to add your response as a comment on the task. Send the reply from the same email address as your Hypertask account so Hypertask can verify it and post it under your name.

The inbox can be grouped into multiple views:

Inbox views

View	Shortcut	Purpose
Inbox	Default	All notifications
Search	Search icon	Text-based search across all boards
Notifications	Notification icon	List of all notification types

Action icons

Task completion and inbox-archive now use distinct icons to avoid visual confusion.

Task completion: Uses a circle-check icon when marking a task as done from task details, boards, or lists
Inbox archive: Keeps the existing archive tray icon when removing or archiving notifications from your inbox

This distinction makes it clearer which action applies to tasks versus inbox notifications, even when both icons may resemble a checkmark or tray in some contexts.

Mobile inbox bottom dock

On mobile, the Inbox uses a bottom thumb zone for navigation and splits:

Inbox splits (such as Important, Blocked by you, and others) now appear in the bottom thumb zone. The regular five-tab navigation bar is hidden while the Inbox is open, so your attention stays focused on the current view and its actions.
Split filtering is preserved; you can still switch or filter splits within the dock without losing context.
On narrow screens, the thumb zone accommodates splits cleanly, keeping key actions and switches within hand-reach.

Mobile inbox notification nudge

On mobile, the inbox now explicitly surfaces a notification nudge when your notifications are switched off. This provides clear context at a glance, similar to the desktop experience, and encourages users to re-enable notifications for timely updates.

Mobile inbox sender alignment

On narrow screens, the Inbox displays rows on a single line with sender information clearly visible. Read rows no longer show an empty status gutter that previously pushed sender names to the right. The status indicator now renders only for unread, saved-content, or blocked-by-me states, keeping sender names aligned without unintended indentation.

Inbox prefetch timing

Board data is deferred until Inbox is usable to improve startup performance. When you navigate to Inbox, the previous-board query is paused while Inbox contains placeholder data and automatically resumes after IndexedDB, network, or optimistic data is available. This ensures that on signed-in reloads, no Board request occurs before usable data, and warm-up of the previous-board query waits for stable IndexedDB and network readiness (HTPR-5431).

Inbox boundary jumps (HTPR-5431)

When the inbox list is longer than the screen, use G twice or gg and GG to jump to the top or bottom of the list. This fix ensures that:

Pressing gg moves focus to the first item and scrolls the list to center that row on screen.
Pressing GG moves focus to the last item and scrolls the list to center that row on screen.
The list viewport updates alongside the focused row, so the jump stays visualized and you don’t lose your place in scrolling.

This change addresses the case where moving to the last item (via GG) changed which inbox row was highlighted, but the long list stayed in its old position on screen. Now top and bottom jumps center the matching row and handle filtered and empty inboxes safely.

Collaborate on the inbox

Use Snack bar buttons on inbox rows to quickly consume notifications or undo actions. Swipe the row to reveal cleanup actions on narrow screens.

Snack bar options

Button	Action
Snooze	Temporarily hide from your feed
Dismiss	Remove and ensure future updates don’t surface
Undo	Revert a dismissed notification or undone action
Undo all / Dismiss all	Apply the action to visible rows matching the filter

Snack bar buttons appear at the bottom of an inbox row and can be accessed via swipe on mobile or click on desktop.

Inbox Zero

Use Ctrl + K and search for “Clear inbox to zero” or press within an active inbox to open the Inbox Zero modal. This gives you a quick, clean way to bulk-process rows by selecting multiple notifications at once.

What Inbox Zero counts

Inbox Zero counts only items that are:

Visible in your All tab (no filters applied)
Unarchived
Unique within each row scope (one count per task or invite)

This means hidden rows (e.g., notifications from tasks you’ve archived, filtered-out boards, or rows censored by privacy rules) are excluded from the count and will not be archived by Inbox Zero, even if they’re currently visible in some other view.

Preview before commit

Select one or more rows from the All tab of your Inbox. Each selected row represents a single task or invite.
Inbox Zero opens a preview showing how many rows will be archived, and presents a reconfirmation before committing.
Click Confirm to archive every selected row. The count reflects the number of visible, unarchived rows matching your selection, and no other rows are affected.
If the preview updates (e.g., because you change your filter or a previously filtered row becomes visible), Inbox Zero prompts you to reconfirm before archiving.

Reconfirmation on preview changes

If the set of visible rows changes while Inbox Zero is open, the reconfirmation prompt appears again. This protects you from accidentally committing to the wrong batch when switching between views, confirming tasks that are out of scope, or otherwise altering what’s included in the visible scope.

Confirmation required: After validation, Inbox Zero confirms the changes before committing, ensuring accidental bulk-action clears don’t lose work. Ctrl+K â\x86\x92 “Clear inbox to zero” now always shows you what it will archive and waits for your explicit confirmation before applying the changes. This prevents accidental sweeps and preserves live workflows.

Limitations

Inbox Zero only sees the visible portion of the All tab at the moment you open it; items hidden by board filters, privacy settings, or a previous archiving action are out of scope.
It’s available from the Inbox page’s All tab and from the action menu on any inbox row.
Preview and execution respect your current view filters; if you filter out certain notifications, they won’t appear in the preview.

Archived inbox

Use Ctrl + K and search for “Go to archived inbox” to view your archived rows. This provides a focused view of historical notifications for review or reference.

Agent notifications

Agent notifications include mentions directed at agents (e.g., “Reply to @dev-bot”). These are handled with special guard-rules to prevent them from being incorrectly archived during snooze or reminder lookups. The system skips reminder validation when the notification is addressed to an agent, ensuring agent rows stay visible until you explicitly take action on them.

Guest Hyper AI seeded notifications

Fresh guest inboxes now receive 4 seeded notifications from a Hyper AI agent. When available, the Important split is enabled, helping new users immediately experience AI-driven prioritization.

OpenWiki

OpenWiki is a RAG-powered notepad available on each task, supporting AI-optimized queries and your custom documentation. When you add notes to a task, they’re versioned and can be queried by agents whenever they investigate that task.

OpenWiki notifications include an OpenWiki badge and action buttons:

View â\x80\x94 Open the OpenWiki page for the associated task
Refresh â\x80\x94 Pull the latest RAG content from connected documentation
Dismiss â\x80\x94 Remove the notification from your inbox without affecting the underlying task
Undo â\x80\x94 Re-add a dismissed OpenWiki notification

To keep up-to-date with OpenWiki activity, use the Refresh button in the notification card, which fetches fresh content from your connected knowledge base.

OpenWiki refresh

OpenWiki refresh periodically pulls the latest RAG content from connected documentation sources. If OpenWiki operations are failing, check your gateway configuration in ~/.openwiki/.env:

# Ensure you\'re pointing to the Cloudflare AI Gateway
OPENWIKI_GATEWAY=https://gateway.ai.cloudflare.com/v1/YOUR_ACCOUNT/YOUR_SERVICE

Read model for returning visits

Returning users now see a synchronized local IndexedDB read model in the Inbox. This makes returning visits faster by preserving local state across sessions and providing resilient updates when the network returns.

How read model works

When you navigate to the Inbox on a return visit:

Local state restoration: IndexedDB reads your cached state locally before waiting for network confirmation. This reduces initial load time and improves perceived responsiveness.
Optimistic updates: Local writes are immediately persisted and reflected in the UI while the server acknowledges them.
Reconciliation on refresh: Network changes are reconciled with your local cache, and the freshest data is presented. Older local updates are discarded in favor of newer server state.

Timeline-sorted returning visits

For returning users, inbox rows appear in timeline-sorted order (updates bubble to the top within the last 24 hours). This gives you a prioritized view of recently updated notifications without needing to dig through archives.

Indexing across boards

The read model follows your account-scoped setting. When you switch boards and return to the Inbox, your local cache adapts to your workspace context and presents the most relevant notifications.

Real-time updates

Inbox notifications now update in real-time using WebSocket connections. As notifications are created or changed, the server broadcasts updates to all connected clients, eliminating manual page refreshes.

Subscription on client: useInboxRealtime hook in the frontend layer subscribes to inbox changes for the current user.
Broadcast mechanism: broadcastInboxChange fires whenever a notification is created or modified, notifying all subscribed clients instantly across all supported surfaces (app, CLI, MCP, manifest).

Sibling-rows cleanup after archiving now propagates in real-time. When you archive a notification, its sibling rows in the Reactions split are immediately cleared in the local view without needing to refresh. This mirrors the server-side sibling cleanup and keeps the inbox UI in sync with your actions.

This ensures your inbox always reflects the latest state of mentions, assignments, reactions, and follow updates without needing to refresh manually.

Keyboard shortcuts

Ctrl + K â\x80\x94 Open command palette with inbox options: Snooze, Read/Unread, Mark Read, Clear inbox to zero, Go to archived inbox
Ctrl + F â\x80\x94 Search across all notifications
N â\x80\x94 Create a new task from the active board
Space â\x80\x94 Mark current item as read/unread
Esc â\x80\x94 Close modal, draft error, or focused search

Merge actions

Use Ctrl + K â\x80\x94 Merge into inbox to consolidate multiple activities into a single notification entry.