https://github.com/conner2077/polars-daily-log

Your personal work-activity aggregator — tracks foreground activity + Git commits across all your machines, LLM-summarizes the day, and pushes to Jira / WeChat Work / Feishu / Slack. Runs 100% locally.
https://github.com/conner2077/polars-daily-log
activity-monitor fastapi jira linux llm local-first macos ocr productivity python sqlite time-tracking vue windows worklog
Last synced: about 1 month ago
JSON representation
Host: GitHub
URL: https://github.com/conner2077/polars-daily-log
Owner: Conner2077
License: apache-2.0
Created: 2026-04-15T10:09:54.000Z (about 2 months ago)
Default Branch: master
Last Pushed: 2026-04-20T14:06:16.000Z (about 1 month ago)
Last Synced: 2026-04-21T08:03:02.628Z (about 1 month ago)
Topics: activity-monitor, fastapi, jira, linux, llm, local-first, macos, ocr, productivity, python, sqlite, time-tracking, vue, windows, worklog
Language: Python
Homepage: https://conner2077.github.io/polars-daily-log/
Size: 4.34 MB
Stars: 3
Watchers: 0
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project

README

          




### Your day, automatically — from activity to worklog.

A personal, local-first work-activity aggregator. It silently tracks foreground activity and Git commits across all your machines, asks an LLM to summarize the day, and pushes the result to Jira / WeChat Work / Feishu / Slack with one click.

[中文](README_zh.md) / English

Report Issues · Feedback · Changelog · Release Guide

[![Release][release-shield]][release-link]

[![Stars][stars-shield]][stars-link]

[![Issues][issues-shield]][issues-link]

[![License][license-shield]][license-link]

[![Last commit][last-commit-shield]][last-commit-link]  

[![Python][python-shield]][python-link]

[![Platform][platform-shield]][platform-link]

[![Downloads][downloads-shield]][downloads-link]

🔒 **100% local** — one install per person, your data never leaves your own machines.



## Features



| Page | What it does |

|------|-------------|

| **Dashboard** | Today's work hours, activity count, timeline, pending logs |

| **Activities** | Browse all captured foreground windows, URLs, LLM summaries, screenshots |

| **MyLog** | View / edit / push daily, weekly, monthly, quarterly summaries |

| **Chat** | AI Q&A — ask about your week, draft timesheets, export conversations |

| **Issues** | Manage active Jira Issues for per-issue worklog splitting |

| **Settings** | LLM engines, Git repos, Jira, Prompts, scopes & outputs, privacy, auto-update |

For detailed usage with screenshots, see the [Usage Guide](docs/usage-guide.md).

---

## How many machines do you use?

| Your situation | How to install |

|---|---|

| **Just one computer** (most common) | Install `both` on that one machine — server + collector in one |

| **Multiple machines to aggregate** (MacBook + work desktop + Linux box etc.) | Install `both` on the machine that's always on as the hub; install `collector` only on the others and point them at the hub |

