Skip to main content
Documents give you and your agents a shared place for specs, notes, and decisions. Janet Agent can work with them in chat, while connected MCP clients can use the Janet MCP server. Changes appear live when the document is open.
Push Notification Redesigneditor
Push Notification Redesign
Overview
Redesign the push notification system to support per-channel preferences and batched delivery. Related tickets: MOB-38 MOB-12
Requirements
Users can toggle notifications per channel (Slack, email, in-app) Will
Batch low-priority alerts into a single daily digest
Critical alerts (P0/P1) always deliver immediately
Open Questions
Adhit Sankaran — should we migrate existing prefs or reset to defaults? Adhit
Rate limit strategy for webhook delivery — see MOB-27
Will Barthell to confirm API contract with mobile team

Work with documents using agents

Ask Janet Agent to find a document or change one in natural language. MCP clients can use the same document capabilities directly. Document tools follow your Janet permissions. An agent can only read documents you can access. Only the owner can delete or restore a document.
When you call update_document through MCP, send the complete Markdown body. The new content replaces the whole document rather than patching one section.

Use documents as agent context

The search_tickets_semantic tool includes document content when you search without a project filter. This lets an agent find relevant specs or meeting notes alongside tickets. You can also attach a Janet document to a ticket with add_context_to_tickets by setting type to document. To show the same document under another page without moving it, use add_document_shortcut.

Find and organize documents

Open Documents from the sidebar. Use All, Private, Shared with Me, or Organization to filter the list. Press ⌘K to search by title or content. Press c to create a document. Use folders to group related documents. Folders can be private or available to the organization, and their access rules apply to the documents inside them. You can nest folders or drag a document into one. Synced meeting notes are grouped into read-only folders by provider. Documents created from a brainstorm show a Brainstorm source badge.

Edit and collaborate

Create a document from the Create menu, then choose Private or Organization visibility. The editor supports rich text and images. It also supports syntax-highlighted code blocks. Type / to open formatting and embed commands. Type @ to link tickets or other documents. You can also mention people and projects. Other editors appear with live cursors. You can leave comments and filter them by open or resolved. Local edits sync after you reconnect if your connection drops.

Share documents

Owners have full control. Editors can change content and invite other people, while viewers have read-only access. Organization documents are visible to everyone in the organization, and organization admins can edit them.