Skip to content

docs: add privacy-first AI agent workflows - #176

Merged
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:bob/agents-ai-docs-4d16
Aug 3, 2026
Merged

docs: add privacy-first AI agent workflows#176
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:bob/agents-ai-docs-4d16

Conversation

@TimeToBuildBob

Copy link
Copy Markdown
Contributor

Summary

  • add an ActivityWatch with agents and AI guide near the data/query examples
  • document canonical-events-first workflows, local aggregation, review-before-send, and sensitive-field defaults
  • cross-link the guide from querying data, exporting data, categorization, REST API, and the examples index

Addresses ActivityWatch/activitywatch#1388.

Verification

  • make html passes locally after poetry install
  • Build still emits existing repo warnings for changelog labels, missing media files, missing aw_qt, unknown :docs: roles, and Graphviz availability; no new warning points at src/examples/agents-and-ai.rst or the changed cross-link pages.

@greptile-apps

greptile-apps Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR adds a privacy-first guide for using ActivityWatch data with AI assistants and agents.

  • Demonstrates bounded canonical-event queries and local aggregation.
  • Recommends redaction, payload review, and local-first processing.
  • Cross-links the guide from related API, export, categorization, and data-query documentation.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the revised canonical-events example constructs the query with the current client API, executes it for the bounded time range, and processes the returned event dictionaries correctly.

Important Files Changed

Filename Overview
src/examples/agents-and-ai.rst Adds the central AI-agent workflow guide; the corrected canonical-query example now follows the current client API and handles its JSON result shape.
src/examples.rst Adds the new guide to the examples index and describes its purpose.
src/examples/working-with-data.rst Links readers handling canonical ActivityWatch data to the privacy-first AI workflow.
src/api/rest.rst Directs agent integrations toward bounded and aggregated access rather than raw events.
src/features/categorization.rst Recommends categorized summaries as the default input for AI-assisted analysis.
src/features/exporting-data.rst Warns readers to aggregate and redact exported data before model upload.

Reviews (2): Last reviewed commit: "fix(examples): execute canonical event q..." | Re-trigger Greptile

Comment thread src/examples/agents-and-ai.rst Outdated
@TimeToBuildBob

Copy link
Copy Markdown
Contributor Author

@greptileai review

@ErikBjare
ErikBjare merged commit 78f0d85 into ActivityWatch:master Aug 3, 2026
2 checks 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