Windows 10/11
64비트 설치 프로그램과 포터블 빌드
TechRetriever는 Bash 스크립트를 작성하고, 내가 소유한 시스템에서 WSL이나 SSH로 실행하며, 모든 결과를 열어 볼 수 있는 카드로 보여 주는 Windows 10/11용 에이전트예요. 버전 2.9.30이에요.
scripts파일 2개scripts/disk-warn.sh저장됨bash -n scripts/disk-warn.shexit 0scripts/disk-warn.shdiff 표시됨bash scripts/disk-warn.sh 20exit 064비트 설치 프로그램과 포터블 빌드
2026년 11월 8일 출시
내가 소유한 Linux 시스템에서 실행
무언가를 바꾸는 작업 전에 멈춰요
하나를 고른 뒤 Test 버튼을 눌러요
앱을 실행할 때
bash scripting은 보통 .sh로 끝나는 일반 텍스트 파일에 셸 명령을 적어 두고 Bash가 순서대로 실행하게 하는 작업이에요. 작게 시작하세요. 첫 줄에는 #!/usr/bin/env bash 같은 shebang을 넣고, 나머지는 변수, 조건문, 반복문, 함수로 채우며, 모든 명령은 종료 코드를 돌려주고 0이면 성공을 뜻해요. TechRetriever는 이런 파일을 작성하고 실행하는 동안 여러분이 각 단계를 읽을 수 있게 해 줘요.
Bash 셸 스크립팅은 자동 백업에서 시작하는 경우가 많으니, 폴더 하나를 날짜가 붙은 tar 파일로 복사하는 스크립트를 에이전트에게 요청해 보세요. 에이전트는 write_file로 backup-notes.sh를 저장하고, Shell이 bash -n으로 스크립트를 실행하지 않은 채 문법만 검사해요. 아직 아무것도 복사되지 않아요. Ask first 모드에서는 무언가를 바꾸는 작업 전에 에이전트가 멈추고, 카드에는 실제 명령과 실제 종료 코드가 표시되며 0이면 성공이에요. 처음 실제로 실행하기 전에 폴더를 직접 백업하고, 먼저 tar 명령을 echo로 출력해 모의 실행을 해 보세요.
list_dir notes → 3 entries
write_file backup-notes.sh → saved
Shell bash -n backup-notes.sh → exit 0
Shell bash backup-notes.sh → waiting for your OK오래된 스크립트를 열고 한 줄씩 무슨 일을 하는지 물어보세요. read_file이 파일을 불러오고, grep이 변수 하나를 설정하거나 쓰는 모든 줄을 나열하며, 에이전트가 1번째 줄의 shebang, 따옴표 처리, 종료 코드를 쉬운 말로 설명해요. 따옴표 없는 변수도 짚어 줘요. 설명마다 반복문이나 조건문처럼 찾아낸 개념의 이름을 알려 주니, 읽으면서 용어도 자연스럽게 익힐 수 있어요. 내장 명령이 헷갈리면 http_get이 공식 매뉴얼 페이지를 읽어 와서 그 내용을 근거로 답해요. 설명만 듣고 싶다면 Plan only로 바꾸세요.
read_file old-cleanup.sh → 24 lines
grep "$dir" old-cleanup.sh → 5 matches
http_get manual page for a builtin → read내 시스템의 로그를 작업 폴더로 복사한 뒤 timeout 같은 단어가 들어 있는 줄을 물어보세요. grep이 일치하는 줄을 돌려주고, 맥락이 필요하면 read_file이 파일 전체를 열어요. 에이전트는 Bash에서 문자열을 파싱하는 일도 도와줘요. 로그 한 줄을 붙여 넣고, 필드로 나눠 echo로 하나씩 출력하는 반복문을 요청해 보세요. write_file이 그 반복문을 parse-log.sh로 저장하고, 이후의 모든 변경은 edit_file이 diff로 보여 줘요. 반드시 복사본으로만 작업하세요.
Bash 코딩은 대개 이런 일이에요. 여러 번 직접 입력하던 명령이 $1과 $2에서 입력을 읽는 파일로 바뀌는 거죠. 계속 다시 치던 명령을 붙여 넣고, 사용법 메시지와 두 인자가 모두 있는지 확인하는 검사를 요청하세요. write_file이 스크립트를 저장하고, Shell이 실행 전 모든 명령을 출력하는 bash -x로 돌려요. 추적 결과를 읽어 보세요. 이상한 부분은 edit_file로 고치고, 무언가를 바꾸는 단계를 승인하거나 스크립트를 다시 쓰기 전에 추적 결과를 예상과 비교하세요.
조언만으로는 부족해요. TechRetriever 2.9.30은 한 걸음 더 나아가 Shell 명령을 직접 실행하고 실제 종료 코드를 보여 주니, 추측하지 않고 결과를 판단할 수 있어요.
| 일반적인 채팅형 어시스턴트 | TechRetriever | |
|---|---|---|
| 실행 | 스크립트를 복사해서 직접 실행해야 해요 | Shell이 실행하고 실제 종료 코드를 보여 줘요 |
| 수정 | 새 스크립트 전체를 채팅에 붙여 넣어요 | edit_file이 파일을 고치고 diff를 보여 줘요 |
| 제어 | 아무것도 실행하지 않으니 승인할 것도 없어요 | Ask first가 무언가를 바꾸는 작업 전에 멈춰요 |
| 맥락 | 붙여 넣은 내용만 볼 수 있어요 | read_file과 grep이 스크립트와 로그를 읽어요 |
스크립트를 한 번도 써 본 적 없는 입문자가 가장 먼저예요. Windows에서 Bash를 배우기 시작해 각 줄이 어떻게 동작하는지 보고 싶은 분도 여기에 들어가요. 아주 작게 시작하세요. WSL에서 스크립트를 하나 쓰고, 한 줄씩 읽어 보고, 무언가를 실행하기 전에 에이전트에게 모든 부분을 설명해 달라고 하세요.
자기 Linux 머신을 몇 대 가진 실무자는 반복되는 잡일에 써요. 홈 서버나 테스트 랩을 위한 Bash 프로그래밍이라면 로그 검색, 디스크 점검, 날짜가 붙은 백업, 내 서버 목록을 도는 반복문 같은 일이에요. 작업마다 인자를 받는 스크립트가 되고요. diff는 직접 검토하세요.
SSH로 Linux 시스템을 관리하는 Windows 사용자가 세 번째 그룹이에요. 이 도구는 내가 소유하거나 관리하는 서버에만 쓰도록 만들어졌어요. 스크립트는 Linux 쪽에서 실행되고, TechRetriever는 Windows 10 또는 11에 머물러요. Ask first 모드에서는 무언가를 바꾸는 작업 전에 에이전트가 멈추고, Plan only는 아무것도 실행하지 않아요. 대상마다 꼭 확인하세요.
bash scripting은 보통 .sh로 끝나는 일반 텍스트 파일에 셸 명령을 담아 Bash가 순서대로 실행하게 하는 방식이에요. shebang 줄부터 시작하세요. 변수, 조건문, 반복문, 함수를 더하고, 각 명령의 종료 코드를 확인하면 돼요. 0이면 성공이에요.
네. techretriever.com은 TechRetriever의 공식 웹사이트이고, 여기서 연결되는 설치 프로그램은 원본 빌드예요. 설치 프로그램에 아직 코드 서명이 없으니 SHA-256 체크섬을 공개된 매니페스트와 비교하세요. 궁금한 점은 앱 안의 Send feedback 버튼으로 보내 주세요.
스크립트는 내 PC의 WSL에서, 또는 SSH로 접속하는 내가 소유한 Linux 시스템에서 실행돼요. TechRetriever 자체는 Windows 10 또는 11에서 동작해요. 범위를 좁게 유지하세요. 내가 소유했거나 관리 권한이 있는 머신에서만 쓰도록 만든 도구이고, 이를 대신 확인해 주지는 않아요.
네. 가장 확실한 방법은 Plan only예요. 계획만 작성하고 명령 실행도 파일 변경도 전혀 하지 않아요. Ask first는 무언가를 바꾸는 작업 전에 멈추지만, 읽기 전용 명령은 멈추지 않고 실행될 수 있어요. Auto-run은 바로 실행하니, 이미 검토를 마친 작업에만 쓰세요.
네, 그 서버를 관리할 권한이 있다면요. 먼저 테스트하세요. 내 머신이나 테스트 서버에서 스크립트를 실행해 보고, 파일을 바꾸거나 지우는 스크립트 전에는 백업을 해 두고, 승인하기 전에 모든 명령을 읽어 보세요.
클라우드 모델은 에이전트가 읽은 파일의 텍스트를 포함한 프롬프트 텍스트를 받으므로, 그 제공업체가 내 스크립트를 보게 돼요. 로컬 모델이면 달라요. 로컬 모델을 쓰면 아무것도 PC를 떠나지 않고, 어느 쪽이든 채팅, 작업 폴더, API 키는 PC에 남아요.
아니요. diff를 읽고, bash -n으로 문법을 검사하고, 실제 데이터를 건드리기 전에 내가 소유한 머신에서 스크립트를 테스트해야 해요. 에이전트는 초안을 쓰고 Shell 카드는 실제 종료 코드를 보여 주지만, 스크립트가 맞는지는 여러분의 검토만이 결정해요.
설치 크기는 약 34 MB예요. Windows 10 또는 11에 설치하고, 스크립트가 든 폴더를 열고, Plan only로 시작하세요. 에이전트가 무언가를 실행하길 원할 때 Ask first로 바꾸면 돼요.
Windows용 TechRetriever 다운로드 ↗모든 페이지를 20개 언어로 볼 수 있어요.
에이전트가 스크립트로 할 수 있는 일 ↗ 클라우드, 로컬, 내장 모델 ↗ 단계별 스크립트 가이드 ↗ 다운로드와 체크섬 확인 절차 ↗ 질문과 답변 ↗ 개인정보와 데이터 처리 ↗