# Git Query Tools

> git_history and json_query tools for structured git log exploration and jq-style JSON querying.

- Skill: `rcarmo/git-query-tools` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rcarmo/git-query-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rcarmo/git-query-tools/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rcarmo (https://skillmd.com/u/rcarmo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rcarmo/git-query-tools

---


# Git Query Tools

Two workspace tools for structured data queries.

## git_history

Prefer over raw `git log` commands. Returns structured JSON with truncation.

```
git_history({ mode: "log", max_count: 10 })                  # recent commits
git_history({ mode: "message_search", query: "fix bug" })    # search commit messages
git_history({ mode: "content_search", query: "TODO" })       # search code history
git_history({ mode: "blame", file: "path/to/file" })         # file blame
```

## json_query

Prefer over shell `jq` piping. Validates expressions and returns structured output.

```
json_query({ file: "data.json", expression: ".items[] | .name" })
json_query({ input: '{"a":1}', expression: ".a" })
```