TechRetriever
TechRetriever 공식 웹사이트

bash scripting, Linux와 WSL에서 한 단계씩 검토해요

TechRetriever는 Bash 스크립트를 작성하고, 내가 소유한 시스템에서 WSL이나 SSH로 실행하며, 모든 결과를 열어 볼 수 있는 카드로 보여 주는 Windows 10/11용 에이전트예요. 버전 2.9.30이에요.

플랫폼

Windows 10/11

64비트 설치 프로그램과 포터블 빌드

버전

2.9.30

2026년 11월 8일 출시

스크립트

WSL 또는 SSH

내가 소유한 Linux 시스템에서 실행

승인

Ask first

무언가를 바꾸는 작업 전에 멈춰요

모델

클라우드, 로컬, 내장

하나를 고른 뒤 Test 버튼을 눌러요

계정

필요 없음

앱을 실행할 때

기본 개념

내 컴퓨터에서 하는 bash scripting, 쉽게 설명해요

bash scripting은 보통 .sh로 끝나는 일반 텍스트 파일에 셸 명령을 적어 두고 Bash가 순서대로 실행하게 하는 작업이에요. 작게 시작하세요. 첫 줄에는 #!/usr/bin/env bash 같은 shebang을 넣고, 나머지는 변수, 조건문, 반복문, 함수로 채우며, 모든 명령은 종료 코드를 돌려주고 0이면 성공을 뜻해요. TechRetriever는 이런 파일을 작성하고 실행하는 동안 여러분이 각 단계를 읽을 수 있게 해 줘요.

01

날짜가 붙은 tar 파일로 폴더 백업하기

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
02

이미 가진 스크립트로 bash 배우기

오래된 스크립트를 열고 한 줄씩 무슨 일을 하는지 물어보세요. 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
03

로그에서 단어 하나 검색하기

내 시스템의 로그를 작업 폴더로 복사한 뒤 timeout 같은 단어가 들어 있는 줄을 물어보세요. grep이 일치하는 줄을 돌려주고, 맥락이 필요하면 read_file이 파일 전체를 열어요. 에이전트는 Bash에서 문자열을 파싱하는 일도 도와줘요. 로그 한 줄을 붙여 넣고, 필드로 나눠 echo로 하나씩 출력하는 반복문을 요청해 보세요. write_file이 그 반복문을 parse-log.sh로 저장하고, 이후의 모든 변경은 edit_file이 diff로 보여 줘요. 반드시 복사본으로만 작업하세요.

04

직접 입력하던 명령을 인자를 받는 스크립트로 바꾸기

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이 스크립트와 로그를 읽어요

사용 방법

  1. Windows 10 또는 11에 TechRetriever를 설치하되, 먼저 SHA-256 체크섬을 공개된 매니페스트와 비교하세요.
  2. 모델을 연결하세요. 클라우드 AI 제공업체, 내 PC에서 실행되는 모델, 내장 모델 중에서 고를 수 있어요.
  3. 프로젝트 폴더와 모드를 고르세요. Auto-run, Ask first, Plan only가 있어요.
  4. 필요한 스크립트를 설명하고, 각 작업 카드를 읽은 뒤, 요청과 일치할 때만 diff를 수락하세요.

이런 분께 알맞아요

스크립트를 한 번도 써 본 적 없는 입문자가 가장 먼저예요. Windows에서 Bash를 배우기 시작해 각 줄이 어떻게 동작하는지 보고 싶은 분도 여기에 들어가요. 아주 작게 시작하세요. WSL에서 스크립트를 하나 쓰고, 한 줄씩 읽어 보고, 무언가를 실행하기 전에 에이전트에게 모든 부분을 설명해 달라고 하세요.

자기 Linux 머신을 몇 대 가진 실무자는 반복되는 잡일에 써요. 홈 서버나 테스트 랩을 위한 Bash 프로그래밍이라면 로그 검색, 디스크 점검, 날짜가 붙은 백업, 내 서버 목록을 도는 반복문 같은 일이에요. 작업마다 인자를 받는 스크립트가 되고요. diff는 직접 검토하세요.

