Skip to main content
plugin CX Codex

computer-usage-summary-skill — Codex plugin: what it does

computer-usage-summary-skill turns local ActivityWatch data into a daily report of app time, AFK, a timeline and foreground browser pages. Nothing leaves the machine.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install computer-usage-summary-skill@awesome-codex-plugins
Open on GitHub

What computer-usage-summary-skill does

The plugin ships a skill that reads your local ActivityWatch database and builds tables from it: a daily breakdown, per-app time, foreground browser pages and a chronological timeline. The default report merges all four. --format picks markdown, tsv, csv or json, and --output daily-apps.csv writes the result to a file. The script sits at skills/computer-usage-summary/scripts/activitywatch_summary.py, so you can call it from Codex or straight from a shell.

You need macOS, Python 3.9 or newer, and ActivityWatch already running with its window and AFK watchers on. This repository does not download, install or start ActivityWatch for you. Set it up from an official source and check the code signature and Gatekeeper prompt first. With nothing recording there is nothing to summarize, because macOS keeps no public record of foreground app time.

Browser rows cover pages seen in the foreground only. Open tabs and browser history never enter the report. Counting starts when ActivityWatch begins recording, so earlier days stay empty. Times follow the Mac system timezone unless you pass --timezone Area/City.

What it helps with

  • see where today's hours went
  • export app time to CSV for a spreadsheet
  • build a local-time timeline of the day
  • list browser pages with two minutes of foreground time
  • compare a multi-day range in one report

Example prompts for the agent

  • Summarize what I did today on my Mac.
  • Give me the app table for today as tsv.
  • Which browser pages had at least two minutes of foreground time today?

How to install computer-usage-summary-skill

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install computer-usage-summary-skill@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about computer-usage-summary-skill

How do I install computer-usage-summary-skill in Claude Code?

From the marketplace: run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install computer-usage-summary-skill@awesome-codex-plugins.

What does computer-usage-summary-skill do?

It builds a report for a day out of local ActivityWatch data: summary, apps, AFK, timeline and browser pages. The data stays on your machine.

Does it upload my activity data?

No. Everything is read and written locally, no browser extension is installed, and full page URLs are not shown.

Source text

computer-usage-summary-skill · MIT
# Computer Usage Summary Skill

