@kiniinsight/ai-native

AI 에이전트를 ai/ 폴더에 파일로 정의하고, 실행하고, 고친 내용을 규칙으로 남긴다. 어느 프로젝트에든 끼워 쓸 수 있다.

설치

pnpm add -D @kiniinsight/ai-native
pnpm ai init --model claude:sonnet

새 프로젝트부터 만들려면 (이름을 물어보고 클로드 코드까지 열어 준다):

pnpm create @kiniinsight/ai-native

sync --target claude 는 에이전트 파일과 함께 슬래시 명령도 만든다. 클로드 코드 안에서 /ai-run, /ai-learn, /ai-new, /ai-status 로 쓸 수 있다.

명령

pnpm ai check                                   # 파일 형식과 연결 검사
pnpm ai run <대상> --input <포트>=<값>            # 실행 (기록은 ai/runs/)
pnpm ai memory propose --run <실행 id>           # 실행을 돌아보고 규칙 제안
pnpm ai memory review <에이전트> <항목 id> --accept
pnpm ai mcp serve                               # MCP 서버로 열기
pnpm ai sync --target claude                    # 다른 AI 도구가 읽는 파일로 내보내기

--dir 을 주지 않으면 위로 올라가며 프로젝트의 ai/ 를 찾는다. 하위 폴더에서 쳐도 된다.

모델

ai/models.yaml 에서 공급사:모델 로 정한다. 공급사는 로컬에 설치된 코딩 에이전트 CLI 이름이다. API 키 대신 그 CLI의 로그인을 쓴다.

default: balanced
aliases:
  fast: claude:haiku
  balanced: claude:sonnet

전체 설명은 저장소에 있다. Node 26 이상이 필요하다.