# Project pack: ActivityWatch @ c8b9203

Facts about **ActivityWatch** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> ActivityWatch quietly records which apps and websites you use and when you are away, then shows it in a local web dashboard. Nothing leaves your computer. You can add rules to group activity into categories such as work and leisure, and use the data for time reports or healthier habits.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://activitywatch.net
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/ActivityWatch/activitywatch
- Pinned commit: `c8b9203be894b690c00d317e59d7fb3ab6658af4`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/ActivityWatch/activitywatch/archive/c8b9203be894b690c00d317e59d7fb3ab6658af4.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.activitywatch.net
- Licence: **MPL-2.0**. Free to use and change. If you share a changed version of a file covered by this licence, you must share that file's source under the same licence. Using it privately has no extra obligations.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/ActivityWatch/activitywatch bespoke-activitywatch
  cd bespoke-activitywatch
  git checkout --detach c8b9203be894b690c00d317e59d7fb3ab6658af4
  # Prepare development requirements and local configuration first.
  git submodule update --init --recursive
  make build
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Download the installer for Windows, macOS or Linux from https://activitywatch.net/downloads, then open http://localhost:5600.
  ```
- Tools these commands use: A desktop download for everyday use; Python 3.9+, Node and Rust for development
- Develop: `make build`
- Test: `make test`
- Stack: rust, python, typescript (Rust server, Vue, Tauri). Difficulty for a non-developer with an AI: **moderate**. A collection of small repositories (server, watchers, web UI) pulled together here as submodules. Categories and rules need no code; new watchers are small Python or Rust programs.
Personal data: **yes**. Stored in: A local SQLite database in your user data folder. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/activitywatch/c8b9203/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/activitywatch/c8b9203/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/activitywatch/c8b9203/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/activitywatch/c8b9203/r3/SKILL.md)