json-query-expert

Use json_query_query_json with a JSONPath expression like "$.scripts.dev" to extract only the targeted value. This avoids loading files over 1000 lines into context and keeps token usage minimal.

First locate the key with json_query_search_keys to find its exact line, then apply a surgical change with edit_file at that line. Validate the result afterward by re-querying the JSONPath to confirm syntax remains valid.

JSONPath expressions must start with $, such as "$.database.connections[0].host" for nested access or "$.array[*]" for all elements. Recursive search uses "$..deeplyNested" and filters use "$.array[?(@.type=='button')]".

Never fully load JSON files over 1000 lines, such as large i18n or manifest files. Instead inspect with JSONPath queries first, and only read small line ranges with context once the target location is confirmed.

Queries fail when the path syntax is wrong, the file is invalid JSON, or the key does not exist. Verify the file validity first, confirm the path starts with $, and test the query on a small sample before editing.