Build your own inbox
Have your agent gather what needs you across Avalandra, sort it by what matters to you, group comments by document, and alert you in Slack when something is urgent.
Have your agent do it
Paste this to your agent. It reads this guide and works through it with you.
Read https://avalandra.com/help/build-your-own-inbox.md and set up my Avalandra inbox with me. Start from what you already know about me, ask only about what you don't know, and show me my inbox rules before you save them.Comments, mentions and replies happen across many documents and Spaces. Your agent can gather the ones for you into one inbox, sorted by the rules you choose, with every comment about the same document kept together. When something urgent or time-sensitive arrives, it can tell you in Slack.
What your agent looks at
- Comments for you. Comments that mention you, and replies in threads you've taken part in, across every Space you can read.
- Work for your agent. Anything addressed to your agent, such as a comment sent to it with ⌘ Enter.
Your agent reads these with your permissions, so it only sees what you can see. It only reads; it doesn't resolve threads or mark anything as done unless you ask.
Decide what's urgent, with your agent
You don't fill in a form. Your agent starts from what it already knows about you, such as who you work with, your deadlines and the Spaces that matter most, and asks only what's missing. Then it suggests rules and shows them to you before saving.
Set up my Avalandra inbox with me, following https://avalandra.com/help/build-your-own-inbox.md. Start from what you already know about me and my work, ask me only about what you don't know, one question at a time, and suggest rules for what's urgent. Show me the rules before you save them.Your agent will usually suggest treating something as urgent when:
- someone mentions you by name, or asks you for a review
- it's from the people who matter most to you, such as a client or your manager
- it mentions a deadline in the next day or two
- it uses words like urgent, blocker or today
- a question to you has waited more than a day
- it's in the Space or on the documents you're focused on right now
Everything else goes into today, this week or for your information.
Set it up
- Save your rules. Your agent writes the rules you agreed to an "Inbox rules" document in your private Space. It reads that document every time it builds your inbox, and you can edit it whenever your priorities change.
- Build your first inbox. Your agent writes an inbox that opens with the one thing to do next, then urgent items, today's comments grouped by document, what you're waiting on from others, and what's been done since your last inbox. Quieter sections stay folded until you open them.
- Turn on Slack alerts. For anything urgent or time-sensitive, your agent sends you a short Slack message with a link.
- Keep it current. Schedule the inbox and the urgent check in your agent's own tool.
- Tune it. After a few days, tell your agent what it put in the wrong place. It updates your rules.
Your rules use the Inbox rules layout, part of the Inbox workflow.
Using my rules in the "Inbox rules" document in my private Space, build my inbox: everything that needs me across Avalandra, sorted into urgent, today, this week and for your information, with comments on the same document grouped together. Use the template at https://avalandra.com/help/template-files/inbox. Name it "Inbox" followed by today's date, and nothing longer. Put it in my private Space.Get alerts in Slack
Your agent sends the alert through its own Slack connection. If it doesn't have one yet, connect Slack in your agent's tool first, such as the Slack connector in Claude.
Whenever something in Avalandra matches the urgent rules in my "Inbox rules" document, send me a Slack message in [a direct message to me, or the channel to use]. Keep it short: the document, who it's from, why it's urgent, and a link. Don't paste long comment text into Slack. Don't alert me about the same thing twice, and hold anything that isn't urgent between [quiet hours, such as 7pm and 8am].Keep it current
Schedule both in your agent's own tool, such as a scheduled task in Claude Code or Codex:
Every weekday at [the time you start work], rebuild my Avalandra inbox from my "Inbox rules", as a new inbox document for the day. Every [how often, such as 15 minutes] during [your working hours], check for anything new that matches my urgent rules and alert me in Slack. If nothing is new, do nothing.Questions
Who sends the Slack message?
Your agent does, through its own Slack connection. Connect Slack in your agent's tool, then ask it to send alerts as above.
Can I change what counts as urgent later?
Yes. Edit your "Inbox rules" document, or tell your agent what to change and it updates the document. The next inbox uses the new rules.
Will my agent resolve threads or mark things as read?
No. It only reads to build your inbox. Ask it directly if you want it to reply to or resolve something.
Does it see comments in Spaces I'm not in?
No. It works with your permissions, so it only sees Spaces you're a member of.
For agents
- Find what's for the person. Get their actor id from
ava comment mention-suggestions --space SPACE_ID(match their name). In each Space fromava space list --json, useava changes list --space SPACE_IDto find documents with recent comment activity, then read threads withava document comment list DOC_ID(HTML) orava document text-comment list DOC_ID(text). Keep threads where a mention targets the person's actor id, or the person wrote an earlier message. - Find what's for you.
ava agent check-in --jsonlists items addressed to you, the agent. Include them, labelled as work for the agent. - What else goes in. "Up next" is the single most important item, with a suggested next step and its deadline. "Waiting on others" is threads where the person asked something and nobody has answered. "Done since your last inbox" is threads resolved or answered since the previous inbox; read the previous inbox document to know what's new, and mark new items "New". Next steps are suggestions; never act on them.
- Sort. Read the person's "Inbox rules" document first. Put each thread in one tier, either urgent, today, this week or for your information. Group threads under their document, newest first, and give each a short reason ("mentions you", "review requested", "due Thursday").
- Read only. Never
ack,resolveor reply while building the inbox. - Alerts. Post to Slack only for items newly urgent since the last alert, and remember which you've alerted on. Keep messages to the document title, who, why it's urgent and its
web_url. Respect quiet hours. - Rules. Start from what you already know about the person (memory, instruction files, earlier sessions, who they work with and their deadlines), ask only for what's missing, then write the agreed rules to "Inbox rules" in their private Space with the inbox-rules template, show it to them before saving, and update it when they correct a placement.