AnswerDotAI/shell_sage

어떤 프로젝트인가요?

핵심 기능

• 01tmux pane 기록을 읽어 최근 명령어와 오류에 대한 맥락 있는 답변을 제공합니다.
• 02명령어 출력이나 파일 내용을 파이프로 전달해 분석할 수 있습니다.
• 03Claude, GPT, Gemini, OpenAI 호환 API 등 여러 LLM 제공자를 지원합니다.
• 04명령어 실행을 위한 allow-list 안전 계층을 갖춘 bash 도구를 선택적으로 사용할 수 있습니다.
• 05사용자 허가를 받아 파일을 열람하고 검색하거나 수정할 수 있습니다.
• 06대화 내용을 SQLite에 기록하고 제안된 코드 블록을 프롬프트에 삽입할 수 있습니다.

활용 사례

• 터미널 기록을 맥락으로 활용해 셸 명령어나 find 표현식이 실패한 원인을 파악합니다.
• journalctl 또는 다른 명령어의 출력을 도구에 파이프로 전달해 오류 로그를 설명받습니다.
• 터미널에서 익숙하지 않은 명령어와 플래그, git 워크플로를 익힙니다.
• 터미널을 벗어나지 않고 어시스턴트에게 파일을 살펴보거나 안전한 명령어를 실행하도록 요청합니다.

빠른 시작

1. 1

   pip으로 PyPI에서 ShellSage를 설치합니다

   pip install shell-sage
2. 2

   LLM API 키를 설정합니다(기본값은 Claude)

   export ANTHROPIC_API_KEY=sk...
3. 3

   테스트 인사말을 실행해 설정이 제대로 작동하는지 확인합니다

   ssage hi

사용 전 알아둘 점

• !Anthropic 또는 OpenAI와 같은 유료 LLM 제공업체의 API 키가 필요합니다.
• !tmux 안에서 사용할 때 가장 잘 작동하며, 전체 터미널 컨텍스트를 사용할 수 있는지는 tmux 설정에 따라 달라집니다.
• !README 배지에는 MIT로 표시되어 있지만 저장소 메타데이터에는 Apache-2.0으로 표시되어 있으므로 LICENSE 파일을 확인하세요.

포함된 컬렉션

토픽

자주 묻는 질문

shell_sage은(는) 무엇인가요?

tmux 터미널 기록과 파이프로 전달한 출력을 읽어 셸 명령어와 스크립트 작성을 돕는 AI CLI 어시스턴트입니다. ShellSage는 `ssage` 명령어로 실행하는 터미널용 AI 어시스턴트입니다. tmux 워크플로 안에서 현재 pane의 기록이나 여러 pane의 기록을 읽고, 실행한 명령어와 문제가 발생한 원인을 파악해 설명, 수정된 명령어, 예제를 제시합니다. 명령어 출력이나 파일 내용을 파이프로 전달해 분석을 요청할 수도 있습니다.

shell_sage은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

shell_sage은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

shell_sage은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. shell_sage의 마지막 커밋은 2026년 10월 28일입니다.

shell_sage은(는) 어디에 사용할 수 있나요?

터미널 기록을 맥락으로 활용해 셸 명령어나 find 표현식이 실패한 원인을 파악합니다. journalctl 또는 다른 명령어의 출력을 도구에 파이프로 전달해 오류 로그를 설명받습니다. 터미널에서 익숙하지 않은 명령어와 플래그, git 워크플로를 익힙니다. 터미널을 벗어나지 않고 어시스턴트에게 파일을 살펴보거나 안전한 명령어를 실행하도록 요청합니다.

shell_sage는 어떻게 설치하나요?

pip으로 PyPI에서 ShellSage를 설치합니다: pip install shell-sage LLM API 키를 설정합니다(기본값은 Claude): export ANTHROPIC_API_KEY=sk... 테스트 인사말을 실행해 설정이 제대로 작동하는지 확인합니다: ssage hi

shell_sage은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AnswerDotAI/shell_sage