도구별 실전 가이드 · 공식 정보 확인 2026-08-20
mini-swe-agent MIT 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: CLI · 페이지 갱신: · 운영·편집 기준
간결한 명령줄 하네스에서 저장소를 조사하고 이슈 해결 패치를 만드는 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트입니다.
간결한 명령줄 하네스에서 저장소를 조사하고 이슈 해결 패치를 만드는 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트입니다. mini-swe-agent의 첫 실전 과제는 “재현 테스트가 있는 사소한 파서 버그를 수정하고 패치 검토하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “저장소 체크아웃과 실패 명령·기대 동작이 적힌 GitHub 이슈” 같은 입력으로 mini-swe-agent의 핵심 기능을 시험하려는 사람
- 재현 테스트와 기존 테스트가 모두 통과하고 패치가 원인 파일에만 한정되는지 기준으로 mini-swe-agent 결과를 직접 검수할 수 있는 경우
- CLI 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 단순한 하네스에 샌드박스가 있다고 가정해 모델이 제안한 셸 명령을 무감독 실행하는 위험.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
GitHub 이슈를 단일 재현으로 바꾼다
파서 버그를 보여 주는 실패 명령과 기대 동작이 명확해진다.
참고 시작점: 이 GitHub 이슈의 실패 명령을 재현하고 관찰값과 기대값만 먼저 설명해 줘.
- mini-swe-agent를 별도 브랜치의 저장소 루트에서 시작한다.
- GitHub issue와 실패 명령·수정 금지 경로를 agent 입력에 함께 준다.
- 에이전트가 제안한 첫 셸 명령을 사람이 읽고 저장소 밖 접근을 막는다.
100줄 하네스로 원인 패치를 만든다
파서 원인에 한정된 작은 diff가 생긴다.
참고 시작점: 실패를 일으킨 파서 분기만 수정하고 재현 테스트를 먼저 추가해 줘.
- radically simple harness의 탐색 결과에서 실제 실패 분기를 확인한다.
- 새 재현 테스트가 수정 전 실패하는지 독립 실행한다.
- 패치에서 새 의존성과 광범위한 포맷 변경을 제거한다.
SWE 점수 대신 저장소 증거를 확인한다
재현·기존 테스트와 최소 diff가 모두 검증된다.
참고 시작점: 재현 테스트와 전체 테스트를 실행하고 바뀐 파일과 종료 코드를 보고해 줘.
- 수정 후 재현 테스트가 통과하고 실패 이유가 사라졌는지 확인한다.
- 기존 테스트 전체를 사람 승인으로 실행한다.
- SWE-bench 성능 주장과 별개로 현재 저장소의 git diff가 원인 파일에 한정됐는지 본다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
단순한 하네스에 샌드박스가 있다고 가정해 모델이 제안한 셸 명령을 무감독 실행하는 위험.
직접 대안과 비교
- jcode — 터미널 TUI에서 GitHub 이슈와 실패 테스트를 받아 코드베이스를 탐색·수정하므로 같은 사소한 파서 버그의 최소 패치를 만들 수 있다.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | 간결한 명령줄 하네스에서 저장소를 조사하고 이슈 해결 패치를 만드는 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트입니다. | mini-swe-agent 공식 사이트 |
| 무료 조건 | MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | 간결한 명령줄 하네스에서 저장소를 조사하고 이슈 해결 패치를 만드는 작은 코드로 구성된 GitHub 이슈 해결 CLI 에이전트입니다. | 공식 제품 페이지 |