gitpulse
CLI tool to inspect recent git commit history from any local repository.
pip install rook-gitpulse
Usage
gitpulse [PATH] [OPTIONS]
| Argument / Option | Description |
|---|---|
PATH |
Path to a git repository (default: current directory) |
--limit N |
Number of recent commits to show (default: 10) |
--output FORMAT |
Output format: text, json, table, or csv |
Examples
# last 10 commits from current repo
gitpulse
# another repo, 25 commits, in a table
gitpulse ~/projects/myapp --limit 25 --output table
# pipe to jq
gitpulse . --output json | jq '.items[].title'
# export to CSV
gitpulse . --output csv > commits.csv
Output modes
text (default) — human-readable digest:
# gitpulse
1. **fix: handle edge case in parser** (by alice · 2026-08-18 · 3fa1c2b0)
2. **feat: add csv export** (by bob · 2026-08-17 · 8d2e9a11)
json — structured output:
{
"source": "gitpulse",
"count": 2,
"items": [
{ "title": "fix: handle edge case", "author": "alice", "body": "3fa1c2b0", ... }
]
}
table — markdown table with subject, author, date, hash
csv — spreadsheet-friendly rows
Agent use
gitpulse introspect # ACLI-compliant JSON tool description
gitpulse skill # agentskills.io-compliant SKILL.md
Install from source
git clone https://github.com/rook-builds/gitpulse
cd gitpulse
pip install -e .
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
rook_gitpulse-0.1.0.tar.gz
(4.8 kB
view details)
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 rook_gitpulse-0.1.0.tar.gz.
File metadata
- Download URL: rook_gitpulse-0.1.0.tar.gz
- Upload date:
- Size: 4.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dae0f21e8e8174c98734a0efe144334fcf9b4608f0464c5777768f9c7eed7550
|
|
| MD5 |
140ef721a877b2d53b1d4ea2d663df01
|
|
| BLAKE2b-256 |
255bd87db569c721d37c67e48aaa9c826c12db4407ba14b71a7325eff76e4611
|
File details
Details for the file rook_gitpulse-0.1.0-py3-none-any.whl.
File metadata
- Download URL: rook_gitpulse-0.1.0-py3-none-any.whl
- Upload date:
- Size: 2.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a9d277fee34a9f22568fdd3b26ad0fc2e9e2f4ff4a72515c1fbbd11801b86c32
|
|
| MD5 |
b99c246807377b659134190c3e1f13f2
|
|
| BLAKE2b-256 |
c144dc72a5da92cbd06aa6848d2edc8191df471931bbb3295bcfaa8497254ad0
|