Skip to main content

Turn your Git history into a human story

Project description

   ____            _            _   ____        _
  / ___|___  _ __ | |_ _____  _| |_|  _ \ _   _| |___  ___
 | |   / _ \| '_ \| __/ _ \ \/ / __| |_) | | | | / __|/ _ \
 | |__| (_) | | | | ||  __/>  <| |_|  __/| |_| | \__ \  __/
  \____\___/|_| |_|\__\___/_/\_\\__|_|    \__,_|_|___/\___|
  

Turn your Git history into a human story

PyPI Python License


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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

contextpulse-0.8.0.tar.gz (32.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

contextpulse-0.8.0-py3-none-any.whl (28.9 kB view details)

Uploaded Python 3

File details

Details for the file contextpulse-0.8.0.tar.gz.

File metadata

  • Download URL: contextpulse-0.8.0.tar.gz
  • Upload date:
  • Size: 32.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for contextpulse-0.8.0.tar.gz
Algorithm Hash digest
SHA256 e38dc9cff993b5183cc4ddaa708e3f788e7d58e010aeec3bab1108bcb905ccd7
MD5 a473c5c1f8faee9c98b151a8a4dffe95
BLAKE2b-256 49c4c55aa24fd500bdddadda5d30890e04ac3f884ce5e7547700bc1101a5522a

See more details on using hashes here.

File details

Details for the file contextpulse-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: contextpulse-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 28.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for contextpulse-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 122d0f9532a46691ad149ef83fe21ef67dddeefcaadb08de6d976c00ef7919af
MD5 871bb9380ed1a5422f8f79979dc1ce9f
BLAKE2b-256 14e40a94b51c6fba597b98cbf7f715ec181ede385a0fd0d9417f3038627d99fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page