Skip to content

docs(watchers): list aw-watcher-ask-away and aw-watcher-checkin - #180

Merged
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:docs/add-ask-away-and-checkin-watchers
Sep 9, 2026
Merged

docs(watchers): list aw-watcher-ask-away and aw-watcher-checkin#180
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:docs/add-ask-away-and-checkin-watchers

Conversation

@TimeToBuildBob

Copy link
Copy Markdown
Contributor

Adds two entries under Other watchers, next to the existing aw-watcher-ask line:

Requested by @ErikBjare as part of adopting aw-watcher-ask-away into the org.

aw-watcher-ask-away (Jeremiah England) asks what you were doing when you
return from an AFK break; it was not listed. It has been adopted into the
ActivityWatch org as aw-watcher-checkin, with full history and attribution,
to be extended with boundary-triggered check-ins. Both are placed next to
the related aw-watcher-ask entry under Other watchers.
@greptile-apps

greptile-apps Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 4/5

The documentation-only change is safe to merge after a non-blocking wording correction clarifies which aw-watcher-checkin capabilities are still planned.

Findings

  1. P2 Planned behavior appears available

Summary

  • Documents the AFK-return prompt behavior of aw-watcher-ask-away.
  • Marks aw-watcher-checkin as WIP, but describes planned boundary-trigger behavior as though it is already available.

Comment thread src/watchers.rst Outdated
- :gh:`akohlbecker/aw-watcher-tmux` - A plugin for tmux that allows monitoring activity in sessions and panes, by :gh-user:`akohlbecker`
- :gh:`bcbernardo/aw-watcher-ask` - (WIP) Periodically poses questions to the user and records her answers.
- :gh:`Jeremiah-England/aw-watcher-ask-away` - Asks what you were doing when you return from an AFK break, and logs it as the AFK period, by :gh-user:`Jeremiah-England`.
- :gh-aw:`aw-watcher-checkin` - (WIP) Boundary-triggered check-ins: rate the block you just finished when you return from AFK, switch context, or end a long block. Adopted from :gh:`Jeremiah-England/aw-watcher-ask-away` with full history, by :gh-user:`Jeremiah-England`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Planned behavior appears available

This entry describes AFK-return, context-switch, and long-block triggers as current behavior, but the PR description says aw-watcher-checkin is only “to be extended” with boundary-triggered check-ins. The (WIP) label does not make clear that these specific features are planned, so readers may install the watcher expecting functionality that is not available yet. Please separate the inherited behavior from the planned triggers.

Suggested change
- :gh-aw:`aw-watcher-checkin` - (WIP) Boundary-triggered check-ins: rate the block you just finished when you return from AFK, switch context, or end a long block. Adopted from :gh:`Jeremiah-England/aw-watcher-ask-away` with full history, by :gh-user:`Jeremiah-England`.
- :gh-aw:`aw-watcher-checkin` - (WIP) Adopted from :gh:`Jeremiah-England/aw-watcher-ask-away` with full history, by :gh-user:`Jeremiah-England`. Boundary-triggered check-ins for AFK returns, context switches, and long blocks are planned.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 0f497de — inherited AFK-return is current; context-switch and long-block are marked planned.

…riggers

Greptile P2 on ActivityWatch#180: the WIP line listed context-switch
and long-block as current behavior. Keep the inherited ask-away prompt
as what ships now; mark the extra triggers as planned.
@ErikBjare
ErikBjare merged commit d79327e into ActivityWatch:master Sep 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants