AW-SYNC(1)

💖 aw-sync — bestie edition 💖

okay so this is aw-sync, manual page for aw-sync 0.1, and honestly? it's giving time-sync royalty. it's a User Command, it lives on your machine, and it's about to make your ActivityWatch buckets behave. sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

aw-sync — manual page for aw-sync 0.1

like. that's the name. that's the whole vibe. iconic 💅

---

🌈 SYNOPSIS 🌈

aw-sync [OPTIONS] [COMMAND]

that's it. options on the left, a command on the right if you feel like it. no cap.

---

🦋 DESCRIPTION 🦋

the commands, bestie (Commands:)

• daemon — Daemon subcommand. Starts aw-sync as a daemon, which will sync every 5 minutes. set it and forget it, main character energy 👑
• sync — Sync subcommand. that's the actual syncing right there. do the thing.
• list — List buckets and their sync status. a little inventory moment, we love a status check 🎀
• status — Doctor: classify every entry in the sync folder and say why pull is empty. literally a doctor. it's diagnosing why your pull came back empty and telling you why. so helpful, so generous 🩺
• dedupe — One-off cleanup: collapse exact-duplicate events in -synced-from- buckets (accumulated by pre-#713 pull passes that re-imported the resume-boundary event on every run). yeah it's a one-off, it's a little janitor sweep for old duplicate mess 🧚
• help — Print this message or the help of the given subcommand(s). the classic. when in doubt, ask for help, no shame 🌸

---

💅 OPTIONS 💅

• --host <HOST> — Host of instance to connect to. default is 127.0.0.1, so if you say nothing it's just talking to your own lil localhost bestie. [default: 127.0.0.1]
• --port <PORT> — Port of instance to connect to. the door number, basically 🚪
• -c, --config <CONFIG> — Path to the local aw-server config file. point it at your config, it'll read it.
• --profile <PROFILE> — Named instance profile (e.g. "default", "testing", "research"). --testing is an alias for --profile testing. Also reads AW_PROFILE, which aw-qt exports for the modules it spawns. so like, profiles are your little personas ✨
• --testing — Convenience option for using the default testing host and port. Alias for --profile testing. same thing, shorter to type, we love efficiency.
• --sync-dir <SYNC_DIR> — Full path to sync directory. If not specified, use AW_SYNC_DIR env var, or default to ~/ActivityWatchSync. so: flag → env var → home default. it's a whole hierarchy, it's strategic 📁
• --verbose — Enable debug logging. turn it on when you need to see everything, lowkey nosy but in a good way 🔍
• -h, --help — Print help. 🫶
• -V, --version — Print version. flex the version number real quick.

---

👑 SEE ALSO 👑

The full documentation for aw-sync is maintained as a Texinfo manual. If the info and aw-sync programs are properly installed at your site, the command

info aw-sync

should give you access to the complete manual. fr fr, the texinfo manual is the full lore, this page is the trailer 💜

---

lowkey reminder bestie: this is the aw-sync 0.1 manual, dated October 2026, and it's AW-SYNC(1) — section 1, User Commands. that's the whole source/version/date moment. don't forget it, it's part of the canon 🎀

okay that's the page, you ate that, go sync something 💖✨🦋