Agent Tool

AI 에이전트를 위한
지능형 JSON 처리 도구

jsonai는 컴팩트 출력, 전문 검색, 내장 jq 필터로 AI 에이전트의 JSON 데이터 처리 효율을 극대화하는 오픈소스 CLI입니다.

데모 보기 GitHub
Problem

기존 방식의 문제

AI 에이전트가 JSON 데이터를 처리할 때, 파일 전체를 읽어 컨텍스트에 로드합니다. 대용량 JSON에서 하나의 필드만 필요한 경우에도 전체 데이터가 토큰으로 변환됩니다.

jq가 설치되지 않은 환경에서는 필터링조차 불가능하며, 결과가 컨텍스트 한도를 초과하면 작업 자체가 실패합니다.

100% 불필요한 데이터까지 전부 읽는 기존 방식
기존 방식
data.json (15,000 lines)
1
2
3
4
5
6
7
8
9
10
11
12
jsonai
.users[0].email
6
7
12,000 tokens
전체 JSON 로드
600
jq 필터 결과
컴팩트 출력
모든 JSON 출력에서 불필요한 공백과 줄바꿈을 제거하여 토큰을 절약합니다.
# pretty (240 tokens) → compact (80 tokens)
{"users":[{"name":"Kim","email":"k@ex.com"}]}
전문 검색 + jq 필터
원하는 데이터를 검색하고, jq 필터로 정제합니다. 별도 설치 불필요.
$ jsonai search "Kim" --query '.email' --budget 2048
# "k@ex.com"
JSON Pointer 수정
라인 번호 없이 경로로 정확한 위치를 지정하여 데이터를 안전하게 수정합니다.
/users/0/email → "new@ex.com"
Solution

jsonai의 접근

jsonai는 출력에서 불필요한 공백을 자동 제거하여 토큰을 절약합니다. 전문 검색으로 필요한 데이터만 정확히 반환하고, jq 필터가 내장되어 별도 설치 없이 바로 사용 가능합니다.

결과 크기를 자동으로 제어하여 컨텍스트 오버플로우를 원천 차단하며, 라인 번호 없이도 정확한 위치를 지정하여 안전하게 수정합니다.

0 jq 별도 설치 필요 없음
Demo

실제 동작 모습

Features

주요 기능

컴팩트 출력

모든 출력이 기본적으로 컴팩트 JSON으로 처리되어 불필요한 공백 없이 토큰을 절약합니다.

전문 검색

필요한 데이터만 정확히 찾아 반환하므로 대용량 JSON 전체를 읽을 필요가 없습니다.

내장 jq 필터

jq 설치 없이 네이티브로 jq 표현식을 실행하여 어떤 환경에서도 동작합니다.

오버플로우 방지

결과가 너무 크면 자동으로 실행 계획을 반환하여 컨텍스트 오버플로우를 차단합니다.

경로 기반 수정

라인 번호 대신 경로로 정확한 위치를 지정하여 데이터를 안전하게 수정합니다.

Quick Start

시작하기

한 줄의 명령으로 설치가 완료됩니다.

$ curl -fsSL https://raw.githubusercontent.com/worktoolai/jsonai/main/install.sh | sh