ejboy/agent-scripts

agent-scripts는 AI 지원 개발을 위한 작고 로컬 우선의 커맨드라인 유틸리티 모음입니다. 주요 도구인 mvn-lite, npm-lite, 그리고 go-lite는 빌드 및 테스트 출력 노이즈를 줄여 에이전트가 더 많은 유용한 컨텍스트를 유지하도록 돕습니다. 지원하는 유틸리티에는 브라우저 자동화, VS Code 확장 프로그램 테스트, 로컬 리포지토리 검색 등이 포함됩니다. 이 스크립트들은 예측 가능한 커맨드 이름을 사용하며 PATH에서 잘 작동하고, 개발자와 코딩 에이전트 모두가 쉽게 발견하고 호출할 수 있도록 설계되었습니다.

Agent Scripts는 다음과 같은 Agent Skills를 제공합니다:

• repolink: 리포지토리 및 로컬 도구 검색용
• lite-tools: 더 조용하고 토큰 효율적인 Maven, npm/Node, Go 테스트 워크플로우용
• lightweight-monitoring (실험적): 프레임워크 네이티브 기능과 선택적 StatLite 통합을 통한 최소한의 애플리케이션 모니터링용

관련 항목: AI Badger handoff skills
Badger에서 세션을 이어가기 위한 handoff와 독립적인 검토를 위한 badger-review를 제공합니다.

• mvn-lite: 빌드, 테스트 및 검증 실행을 위한 간결한 Maven 출력
• npm-lite: 지원되는 npm 테스트 및 검증 워크플로우를 위한 간결한 출력 (최대 99.99%의 측정된 출력 감소율)
• go-lite: 코딩 에이전트를 위한 간결한 go test 출력
• html-screenshot: 로컬 HTML 또는 URL을 PNG로 렌더링
• launch-browser: DevTools가 활성화된 Chrome 실행
• vscode-test: 간결하고 승인하기 쉬운 VS Code 확장 프로그램 테스트
• repolink: 로컬 리포지토리 및 에이전트 기능 검색을 위한 RepoLink
• slopstop: macOS에서 오래된 개발 워크로드를 스캔하고 선택적으로 검증된 유휴 서비스를 중지시킴

측정된 출력 절감, 권장 사용 사례 및 실험적 제한 사항에 대한 내용은 참고하십시오.

공개적인 독립형 유틸리티는 scripts/ 아래에 있습니다. 리포지토리 릴리스 도구는 별도의 maintainers/ 아래에 있으며 공개 유틸리티 인터페이스의 일부가 아닙니다.

가장 간단한 설치 프로그램은 전체 리포지토리를 ~/.local/share/agent-scripts 아래에 유지하고 네 가지 핵심 커맨드를 ~/.local/bin으로 심볼릭 링크합니다.

설치 스크립트는 Git을 사용 가능할 때 이를 이용하고, 그렇지 않을 경우 전체 아카이브 스냅샷을 다운로드합니다. 쉘 시작 파일은 수정하지 않습니다. 저장소의 전체 scripts/ 디렉터리를 PATH에 추가하는 것이 모든 현재 및 미래 스크립트에 접근하기 위한 권장 설정입니다:

export PATH="$HOME/.local/share/agent-scripts/scripts:$PATH"

수동 Git 설치를 하려면, 저장소를 클론하고 그 scripts/ 디렉터리를 PATH에 추가하십시오:

mkdir -p "$HOME/.local/share"
git clone https://github.com/ejboy/agent-scripts.git ~/.local/share/agent-scripts
export PATH="$HOME/.local/share/agent-scripts/scripts:$PATH"

이 도구들을 향후 세션에서도 사용할 수 있도록 export 라인을 쉘 시작 파일에 추가하십시오. 그러면 모든 프로젝트에서 이름으로 scripts/ 아래의 도구들을 호출할 수 있습니다.

참고