[![CI](https://github.com/liuyewang/computer-usage-summary-skill/actions/workflows/test.yml/badge.svg)](https://github.com/liuyewang/computer-usage-summary-skill/actions/workflows/test.yml)
[![skills.sh](https://skills.sh/b/liuyewang/computer-usage-summary-skill)](https://skills.sh/liuyewang/computer-usage-summary-skill)
[![License: MIT](https://img.shields.io/badge/License-MIT-0f766e.svg)](LICENSE)
[![Local first](https://img.shields.io/badge/privacy-local--first-0f766e.svg)](PRIVACY.md)

**See where your time went, without sending it anywhere.**

A privacy-first Codex skill-only plugin that turns local
[ActivityWatch](https://activitywatch.net/) data into copyable daily overview,
app usage, local-time timeline, and foreground browser-page tables. The current
workflow targets macOS and keeps all activity data on the machine.

中文简介:这是一个基于本机 ActivityWatch 的 macOS 电脑使用情况汇总技能。它不会
上传活动数据,不安装浏览器扩展,也不会展示完整网址。

## Requirements

- macOS
- Python 3.9 or newer
- ActivityWatch running locally with the window and AFK watchers enabled

Install ActivityWatch from an official source of your choice. Before enabling
automatic startup, verify its publisher and operating-system security prompt.
On macOS, verify its code signature and Gatekeeper status. This
repository never downloads, installs, or starts ActivityWatch automatically.

## Install In Codex

Install the repository as a skill-only Codex plugin, or install the
`skills/computer-usage-summary` directory directly with Codex's skill
installer.
For a local clone under active development, link the source directory so every
source edit is used directly without reinstalling:

```bash
ln -s /absolute/path/to/computer-usage-summary-skill/skills/computer-usage-summary \
  ~/.codex/skills/computer-usage-summary
```

Start a new Codex task after creating or replacing the link so skill metadata
is rediscovered.

After this repository is published, a GitHub-directory install looks like:

```text
$skill-installer install https://github.com/liuyewang/computer-usage-summary-skill/tree/main/skills/computer-usage-summary
```

## Usage

Ask Codex: `Summarize what I did today on my Mac.`

Or run the bundled script directly:

```bash
# Complete copyable Markdown report
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today

# Paste an application table into Excel, Numbers, or Feishu Sheets
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today --format tsv --table apps

# Multi-day report using inclusive local dates
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --start 2026-07-20 --end 2026-07-26

# Structured JSON for additional analysis
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today --format json

# Paste a chronological timeline into a spreadsheet
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today --format markdown --table timeline

# Show foreground browser pages with at least two minutes of active time
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today --table browser --min-tab-seconds 120

# Save a UTF-8 CSV application table
python3 skills/computer-usage-summary/scripts/activitywatch_summary.py --date today --format csv --table apps --output daily-apps.csv
```

Tables are available as `summary`, `daily`, `apps`, `browser`, and `timeline`.
The default `report` combines the daily, app, browser, and timeline tables.
User-facing times use the Mac system timezone unless an explicit
`--timezone Area/City` override is supplied.

See the [local-first landing page](https://liuyewang.github.io/computer-usage-summary-skill/)
for a synthetic report preview and the [design-partner guide](docs/DESIGN_PARTNERS.md)
to help shape future reports without sharing activity data.

## Limitations

Accurate historical foreground and AFK time begins only after ActivityWatch
starts recording. Browser rows contain only pages observed in the foreground;
they do not represent every open tab or browser history. Without ActivityWatch,
macOS has no reliable public history for foreground-app time or launches.

See [PRIVACY.md](PRIVACY.md) for the data-handling rules and
[CONTRIBUTING.md](CONTRIBUTING.md) for development checks, and
[SUPPORT.md](SUPPORT.md) for safe support requests. Planned improvements are
listed in [ROADMAP.md](ROADMAP.md). Maintainers can reuse the
[launch kit](PROMOTION.md) for privacy-accurate project announcements. Public
product updates are recorded in [docs/CHANGELOG.md](docs/CHANGELOG.md).

## License

[MIT](LICENSE)

© liuyewang · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
court-rules court-rules is a Claude Code and Codex plugin that searches US federal and state filing rules, judges’ standing orders, and court holidays. Results cite the court’s own documents. CX Codex ★ 1,596repo stars coolify This plugin connects Claude Code to Coolify Cloud or a self-hosted Coolify instance, letting the agent manage applications, view deployment history, check logs, and control environment variables through the Coolify API. CX Codex ★ 1,596repo stars context-pack context-pack generates a compact first-pass repository briefing for coding agents. It saves initial tool calls when exploring unfamiliar codebases. CX Codex ★ 1,596repo stars contam-tools The contam-tools plugin connects an agent to a local CONTAM MCP server to inspect project files, run simulations, and review outputs. It fits workflows built around .prj models and ContamW. CX Codex ★ 1,596repo stars cometchat-skills Adds CometChat text chat, voice, and video calling skills to React, Angular, React Native, iOS, Android, and Flutter projects using the live Docs MCP. CX Codex ★ 1,596repo stars cohesivity Connect a coding agent to Cohesivity services for hosting, Postgres, email, and more through MCP or an API. CX Codex ★ 1,596repo stars codex-usage-tracker codex-usage-tracker is a Claude Code plugin that reads local Codex session logs for token summaries, session details, CSV exports, and dashboards. CX Codex ★ 1,596repo stars codex-tools-bridge codex-tools-bridge configures an experimental MCP bridge connecting ChatGPT Web to local Codex tools. It helps run local shell commands and edits directly from the web chat without a second model loop. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open