gungarp/agent-runner

agent-runner은(는) 무엇을 하나요?

🤖 Claude Agent Framework로 워크플로를 자동화하여 유연한 실행과 원활한 통합을 통해 효율적인 AI 기반 작업을 수행합니다.

개요

gungarp/agent-runner는 Claude Agent Framework를 활용하여 AI 에이전트 워크플로를 정의하고 실행하기 위한 도구입니다. 반복적인 작업을 자동화하고, 여러 단계의 에이전트 작업을 조율하며, 외부 도구와의 통합을 간소화합니다.

주요 기능

• 워크플로 자동화: 다단계 에이전트 작업을 순차적으로 또는 조건부로 실행
• 유연한 통합: Claude Code, Cursor, Codex 등 다양한 에이전트 플랫폼과 호환
• 도구 지원: 파일 시스템, API 호출, 데이터베이스 쿼리 등 외부 도구 호출 지원
• 오류 처리: 자동 재시도, 오류 로깅, 사용자 정의 예외 처리
• 컨텍스트 관리: 에이전트 간 컨텍스트 전달 및 상태 유지

설치

# npm을 통한 설치
npm install -g gungarp/agent-runner

# 또는 GitHub 저장소에서 직접 클론
gh repo clone gungarp/agent-runner
cd agent-runner
npm install

사용법

기본 실행

agent-runner run --config workflow.yaml

설정 파일 예시

# workflow.yaml
name: "문서 요약 워크플로"
version: "1.0"
steps:
  - name: "문서 가져오기"
    agent: "claude"
    prompt: "주어진 문서를 읽어주세요."
    tools:
      - name: "read_file"
        params:
          path: "/path/to/document.md"
  - name: "요약 생성"
    agent: "claude"
    prompt: "위 문서의 핵심 내용을 3줄로 요약해주세요."
    depends_on:
      - "문서 가져오기"

환경 변수

변수명	설명	필수
ANTHROPIC_API_KEY	Claude API 키	예
AGENT_RUNNER_LOG_LEVEL	로그 레벨 설정 (debug, info, warn, error)	아니요
AGENT_RUNNER_TIMEOUT	각 단계 타임아웃 (초 단위)	아니요

지원 플랫폼

• Claude Code
• Cursor
• Codex CLI

라이선스

MIT License

기여

버그 리포트, 기능 제안, 풀 리퀘스트는 언제나 환영합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.