Pike Agent

pike-agent는 Linux에서 프로그램의 동작을 기록하고 분석합니다. 프로그램의 활동을 추적하여 데이터베이스에 인덱싱하고, TUI에서 LLM 에이전트와 이에 대해 대화할 수 있게 해줍니다.

프롬프트 예시:

• 충돌 진단: This program crashed with a bus error. What happened?
• 경합 조건 탐지: Are there any race conditions in how this program creates temporary files?
• 악성코드 분류: I found this process running on a production server. Should I be worried?

소개는 Say hi to Pike!에서 확인하세요.

작동 방식

pike-agent는 strace를 사용하여 프로그램이 실행하는 모든 시스템 호출을 기록한 다음, 전체 텍스트 검색이 가능한 SQLite 데이터베이스에 인덱싱합니다. LLM 에이전트가 도구 호출을 통해 이 데이터베이스를 조회하여 프로그램 동작에 관한 질문에 답변합니다.

• 로컬 추론(llama.cpp) 및 외부 API(Claude, Gemini 등) 지원
• 시스템 호출 인수에 대한 전체 텍스트 검색
• 시스템 호출 문서를 위한 매뉴얼 페이지 조회

설치

uv pip install -e .

Python 3.13+ 및 시스템에 strace가 설치되어 있어야 합니다.

사용법

첫 실행 시 ~/.config/pike-agent/config.toml에 기본 설정 파일이 생성됩니다. 이를 편집하여 추론 제공자와 모델을 구성하세요. 기본값은 로컬 llama.cpp 서버를 가리킵니다.

Pike-agent는 도구 호출에 능숙한 모델(예: Gemini 3 Pro, Qwen 3.5, Claude 4.6 Sonnet...)에서 가장 잘 작동합니다.

트레이스 기록

명령어 트레이스:

pike-agent run -- ./my-program --flag

실행 중인 프로세스에 연결:

pike-agent attach 1234

두 경우 모두 인덱싱된 트레이스가 포함된 .db 파일이 생성됩니다.

에이전트와 대화

기록된 트레이스에 대한 채팅 세션 시작:

pike-agent chat trace.db

라이선스

GPLv3.