Agent Tool

코드를 블록 단위로 탐색하여
토큰 비용을 80% 절감

codeai는 AI 에이전트가 전체 파일이 아닌 함수, 클래스 단위로 정확히 필요한 코드만 읽도록 설계된 오픈소스 CLI입니다.

데모 보기 GitHub
Problem

기존 방식의 문제

AI 에이전트가 코드를 분석할 때, 하나의 함수만 필요해도 파일 전체를 읽어야 합니다. 수천 줄짜리 파일에서 10줄만 필요한 상황에서도 전체를 컨텍스트에 로드합니다.

코드베이스가 커질수록 비용은 기하급수적으로 증가하며, 에이전트의 컨텍스트 윈도우는 불필요한 코드로 가득 찹니다.

80% 읽어들인 토큰 중 사용되지 않는 비율
기존 방식
utils.py (2,400 lines)
1
2
3
4
5
6
7
8
9
10
11
12
codeai
parse_config()
6
7
8
9
10
2,400 tokens
전체 파일 로드
480
블록 단위 로드
블록 단위 인덱싱
코드를 함수, 클래스 단위로 자동 분류하여 필요한 부분만 즉시 꺼낼 수 있게 합니다.
# symbol_id로 코드 블록 식별
parse_config → utils::parse_config#a3f2
validate → utils::validate#b7c1
의미 기반 검색
질문과 가장 관련 높은 코드를 자동으로 찾아 딱 필요한 만큼만 반환합니다.
$ codeai search "config parsing" --budget 4096
# 3 blocks matched, 1,240 bytes
의존성 그래프
블록 간 호출 관계를 그래프로 제공하여 에이전트가 코드 구조를 한눈에 파악합니다.
parse_config → validate → load_yaml
Solution

codeai의 접근

codeai는 코드를 파일이 아닌 함수, 클래스 단위로 접근합니다. 코드가 변경되어도 참조가 안정적으로 유지되므로 에이전트가 항상 올바른 코드를 읽습니다.

질문에 가장 관련 있는 코드를 자동으로 찾아주고, 응답 크기를 제어해 컨텍스트 낭비를 방지합니다. 코드 간 관계도 한눈에 파악할 수 있습니다.

80% 토큰 비용 절감 달성
Demo

실제 동작 모습

Features

주요 기능

블록 레벨 주소 지정

함수, 클래스 단위로 코드에 접근합니다. 코드가 변경되어도 참조가 안정적으로 유지됩니다.

지능형 검색

함수 이름, 주석, 에러 메시지, 파일 경로까지 폭넓게 탐색하여 원하는 코드를 빠르게 찾습니다.

일괄 조회

여러 코드 블록을 한 번의 호출로 읽어 네트워크 왕복과 토큰 오버헤드를 최소화합니다.

출력 제한

응답 크기를 정밀하게 제어하여 컨텍스트 윈도우가 넘치는 것을 원천 차단합니다.

의존성 그래프

코드 간 호출 관계를 추적하여 코드베이스의 구조와 의존성을 한눈에 파악합니다.

Quick Start

시작하기

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

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

지원 언어

GoRustPython TypeScriptJavaScriptJava CC++Ruby Bash+7 more