Local JSON / JSONL inspection and manipulation toolkit. Inspect deeply nested structures (path tree, types, sample values per path), query with a jq-style pa...
Data & analysis
Json Tools
Try itValidate, format, query, diff, filter, flatten, merge JSON files with dot-notation paths
What it does
Validate, format, query, diff, filter, flatten, merge JSON files with dot-notation paths
The skill document
JSON Toolkit
Validate, format, query, diff, filter, flatten, and merge JSON with dot-notation paths.
Keywords: json, tools, validate, query, diff, cli, data, python, open-source, agent, automation, MIT
Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.
What it does
JSON wrangling across many small tasks needs many one-off tools. JSON Toolkit solves this: Validate, format, query, diff, filter, flatten, and merge JSON with dot-notation paths.
Best for: Developers, data engineers, and agents processing JSON.
Features
- Validate JSON
- Format/pretty-print
- Query by dot path
- Diff two files
- Flatten/merge
Install
# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/json-tools/main/json_tools.py
# Or copy the file anywhere — it's self-contained.
Quick start
python json_tools.py self-test # prove it works end-to-end
python json_tools.py validate --help # validate subcommand
python json_tools.py format --help # format subcommand
python json_tools.py query --help # query subcommand
python json_tools.py diff --help # diff subcommand
python json_tools.py filter --help # filter subcommand
python json_tools.py stats --help # stats subcommand
python json_tools.py flatten --help # flatten subcommand
python json_tools.py merge --help # merge subcommand
Use cases
- Validate JSON
- Format/pretty-print
- Query by dot path
- Diff two files
- Flatten/merge
Why choose this over alternatives
| Alternative | Why this skill is better |
|---|---|
| jq | Familiar dot-path query plus diff/flatten/merge. |
| Online JSON formatters | Local, no upload. |
| Multiple tools | One CLI for the whole lifecycle. |
FAQ (SEO / AEO)
Q: Query syntax?
A: Dot-notation paths (e.g. a.b.c).
Q: Diff?
A: Semantic diff of two JSON files.
Q: Merge?
A: Deep merge with conflict handling.
Q: Offline?
A: Yes.
Geo / local reach
Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.
CI integration
# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Self-test json-tools
run: python json_tools.py self-test
Support
Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful:
- GitHub Sponsors: https://github.com/sponsors/itsPremkumar
- Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar
⭐ Star on GitHub
Related skills
Format and validate JSON files with pretty-printing, indentation control, key sorting, and validation modes supporting stdin, stdout, and file I/O.
Diagnose and fix JSON failures across parse, encoding, schema, query, size, and contract layers.
Convert JSON data into clean Markdown tables and reports. Use for pasted JSON, API or log output, or any batch of JSON records.
轻量级JSON语法校验工具,递归扫描工作区.json文件并输出结构化错误报告。Use when 需要文件处理、文档转换、格式互转、内容提取时使用。不适用于加密文件破解。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。提供结构化输出和错误处理机制。
Render compact generic data tables to PNG images with json-render-cli. Use when users ask to visualize arbitrary structured rows/columns (non-ticket-specific...