| **I want to hack on the code** | [Jump to §Developers](#developers) |

---

## Quick Start

### Prerequisites

| | macOS | Linux | Windows |

|---|-------|-------|---------|

| Python 3.9+ | built-in | built-in | `winget install Python.Python.3.12` |

| git | `xcode-select --install` | `apt install git` | `winget install Git.Git` |

### Install

#### One-liner (recommended, macOS / Linux)

```bash

curl -fsSL https://raw.githubusercontent.com/Conner2077/polars-daily-log/master/bootstrap.sh | bash

```

This pulls the latest release, extracts it to `~/.polars-daily-log`, and runs `install.sh` interactively.

Non-interactive variant (e.g. installing a collector on a second machine):

```bash

curl -fsSL https://raw.githubusercontent.com/Conner2077/polars-daily-log/master/bootstrap.sh | \

  PDL_ROLE=collector \

  PDL_SERVER_URL=http://your-hub-ip:8888 \

  PDL_COLLECTOR_NAME=my-laptop \

  bash

```

Optional env vars: `PDL_VERSION` (pin a version, default `latest`), `PDL_INSTALL_DIR` (default `~/.polars-daily-log`).

#### Manual install (Windows, or offline handoff)

1. **Download the tarball** from the [Releases page](https://github.com/Conner2077/polars-daily-log/releases)

2. **Extract**

   ```bash

   tar xzf polars-daily-log-0.2.0.tar.gz

   cd polars-daily-log-0.2.0

   ```

3. **Run the installer**

   ```bash

   # macOS / Linux

   bash install.sh

   # Windows (PowerShell)

   powershell -ExecutionPolicy Bypass -File install.ps1

   ```

4. **Follow the prompts**

   **Scenario A — only using this one machine**:

   ```

   0. What are you installing?

     1) server      — ...

     2) collector   — ...

     3) both        — ...

     Choose: 3          <- pick both

   ```

   **Scenario B — this is an additional machine, just push data to your hub**:

   ```

     Choose: 2          <- pick collector

     Server URL: http://your-hub-ip:8888

     Collector name [this-host]: <- press Enter for default

   ```

5. **Start it**

   ```bash

   ./pdl server start            # scenario A or the hub

   ./pdl collector start         # scenario B

   ```

6. **Open `http://127.0.0.1:8888`** (or the hub machine's IP). In Settings, configure:

   - **LLM**: choose Kimi / OpenAI / Claude, paste your API key (or leave blank to use the built-in Kimi default)

   - **Jira** (optional): if you want daily logs to sync as Jira worklogs, scan the QR to sign into Jira SSO

---

## Daily use

### Start / stop

| What | Command |

|---|---|

| Start everything | `./pdl start` (server + collector together) |

| Start server only | `./pdl server start` |

| Start collector only | `./pdl collector start` |

| Status | `./pdl status` |

| Stop | `./pdl stop` |

| Restart | `./pdl restart` |

### Logs / debug

```bash

./pdl server logs 100         # server backend log

./pdl server logs -f          # follow live

./pdl collector logs 50       # collector log

```

### Windows equivalents

On Windows, autostart goes through Scheduled Tasks (the installer asks whether to enable login autostart):

```powershell

Start-ScheduledTask -TaskName AutoDailyLogServer

Stop-ScheduledTask -TaskName AutoDailyLogServer

Get-ScheduledTaskInfo -TaskName AutoDailyLogCollector

```

### Where your data lives

| Thing | Path |

|---|---|

| Database (activities, logs, config) | `~/.auto_daily_log/data.db` |

| Screenshots | `~/.auto_daily_log/screenshots/YYYY-MM-DD/` |

| Server log | `~/.auto_daily_log/logs/server.log` |

| Collector log | `~/.auto_daily_log_collector/logs/collector.log` (standalone collector) |

| Config files | `/config.yaml`, `/collector.yaml` |

When you overwrite the tarball to upgrade, nothing under `~/` is touched — upgrades don't lose data.

---

## Core features

### Summary scopes

The system supports four calendar-aligned summary scopes, each with configurable trigger times:

| Scope | Description | Default trigger |

|-------|-------------|-----------------|

| Daily (day) | Summarize by natural day | 22:33 |

| Weekly (week) | Summarize by natural week (Mon–Sun) | Sunday |

| Monthly (month) | Summarize by natural month | End of month |

| Quarterly (quarter) | Summarize by natural quarter | End of quarter |

Manage scopes in **Settings > Scopes & Outputs**. Each scope can have multiple outputs, each with its own LLM engine, Prompt template, and publisher config.

### Multi-engine LLM

Configure multiple LLM engines (Kimi / OpenAI / Claude / custom endpoint) simultaneously — different outputs can use different engines. Manage in **Settings > LLM Engines**.

### Git repo collection

Add local git repo paths and author email in **Settings > Git Repos**. The system automatically collects today's commits (message, insertions/deletions, file list) when generating logs, feeding them to the LLM alongside foreground activities for more accurate summaries.

### Push to messaging platforms (Webhook)

Besides Jira, you can push daily logs to group chats via webhook — WeChat Work, Feishu, Slack, or any HTTP endpoint.

1. **Get the webhook URL** from your group chat bot settings

2. **Open Settings** > "Scopes & Outputs" > add or edit an output

3. Set **Push Platform** to "Webhook", paste the URL, pick **Message Format** (WeChat Work / Feishu / Slack / Generic JSON)

4. Set **Push Mode** to "Manual" or "Auto-push after scheduled generation"

| Format | Body sent |

|---|---|

| WeChat Work | `{"msgtype":"markdown","markdown":{"content":"..."}}` |

| Feishu | `{"msg_type":"text","content":{"text":"..."}}` |

| Slack | `{"text":"..."}` |

| Generic JSON | `{"issue_key":"...","time_spent_sec":...,"comment":"...","started":"..."}` |

> **Manual vs auto**: "Auto-push after scheduled generation" only triggers when the scheduler generates logs on its cron schedule. Manually clicking "Generate" in the UI will **not** auto-push — use the push button on the generated summary instead.

### Chat — AI Q&A

AI-powered conversation based on the last 7 days of work logs and activities. You can:

- Ask "what did I do this week?"

- Ask it to "draft a timesheet for me"

- Export conversation history

### Privacy

- All data is stored 100% locally — nothing is uploaded to any server

- Configure `blocked_apps` / `blocked_urls` in `config.yaml` to exclude specific apps or URLs

- Sensitive apps like WeChat Work are skipped for deep introspection via `hostile_apps_applescript` config

- Deleted data goes to the recycle bin; permanently clean up in **Settings > Recycle Bin**

### Feedback

Click **"Feedback"** in the left sidebar — pick a type (Bug / Suggestion / Other), write a few words and submit. The current page URL and browser UA are attached automatically.

---

## Upgrade

**Installed via the one-liner**: rerun the same curl command. It upgrades in place (runs `./pdl stop` first; your data under `~/` is untouched).

**Installed manually**:

```bash

# Stop services

./pdl stop

# Overwrite the install dir with the new tarball (venv is kept, data under ~/ is kept)

tar xzf polars-daily-log-0.2.0.tar.gz --strip-components=1

# Reinstall Python from the new wheel; the frontend dist ships inside the wheel

./pdl build --restart

```

You can also enable auto-update detection in **Settings > Auto Update**.

If a release requires config migration, it'll be called out at the top of `CHANGELOG.md`.

---

## Uninstall

```bash

./pdl stop

cd ..

rm -rf ~/.polars-daily-log            # or your manual install dir

rm -rf ~/.auto_daily_log              # data + logs (skip if you want to keep them)

rm -rf ~/.auto_daily_log_collector    # standalone collector credentials + offline queue

```

Windows extras:

```powershell

Unregister-ScheduledTask -TaskName AutoDailyLogServer -Confirm:$false

Unregister-ScheduledTask -TaskName AutoDailyLogCollector -Confirm:$false

```

---

## Troubleshooting

| Symptom | What to check |

|---|---|

| `No module named aiosqlite` on startup | venv not activated / `install.sh` was skipped. Rerun `bash install.sh` |

| Daily summary contains only `Activity summary: ...` lines | LLM call failed → in Web UI Settings, verify engine / URL / API key match |

| Submitting to Jira returns 500 "Internal Server Error" | The comment contained an emoji. The latest version scrubs these automatically — upgrade |

| WeCom auto-exits after 2-4 minutes | Make sure `monitor.hostile_apps_applescript` in `config.yaml` includes `wechat/wecom/企业微信` |

| Webhook push shows success but group didn't receive | Check that `format` in publisher_config matches the platform (`wecom` for WeChat Work, `feishu` for Feishu) |

| Frontend blank page | `./pdl server logs 50` to check the backend; hard-reload the browser (Cmd/Ctrl+Shift+R) |

| Windows collector is idle | Check `%USERPROFILE%\.auto_daily_log_collector\logs\collector.log` and the Scheduled Task status |

---

## Developers

If you cloned the repo instead of unpacking a tarball:

### Prerequisites

- Python 3.9+, Node.js 18+, git

### Getting started

```bash

git clone https://github.com/Conner2077/polars-daily-log.git

cd polars-daily-log

bash install.sh              # auto-detects no wheel -> dev mode (pip install -e . + frontend source build)

./pdl server start

```

### Day-to-day

| What | Command |

|---|---|

| Rebuild after pull | `./pdl build --restart` |

| Frontend only | `./pdl build --no-python` |

| Run tests | `.venv/bin/python -m pytest tests/ -q` |

| Frontend hot-reload dev | `cd web/frontend && npm run dev`, open `localhost:5173` |

### Cutting a release

See [`docs/release.md`](docs/release.md).

### Project principles

See [AGENTS.md](AGENTS.md) (Claude Code loads it via `CLAUDE.md -> @AGENTS.md`). The core rules:

- **Keep the raw record**: daily summaries don't filter; downstream consumers (Jira submission uses `AUTO_APPROVE_PROMPT`) do the filtering

- **Two-layer platform code**: raw OS APIs live in `auto_daily_log/monitor/`; adapters live in `auto_daily_log_collector/platforms/`

- **Single Jira entry point**: `jira_client.client.build_jira_client_from_db`, which handles emoji / 4-byte UTF-8 scrubbing for you

---

## License

Apache 2.0. See [LICENSE](LICENSE).

[release-shield]: https://img.shields.io/github/v/release/Conner2077/polars-daily-log?style=flat-square&color=brightgreen&label=release

[release-link]: https://github.com/Conner2077/polars-daily-log/releases

[stars-shield]: https://img.shields.io/github/stars/Conner2077/polars-daily-log?style=flat-square&color=yellow

[stars-link]: https://github.com/Conner2077/polars-daily-log/stargazers

[issues-shield]: https://img.shields.io/github/issues/Conner2077/polars-daily-log?style=flat-square&color=orange

[issues-link]: https://github.com/Conner2077/polars-daily-log/issues

[license-shield]: https://img.shields.io/github/license/Conner2077/polars-daily-log?style=flat-square&color=blue

[license-link]: https://github.com/Conner2077/polars-daily-log/blob/master/LICENSE

[last-commit-shield]: https://img.shields.io/github/last-commit/Conner2077/polars-daily-log?style=flat-square

[last-commit-link]: https://github.com/Conner2077/polars-daily-log/commits/master

[python-shield]: https://img.shields.io/badge/python-3.9%2B-blue?style=flat-square&logo=python&logoColor=white

[python-link]: https://www.python.org/downloads/

[platform-shield]: https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square

[platform-link]: #prerequisites

[downloads-shield]: https://img.shields.io/github/downloads/Conner2077/polars-daily-log/total?style=flat-square&color=success

[downloads-link]: https://github.com/Conner2077/polars-daily-log/releases
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/conner2077/polars-daily-log

Awesome Lists containing this project

README
