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 trends # weekly trends over time
pulse diff # what exactly changed
pulse blame # who owns what + bus factor
pulse log # pretty git log with icons
pulse learn # code guide (HTML)
pulse learn --beginner # code guide with explanations
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 trends |
Weekly trends with arrows |
pulse diff |
Pretty diff — what exactly changed |
pulse blame |
Code ownership + Bus Factor |
pulse badges |
Your achievements (16 badges) |
pulse leaderboard |
Contributor ranking |
pulse log |
Pretty git log with smart icons |
pulse learn |
Generate code guide (HTML) |
pulse learn --beginner |
Code guide with tooltips for beginners |
pulse multi ~/code |
Scan all repos in a directory |
pulse changelog |
Auto-generate changelog |
pulse standup |
Standup report (paste to Slack) |
pulse id |
Repo identity card |
pulse quality |
Commit message quality score |
pulse age |
Code age map (stale files) |
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 |
Theme: ocean/forest/sunset/minimal/colorblind/high-contrast | |
--accessible |
No colors/art (screen reader friendly) | |
--version |
-v |
Show version |
Setup
| Command | Description |
|---|---|
pulse init |
Create .pulserc config for project defaults |
pulse hook |
Install post-commit mini report |
pulse watch |
Live dashboard (auto-refresh) |
pulse i |
Interactive mode (guided menu) |
pulse help |
Full command reference |
Smart Mode (Natural Language)
Type freely in Hebrew or English — ContextPulse understands intent:
pulse מה עשיתי השבוע # → pulse --week
pulse מי עבד השבוע # → pulse team 7
pulse האם השתפרתי החודש # → pulse trends 30
pulse show me the team weekly # → pulse team 7
pulse תפתח לי לימוד מתחיל # → pulse learn --beginner
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-1.4.3.tar.gz.
File metadata
- Download URL: contextpulse-1.4.3.tar.gz
- Upload date:
- Size: 52.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a1138cc77c407861660c87308e68a1e8f099421152424fa06beb2429bc22053b
|
|
| MD5 |
7e0e102b0ba4204260484d901c25c5e8
|
|
| BLAKE2b-256 |
7ddabb174783900e29bedd7dc0e637b5d8aebe0ab7c0597118d4a099462c2ce3
|
File details
Details for the file contextpulse-1.4.3-py3-none-any.whl.
File metadata
- Download URL: contextpulse-1.4.3-py3-none-any.whl
- Upload date:
- Size: 50.5 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 |
3e19c7eb71dd9f475c2ec1a49b06304c5dbed5fc0cb3ae342fa0bf5b44fac38b
|
|
| MD5 |
458b92fc2f75012360db9b8573346e9b
|
|
| BLAKE2b-256 |
9ffc97fa0e1ccc3a9b702331c6bb68cb4081ae744b94ec4fa0232b63d5790517
|