Skills와 명령어 설치는 별개입니다. 이 저장소의 스킬(skills)을 설치하는 방법, 선택적 모니터링 실험을 포함하여 자세한 내용은 skills/README.md를 참조하십시오. 저장소 설치 프로그램은 명령어만 설치하며 Skills CLI를 호출하지 않습니다.

쉘 설정, 업데이트, 제거 및 선택적 프로젝트 로컬 고정(pinning)에 대한 내용은 설치 가이드를 참조하십시오.

코딩 에이전트를 위한 내향적인 Maven.

mvn-lite clean verify
mvn-lite -pl app -am test
mvn-lite --full dependency:tree

옵션, 출력 동작, 실패 로그, 범위(scope), 실제 프로젝트 증거에 대한 내용은 mvn-lite 가이드를 참조하십시오.

npm-lite는 지원되는 두 가지 npm 워크플로우와 직접적인 Node 테스트 실행의 성공적인 출력을 줄여주면서 다른 호출은 변경되지 않게 유지합니다:

npm-lite run verify
npm-lite run test:unit
npm-lite node --test path/to/test.js

지원되는 명령어, 카운트 형식, 실패 진단, 로그, 제한 사항 및 실험 증거에 대한 내용은 npm-lite 가이드를 참조하십시오.

go-lite는 일반적인 go test 출력을 캡처하고 간결한 성공 라인을 보고하는 동시에 완전한 실패 로그를 유지합니다. 다른 Go 명령어들은 정상적으로 통과됩니다.

go-lite test ./...
go-lite test ./internal/storage
go-lite --full test ./...

캐시 동작 방식, 실패 로그, 제한 사항 및 샌드박스 기대치에 대해서는 go-lite 가이드를 참조하세요.

slopstop

slopstop은 네이티브 상태를 확인한 후에만 중지해도 안전한 Colima, Gradle, mvnd 후보만을 보고합니다. 오래되었거나 리소스를 많이 사용하는 프로세스는 “검토 필요(Needs review)” 아래에 표시되며 자동으로 중지되지 않습니다. 기본 스캔은 읽기 전용이며, --stop은 한 번 확인하고, --stop-safe는 프롬프트 없이 안전한 후보들을 중지합니다. 각 안전 후보는 중지 직전에 다시 확인됩니다. SlopStop은 macOS에서만 지원됩니다.

slopstop
slopstop --stop

현재 감지기 규칙 및 제한 사항은 SlopStop 가이드에 있습니다. Dogfooding을 하는 동안, 이 저장소의 scripts/ 디렉토리를 위에서 보여준 것처럼 PATH에 추가하세요.

launch-browser는 DevTools가 활성화된 Google Chrome을 http://127.0.0.1:9222에서 시작하기 위한 별도의 macOS 유틸리티입니다. 기본적으로 분리형 헤드리스 모드로 작동합니다.

launch-browser
launch-browser --visible
launch-browser --foreground --isolated
...

성공적인 분리형 실행은 서비스 레이블과 PID를 ~/.browser-testing-profile/launch-state에 기존의 영구 브라우저 프로필과 함께 기록합니다. --stop은 기록된 서비스가 xyz.pvrlabs.browser.* 접미사를 사용하는지 검증하고, launchctl에게 이를 중지하도록 요청하며, 상태를 제거하기 전에 기록된 PID와 DevTools 엔드포인트 둘 다 중지되었는지 확인합니다. 만약 서비스 제거 후에도 기록된 PID가 포트 9222를 여전히 소유하고 있다면, 스크립트는 해당 프로세스를 직접 종료합니다. 이는 단순히 포트 9222를 사용한다는 이유만으로 임의의 프로세스를 강제 종료하지 않습니다.

임시 실행 로그는 Chrome이 정상적으로 종료될 때 제거되며, 비정상 종료 로그는 진단을 위해 계속 사용할 수 있습니다.

html-screenshot은 로컬 HTML 파일, file:// URL 및 HTTP(S) URL을 위한 단발성 헤드리스 Chrome 렌더러입니다. 재사용 가능한 브라우저 인스턴스를 시작하거나 관리하지 않습니다.

