나는 `man` 명령을 Python TUI로 교체했는데—실제로 유용하다

Source: Dev.to

어떻게 보이는가

다르게 하는 점

내가 실제로 자랑스러워하는 기능들

⚡ 빠른 승리 갤러리

man 페이지에서 가장 고통스러운 점은 유용한 예시가 항상 페이지 하단에 숨겨져 있다는 것입니다. SmartMan은 가장 흔한 사용 패턴을 페이지 최상단에 인터랙티브 카드 형태로 보여줍니다. 스크롤도, grep으로 페이지를 뒤지는 일도 없습니다.

🤖 AI 설명 (Groq 사용)

복잡한 옵션 설명을 보고도 여전히 헷갈리나요? 다음을 실행해 보세요:

smartman --explain awk

Groq API에 (서브초 응답, 무료 티어 제공) 요청을 보내 명령이 실제로 하는 일을 쉬운 영어로 요약해 줍니다 — 새벽 2시에도 공식 사양을 해독할 필요가 없습니다.

📂 대화형 사이드바

키보드 단축키로 섹션을 즉시 이동할 수 있습니다:

🎨 테마 적용

YAML 기반 테마를 사용하므로 터미널 미학에 정확히 맞출 수 있습니다:

• 기본 — 현대적인 다크 블루
• Dracula — 클래식 개발자
• Catppuccin — 파스텔 모카
• Nord — 차가운 색조 서리
• Monokai — 고대비 활기

예시:

smartman --theme dracula grep

한 줄로 설치하기

curl -sSL https://raw.githubusercontent.com/ambaskaryash/smartman-cli/main/install.sh | bash

또는 pipx를 선호한다면:

pipx install smartman

그 다음, 영구적인 기본 man 명령어로 만들려면 .bashrc 혹은 .zshrc에 다음을 추가하세요:

alias man='smartman'

이제 man 을 입력할 때마다 자동으로 전체 SmartMan 경험을 얻을 수 있습니다.

사용 스택

• Textual — 인터랙티브 UI를 가능하게 하는 TUI 프레임워크.
• Rich — 구문 강조와 스타일링된 렌더링을 담당.
• Groq API — AI 설명을 제공; 거의 지연이 없다는 점이 선택 이유.
• Typer — 보일러플레이트 없이 깔끔한 CLI 인터페이스 제공.

앞으로 할 일

• 모든 설치된 man 페이지에 대한 퍼지 검색
• 자주 사용하는 man 페이지 북마크 기능
• --tldr 모드 (짧고 커뮤니티가 만든 요약)
• PDF로 내보내기

사용해 보기

전체 소스 코드는 GitHub에 있습니다:

👉 github.com/ambaskaryash/smartman-cli

이 도구가 man 페이지를 읽는 데 몇 초라도 절약해 준다면, 저장소에 ⭐ 하나만 눌러 주세요 — 다른 Linux 사용자들이 발견하는 데 큰 도움이 됩니다. 새로운 테마는 언제든 환영합니다. 테마 하나를 추가하려면 smartman/themes/에 YAML 파일을 넣기만 하면 됩니다.

기본 man 명령어에서 가장 짜증나는 점은 무엇인가요? 댓글에 남겨 주세요 — 다음에 만들 기능을 고르는 데 적극 활용하고 있습니다.