codician/diffinerypublic

---

#title: Today description: Your morning view of agent work across every repository you can see, with what needs you, what your agents are doing and what landed or failed since yesterday.

Today is the first page you see after signing in to Diffinery. It answers three questions across every repository you can see: what needs you, what your agents are doing, and what happened since yesterday. Open it in the morning to review the night's agent work, or any time you want to catch up.

The same view is available to scripts and agents from the REST API and the today MCP tool, so your own coding agent can read your morning too. It can also come to you by email as a morning digest, and it fits a phone's screen.

#What it shows

At the top, four numbers link to the sections below them: how many items need you, how many agent pull requests are open, how many pull requests merged since yesterday (and how many of them were by agents), and how many workflow runs failed.

A side column lists your repositories: those you or your organizations own, up to 40. If you own none yet but work in other people's repositories, it lists those instead, under Repositories. On a phone, Today comes first and the repository list after it.

#Needs you

Pull requests waiting on you, newest activity first:

A pull request opened by an agent you own is listed here too when it is waiting for a person: you are usually the person who approves it.

#Deployments waiting for you

Workflow runs whose jobs wait for you as a required reviewer of an environment, newest first, linking to the run page where you approve or reject them. A run you started doesn't show here when the environment prevents self-review. See Required reviewers and wait timers.

#Agents at work

Open pull requests from agents that you own or that your organizations own, each with where it stands:

Each row shows the repository, who opened it, when it last changed, failing check names, who asked for changes, and the pull request's intent.

#Since yesterday

What happened in the last 24 hours:

• Releases published, with their tag.
• Failed workflow runs that you or your agents started, and failed runs on a repository's default branch (pull request runs only when they are yours or your agents').
• Merged pull requests, with who opened and who merged them.

#Your agent tasks

Agent tasks you started that are running or changed in the last 24 hours, with their state and pull request. The section appears only when you have some.

#The morning digest

Turn on Email me a morning digest in Settings → Notifications to get Today by email once a day. Choose the hour and your time zone, and whether it also comes on Saturdays and Sundays.

The digest has the same sections as the page, each with up to 8 lines and a link to the rest:

• Needs you and Deployments waiting for you, as they are when it is sent.
• Agents at work: your agents' open pull requests, without drafts.
• Your agent tasks: running, or changed since the last digest.
• Failed runs, Merged and Released, since the last digest.

"Since the last digest" covers a weekend when weekends are off, and at most 7 days. A first digest covers the last 24 hours.

• When nothing needs you and nothing happened, no digest is sent. The email log on the settings page lists it as skipped, with the reason.
• The digest is gathered when it is sent, so it shows what is true then.
• It goes out within 5 minutes of the hour.
• Turning it off: use Unsubscribe from emails like this in its footer or your mail app's unsubscribe button. That turns off only the digest.
• Send me my digest now, next to the test email button, sends it at once, even when it is off or empty. You can do that 3 times an hour.

Like every email, the digest isn't sent to an address on the suppression list (see When Diffinery stops emailing you). Its subject leads with the counts, for example [Diffinery] Today: 2 need you, 1 agent pull request, 3 merged.

#Which repositories it covers

Today looks at the repositories you can see that had activity in the last 30 days, such as a push, a pull request, a review, a workflow run or a release, most recent first, up to 100 of them. Archived repositories are left out. When some active repositories were left out, the page says so next to the repository count, and the API sets incomplete_results.

For each repository it reads up to 50 open pull requests, the most recently updated first.

#Read it with the REST API

curl https://diffinery.com/api/v3/diffinery/today \
  -H "Authorization: Bearer dfy_..."

{
  "generated_at": "2026-10-14T07:30:12.000Z",
  "since": "2026-10-13T07:30:12.000Z",
  "repositories": 12,
  "incomplete_results": false,
  "needs_you": [
    {
      "reason": "agent_approval",
      "repository": "acme/website",
      "number": 42,
      "title": "Fix the Contact sales link",
      "html_url": "https://diffinery.com/acme/website/pull/42",
      "user": { "login": "review-bot", "type": "Bot" },
      "head": "fix-pricing-link",
      "base": "main",
      "draft": false,
      "intent": "Point the Contact sales link at /contact; no other changes.",
      "requested_reviewers": [],
      "approved_by": [],
      "approved_head": false,
      "changes_requested_by": [],
      "checks": "success",
      "failing_checks": [],
      "auto_merge": false,
      "in_merge_queue": false,
      "created_at": "2026-10-13T22:04:51.000Z",
      "updated_at": "2026-10-13T22:31:09.000Z"
    }
  ],
  "agents_at_work": [],
  "landed": [],
  "releases": [],
  "tasks": [],
  "deployments_waiting": [],
  "failures": []
}

Any token works (a read token is enough). A token limited to repositories sees only those repositories. When an agent's token calls it, agents_at_work lists that agent's own open pull requests, and needs_you never contains agent approvals, because an agent's approval doesn't count.

#Read it over MCP

The today tool takes no arguments and returns the same JSON:

{ "name": "today", "arguments": {} }

It is read-only, so MCP clients can run it without asking. A good first instruction for a personal assistant agent: "Call today and tell me what needs me first."

#Troubleshooting