SSH로 Linux 시스템을 관리하는 Windows 사용자가 세 번째 그룹이에요. 이 도구는 내가 소유하거나 관리하는 서버에만 쓰도록 만들어졌어요. 스크립트는 Linux 쪽에서 실행되고, TechRetriever는 Windows 10 또는 11에 머물러요. Ask first 모드에서는 무언가를 바꾸는 작업 전에 에이전트가 멈추고, Plan only는 아무것도 실행하지 않아요. 대상마다 꼭 확인하세요.

자주 묻는 질문

bash scripting이 뭐예요?

bash scripting은 보통 .sh로 끝나는 일반 텍스트 파일에 셸 명령을 담아 Bash가 순서대로 실행하게 하는 방식이에요. shebang 줄부터 시작하세요. 변수, 조건문, 반복문, 함수를 더하고, 각 명령의 종료 코드를 확인하면 돼요. 0이면 성공이에요.

techretriever.com이 TechRetriever 공식 사이트 맞나요?

네. techretriever.com은 TechRetriever의 공식 웹사이트이고, 여기서 연결되는 설치 프로그램은 원본 빌드예요. 설치 프로그램에 아직 코드 서명이 없으니 SHA-256 체크섬을 공개된 매니페스트와 비교하세요. 궁금한 점은 앱 안의 Send feedback 버튼으로 보내 주세요.

Bash 스크립트는 실제로 어디서 실행되나요?

스크립트는 내 PC의 WSL에서, 또는 SSH로 접속하는 내가 소유한 Linux 시스템에서 실행돼요. TechRetriever 자체는 Windows 10 또는 11에서 동작해요. 범위를 좁게 유지하세요. 내가 소유했거나 관리 권한이 있는 머신에서만 쓰도록 만든 도구이고, 이를 대신 확인해 주지는 않아요.

스크립트를 읽어 보기 전에 에이전트가 실행하지 못하게 할 수 있나요?

네. 가장 확실한 방법은 Plan only예요. 계획만 작성하고 명령 실행도 파일 변경도 전혀 하지 않아요. Ask first는 무언가를 바꾸는 작업 전에 멈추지만, 읽기 전용 명령은 멈추지 않고 실행될 수 있어요. Auto-run은 바로 실행하니, 이미 검토를 마친 작업에만 쓰세요.

회사 서버에서 Bash 프로그래밍에 써도 되나요?

네, 그 서버를 관리할 권한이 있다면요. 먼저 테스트하세요. 내 머신이나 테스트 서버에서 스크립트를 실행해 보고, 파일을 바꾸거나 지우는 스크립트 전에는 백업을 해 두고, 승인하기 전에 모든 명령을 읽어 보세요.

내 스크립트와 프롬프트가 PC 밖으로 나가나요?

클라우드 모델은 에이전트가 읽은 파일의 텍스트를 포함한 프롬프트 텍스트를 받으므로, 그 제공업체가 내 스크립트를 보게 돼요. 로컬 모델이면 달라요. 로컬 모델을 쓰면 아무것도 PC를 떠나지 않고, 어느 쪽이든 채팅, 작업 폴더, API 키는 PC에 남아요.

에이전트가 스크립트가 맞다고 보장해 주나요?

아니요. diff를 읽고, bash -n으로 문법을 검사하고, 실제 데이터를 건드리기 전에 내가 소유한 머신에서 스크립트를 테스트해야 해요. 에이전트는 초안을 쓰고 Shell 카드는 실제 종료 코드를 보여 주지만, 스크립트가 맞는지는 여러분의 검토만이 결정해요.

시작하기

테스트 머신에서 스크립트 하나를 써 보세요

설치 크기는 약 34 MB예요. Windows 10 또는 11에 설치하고, 스크립트가 든 폴더를 열고, Plan only로 시작하세요. 에이전트가 무언가를 실행하길 원할 때 Ask first로 바꾸면 돼요.

Windows용 TechRetriever 다운로드 ↗

TechRetriever 둘러보기

모든 페이지를 20개 언어로 볼 수 있어요.

에이전트가 스크립트로 할 수 있는 일 ↗ 클라우드, 로컬, 내장 모델 ↗ 단계별 스크립트 가이드 ↗ 다운로드와 체크섬 확인 절차 ↗ 질문과 답변 ↗ 개인정보와 데이터 처리 ↗