Turn your Git history into a human story
Project description
____ _ _ ____ _ / ___|___ _ __ | |_ _____ _| |_| _ \ _ _| |___ ___ | | / _ \| '_ \| __/ _ \ \/ / __| |_) | | | | / __|/ _ \ | |__| (_) | | | | || __/> <| |_| __/| |_| | \__ \ __/ \____\___/|_| |_|\__\___/_/\_\\__|_| \__,_|_|___/\___|
Turn your Git history into a human story
ContextPulse is the only CLI tool that combines Git analytics, smart summaries, team insights, work patterns, and beautiful reports — all in one package. No more juggling 5 different tools.
Why ContextPulse?
| Feature | git-standup | git-quick-stats | onefetch | ContextPulse |
|---|---|---|---|---|
| Smart text summary | Yes | |||
| Category breakdown | Yes | Yes | ||
| Hot files detection | Yes | |||
| Work patterns (hours/days) | Yes | |||
| Period comparison (vs) | Yes | |||
| Commit streak tracker | Yes | |||
| Team report | Partial | Yes | ||
| Multi-repo scanning | Partial | Yes | ||
| HTML export | Yes | |||
| Hebrew support | Yes | |||
| Color themes | Partial | Yes | ||
| Interactive mode | Yes | Yes | ||
| Pretty git log | Yes | |||
| Project health scan | Partial | Yes |
Installation
pip install contextpulse
Quick Start
pulse # weekly report
pulse today # today only
pulse month # last 30 days
pulse scan # project health check
pulse team # who contributed what
pulse hours # your work patterns
pulse vs # this week vs last week
pulse streak # commit streak + calendar
pulse log # pretty git log with icons
pulse help # see all commands
All Commands
Reports
| Command | Description |
|---|---|
pulse |
Weekly activity report (default) |
pulse today |
Today's commits only |
pulse week |
Last 7 days |
pulse month |
Last 30 days |
pulse since 2026-03-01 |
From a specific date |
Analysis
| Command | Description |
|---|---|
pulse scan |
Project health check (6 checks + score) |
pulse team |
Top contributors with percentages |
pulse hours |
Work patterns by hour and day |
pulse vs |
Compare current period to previous |
pulse streak |
Commit streak tracker + 28-day calendar |
pulse log |
Pretty git log with smart icons |
pulse multi ~/code |
Scan all repos in a directory |
Options
| Flag | Short | Description |
|---|---|---|
--days N |
-d N |
Look back N days |
--author NAME |
-a |
Filter by author |
--compare A..B |
-c |
Compare two branches |
--export FILE |
-e |
Export to Markdown |
--html FILE |
Export to styled HTML | |
--json |
-j |
Output as JSON |
--lang he |
-l he |
Hebrew output |
--theme NAME |
Color theme (ocean/forest/sunset/minimal) | |
--version |
-v |
Show version |
Setup
| Command | Description |
|---|---|
pulse init |
Create .pulserc config for project defaults |
pulse i |
Interactive mode (guided menu) |
pulse help |
Full command reference |
Example Output
____ _ _ ____ _
/ ___|___ _ __ | |_ _____ _| |_| _ \ _ _| |___ ___
| | / _ \| '_ \| __/ _ \ \/ / __| |_) | | | | / __|/ _ \
| |__| (_) | | | | || __/> <| |_| __/| |_| | \__ \ __/
\____\___/|_| |_|\__\___/_/\_\\__|_| \__,_|_|___/\___|
Turn your Git history into a human story
╭────────────────────────────────────╮
│ ContextPulse - Git Activity Report │
│ last 7 days │
╰──────────── 54 commits ────────────╯
╭──────────────────────────── Summary ─────────────────────────────╮
│ You made 54 commits, focusing mainly on HTML (89%). Main │
│ activities: bug fixes, new features. Also touched: JavaScript. │
╰──────────────────────────────────────────────────────────────────╯
Hot Files (most changed)
┏━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
┃ # ┃ File ┃ Changes ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
│ 1 │ 🔥 index.html │ 12 │
│ 2 │ 🔥 index-en.html │ 11 │
│ 3 │ 🔥 sw.js │ 5 │
└─────┴──────────────────┴─────────┘
Daily Activity
2026-03-26 ███████████████████████ 7
2026-03-27 ██████████████████████████████ 9
+18815 lines added -4109 lines removed (net: +14706)
Total: 54 commits by 1 author(s), 633 file changes
Commit Streak
╭─────────────────────── Commit Streak ────────────────────────╮
│ 🔥 Current streak: 12 days 🔥 │
│ On fire! │
│ │
│ Best streak ever: 14 days │
│ Total active days: 21 │
╰──────────────────────────────────────────────────────────────╯
Last 28 days:
□ □ □ □ ■ ■ ■ ■ ■ ■ ■ ■ ■ □ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ □ ■ ■ □
Work Patterns
Activity by Hour
10:00 ████████████████████████ 18
13:00 █████████████████████████ 19
18:00 █████████████████████████ 19
Peak hour: 18:00 (19 commits)
Peak day: Friday (56 commits)
Pattern: You're a afternoon coder (12-18)
HTML Export
Export beautiful dark-themed HTML reports:
pulse --html report.html
Requirements
- Python 3.8+
- Git installed on your system
License
MIT
Made with Claude + determination
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file contextpulse-0.7.0.tar.gz.
File metadata
- Download URL: contextpulse-0.7.0.tar.gz
- Upload date:
- Size: 27.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d758e7fc2da27d75a1497000d28e0774068d9f32a03577699456e2daf3695730
|
|
| MD5 |
deb64579931b9344e7d2c58fbfa31fa3
|
|
| BLAKE2b-256 |
dc9de2e343edefed1bf83052983772ea2e1af049e716088f03de51601f28b9e2
|
File details
Details for the file contextpulse-0.7.0-py3-none-any.whl.
File metadata
- Download URL: contextpulse-0.7.0-py3-none-any.whl
- Upload date:
- Size: 24.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
974653f01aa8dc197a1b6ba80a401dd85c44c7e0fe595cd65bbef94ef7c2e403
|
|
| MD5 |
35b35de80e9729ad7941b57a25616925
|
|
| BLAKE2b-256 |
dffda526c4e6a3f35bcde9f1d13e6b65b6b528754aebd1f8825ce521678563d3
|