html-screenshot examples/page.html
html-screenshot --width 1440 --height 900 --wait 1000 -o /tmp/page.png examples/page.html
html-screenshot --scale 2 https://example.com

macOS의 표준 Chrome 및 Chromium 애플리케이션 위치를 검색한 후 PATH를 확인합니다.

명시적으로 실행 파일을 선택하려면 --chrome /path/to/chrome 또는 CHROME_BIN=/path/to/chrome을 사용하세요. 기본 뷰포트는 1280×720이며 가상 시간 대기 시간은 500ms입니다. 성공적인 기본 출력은 한 줄이며, Chrome 진단 정보를 유지하려면 --verbose를 사용하세요. 실패한 렌더링에는 항상 Chrome 진단 정보가 포함됩니다.

릴리스 유지보수는 maintainers/README.md에 문서화되어 있습니다.

vscode-test

macOS VS Code 확장 프로그램 테스트를 위한 고정되고 재사용 가능한 작업을 제공합니다. 안정적인 명령어 접두사는 인라인 JavaScript 변경에 대한 반복적인 승인을 방지하며, 간결한 검사 및 제한된 텍스트 출력은 기록 노이즈를 줄입니다.

vscode-test launch --extension-development-path ./extension ./fixture
vscode-test launch --extension-development-path ./extension ./review.code-workspace
vscode-test inspect page
...

실행 워크스페이스는 디렉터리 또는 기존의 .code-workspace 파일일 수 있습니다. 기본 DevTools 포트는 9223입니다. 실행 상태, 프로필, 확장 프로그램 저장소 및 진단 로그는 ~/.agent-scripts/vscode-test 아래에 보관됩니다. 검사(Inspection)는 임의의 JavaScript를 허용하지 않습니다: inspect는 한 줄 JSON 요약을 출력하고, controls는 보이는 접근 가능한 컨트롤과 그 둘러싸고 있는 UI 컨텍스트 목록을 제공하며, text는 공백을 정규화하고 최대 4,000자로 기본 설정합니다. click은 정확한 가시적 aria-label 일치를 요구하며, palette는 정확한 명령 하나를 선택합니다. wait-control은 요청된 정확한 개수가 렌더링될 때까지 폴링(polling)을 수행합니다. 이러한 작업에는 Node.js 22 이상이 필요합니다. 다른 VS Code 실행 파일을 선택하려면 VSCODE_TEST_CODE_BIN 또는 launch --code를 사용하세요. activate

이는 관리되는 실행 상태를 요구하며 기록된 프로세스 ID에 초점을 맞추어 동일한 애플리케이션 번들에서 테스트 창과 일반 창을 구별합니다. Codex 샌드박스 설정은 설치 가이드에 문서화되어 있습니다.

RepoLink는 프로젝트 전반에 걸쳐 관련 리포지토리와 유용한 명령어를 발견하기 위한 머신 로컬 레지스트리입니다. 프로젝트는 필요한 명령어를 직접 문서화해야 하며, 코딩 에이전트는 repolink를 사용하여 추가적인 머신 로컬 기능과 관련 리포지토리를 발견할 수 있습니다.

repolink
repolink command html-screenshot
repolink commands
...

효율적인 발견 가이드, 레지스트리 세부 정보 및 측정된 결과를 확인하려면 다음을 참조하십시오.

기존 스크립트와 기술을 위한 사용 중단 호환성 래퍼로 repo-map 명령어는 유지됩니다. 새로운 지침은 repolink를 사용해야 합니다.

이것은 실험적인 소규모 유틸리티 모음입니다. mvn-lite는 완전한 Maven 대체품이 아니며, 이 리포지토리는 빌드 시스템, 브라우저 자동화 프레임워크, AI 에이전트 또는 태스크 러너가 아닙니다.

MIT 라이선스; LICENSE 참조.