Patchloom

파서 기반 편집

doc 명령을 사용하여 JSON, YAML, TOML 값을 선택자(path)로 수정하며, 주석과 포맷을 그대로 유지합니다. 예를 들어 patchloom doc set config.yaml database.port 5432 --apply 명령은 database.port 값을 5432로 변경하면서 주석과 들여쓰기를 보존합니다.

배치 및 트랜잭션 편집

batch 또는 tx 명령을 통해 여러 파일 편집을 하나의 도구 호출로 결합할 수 있습니다. 이는 AI 에이전트가 LLM과의 왕복을 줄여 효율성을 높입니다. 예를 들어 6개 파일을 동시에 수정하는 작업이 6번의 도구 호출에서 1번으로 줄어듭니다.

마크다운 편집

md 명령은 제목(heading)을 기준으로 마크다운 테이블, 섹션, 불릿을 편집하여 줄 번호를 추측할 필요가 없습니다. 예를 들어 patchloom md table-append README.md --heading "API" --row "| new | row |" --apply 명령은 API 제목 아래에 새로운 행을 추가합니다.

AST 기반 코드 작업

ast 명령은 20개 이상의 프로그래밍 언어에서 기호를 목록화, 이름 변경, 교체, 분석할 수 있습니다. 예를 들어 patchloom ast rename src/ --old old_name --new new_name --apply 명령은 소스 코드 내의 모든 old_name을 new_name으로 변경합니다.

MCP 서버 모드

patchloom mcp-server 명령을 통해 구조화된 MCP 도구 호출을 제공하여, 셸 구문 없이 AI 에이전트가 직접 도구를 사용할 수 있습니다. 이는 MCP-capable 에이전트에 적합합니다.

다운로드·설치 방법

Windows에서는 Scoop을 권장 채널로 사용합니다. 먼저 저장소를 추가하고 패키지를 설치합니다.

scoop bucket add patchloom https://github.com/patchloom/scoop-bucket
scoop install patchloom/patchloom

또는 GitHub 릴리스 페이지에서 사전 빌드된 바이너리를 다운로드하거나, winget, Chocolatey, Homebrew, crates.io, npm 등을 통해 설치할 수 있습니다. winget의 경우 Patchloom.Patchloom 패키지를 사용합니다.

기본 사용법/명령어

첫 실행 시 patchloom init 명령을 통해 프로젝트를 설정할 수 있습니다. 이 명령은 AGENTS.md 파일을 생성하거나 기존 파일에 에이전트 규칙을 추가하고, 셸 완성 스크립트를 제공하며, MCP 구성 기회를 감지합니다.

구성 파일 편집 예시:

patchloom doc set config.yaml database.port 5432 --apply

여러 파일 편집을 배치로 처리하는 예시:

patchloom batch --apply <<'EOF'
doc.set package.json version "2.0.0"
doc.set config.yaml app.version "2.0.0"
doc.set config.toml project.version "2.0.0"
replace README.md "1.0.0" "2.0.0"
replace CHANGELOG.md "1.0.0" "2.0.0"
file.create VERSION "2.0.0"
EOF

Windows PowerShell에서는 헤어독 대신 파일을 사용할 수 있습니다:

@'
doc.set config.json version ""2.0.0""
md.upsert_bullet AGENTS.md "Rules" "- Always test"
replace src/main.rs "v1" "v2"
'@ | Set-Content ops.txt -Encoding utf8
patchloom batch --apply ops.txt

이런 경우에 유용합니다

AI 에이전트가 여러 구성 파일을 동시에 수정해야 할 때, Patchloom의 배치 기능을 사용하면 각 파일을 개별로 편집하는 것보다 훨씬 빠르게 작업을 완료할 수 있습니다. 예를 들어 애플리케이션 버전을 올릴 때 package.json, config.yaml, config.toml, README.md, CHANGELOG.md, VERSION 파일을 동시에 수정해야 하는 경우, 하나의 batch 명령으로 모든 변경을 적용할 수 있습니다.

YAML 또는 TOML 파일의 주석을 보존하면서 값을 수정해야 할 때도 유용합니다. 일반 텍스트 대체 도구는 주석을 잃거나 들여쓰기를 깨뜨릴 수 있지만, Patchloom은 파서를 통해 값을 안전하게 변경하여 주석과 포맷을 그대로 유지합니다.

지원 환경·시스템 요구사항

Patchloom은 Linux, macOS, Windows에서 동일하게 실행됩니다. 별도의 의존성이 없으며, 단일 바이너리로 제공됩니다. Windows에서는 PowerShell 또는 명령 프롬프트에서 사용할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.33.0입니다. 최신 릴리스 정보는 GitHub 저장소의 Releases 페이지에서 확인할 수 있습니다.

제한 사항·확인 사항

Patchloom은 단일 파일 간단한 텍스트 대체 작업에서는 네이티브 도구(grep, sed 등)가 더 빠를 수 있습니다. 구조화된 파일(JSON, YAML, TOML) 편집에서는 Patchloom을 사용하는 것이 안전하며, 간단한 텍스트 작업에서는 네이티브 도구를 사용하는 것이 성능 면에서 더 효율적일 수 있습니다.

FAQ

• Patchloom은 무료로 사용할 수 있나요?
  네, Patchloom은 MIT 라이선스 또는 Apache License 2.0 중 선택하여 사용할 수 있는 오픈소스 소프트웨어입니다.
• Windows에서 정상적으로 동작하나요?
  네, Patchloom은 Linux, macOS, Windows에서 동일한 바이너리로 동작하며, Windows에서도 별도의 의존성 없이 실행할 수 있습니다.
• AI 에이전트 없이도 사용할 수 있나요?
  네, Patchloom은 일반 터미널에서 CLI로 사용할 수 있으며, AI 에이전트를 위한 도구이지만 스크립트나 수동 작업에서도 유용합니다.