TL;DR

  • Cmdxray가 셸 명령을 파이프라인 구조와 플래그 단위로 분석해 위험한 부분을 표시하며, 웹페이지와 CLI 모두 로컬 실행 조건에서 명령이 기기를 벗어나지 않음.
  • 브라우저에서는 파서와 렌더러가 전부 페이지 안에서 실행되고, 터미널의 npx cmdxray <command>는 로컬 매뉴얼 페이지(man page)도 읽어 실제 설치 버전에 맞는 설명을 제공함.
  • 파이프, &&, 리디렉션, 서브셸, 결합형 짧은 플래그, 하위 명령어와 플래그 값을 포함한 명령 구조를 실제로 파싱함.
  • 분석 결과를 자체 설명이 포함된 공유용 SVG/HTML 카드로 출력하거나, 명령이 이미 분해된 페이지를 여는 공유 링크로 전달할 수 있음.
  • npx로 설치 없이 실행하거나 npm i -g cmdxray로 전역 설치할 수 있으며, 일반 명령어의 플래그와 실제 예시를 설명하는 오프라인 친화적 명령어 레퍼런스도 제공함.

직접 사용해 보기

  • 웹페이지에 명령어를 입력하면 입력한 내용이 어디에도 전송되지 않으며, 파서와 렌더러가 페이지 안에서 전부 실행됨.
  • 터미널에서 npx cmdxray <command>를 실행하면 같은 분석을 수행하고 로컬 매뉴얼 페이지도 읽음.
  • 분석 결과를 SVG 카드 또는 HTML 카드로 내려받고, CLI 명령과 공유 가능한 링크를 복사하는 기능이 제공됨.

오프라인 및 비공개

  • explainshell.com과 달리 cmdxray가 로컬에서 실행됨.
  • 호스트 이름, 토큰, 경로를 포함하는 경우가 많은 명령어가 기기 밖으로 전송되지 않음.

실제 셸 파서

  • 파이프, &&, 리디렉션, 서브셸, -xzvf 같은 결합형 짧은 플래그, 하위 명령어와 플래그 값을 포함한 파이프라인 구조를 파싱함.

설치된 도구에 맞는 정확성

  • 사전 큐레이션되지 않은 명령어의 경우 CLI가 사용자의 기기에 있는 매뉴얼 페이지에서 요약을 읽음.
  • 설치된 도구의 실제 버전에 맞춰 설명이 제공됨.

공유 가능한 카드

  • 자체 설명이 포함된 독립형 SVG/HTML 카드를 생성함.
  • 생성된 카드는 풀 리퀘스트(PR) 댓글, 런북(runbook), 수업, 슬라이드 또는 'TIL' 게시물에 활용할 수 있음.
  • 각 카드가 자체적으로 설명을 포함함.

공유 가능한 링크

  • 공유 가능한 링크 복사 기능으로 URL을 전달하면 명령어가 이미 분석된 상태로 페이지가 열림.
  • 수신자가 설치할 필요가 없고 명령어가 업로드되지 않음.

설치

  • 설치 없이 실행하려면 npx cmdxray "find . -mtime +30 -type f -delete"를 사용함.
  • 자주 사용할 경우 npm i -g cmdxray로 전역 설치함.
  • cmdxray -o card.svg "grep -rn TODO src | head -20"처럼 출력 옵션을 사용하면 공유 가능한 SVG 카드를 생성함.

비교

  • 오프라인 실행 및 비공개: cmdxray는 가능하고 explainshell.com은 웹 전용이며, tldr / cheat는 오프라인 실행 여부가 별도로 제시됨.
  • 입력한 정확한 명령어 파싱: cmdxray와 explainshell.com은 가능하고, tldr / cheat는 예시 명령어 기반임.
  • 로컬 매뉴얼 페이지 사용: cmdxray는 사용하고, explainshell.com은 고정된 말뭉치를 사용하며, tldr / cheat는 사용하지 않음.
  • 공유 가능한 카드 출력: cmdxray만 제공함.

명령어 레퍼런스

  • 일반적인 명령어의 기능을 평이한 영어로 설명하는 페이지를 제공함.
  • 모든 플래그와 실제 예시를 토큰 단위로 분석해 설명함.
  • tar -xzvf의 기능처럼 특정 명령어의 동작을 검색할 때 유용하며, 정확하고 오프라인 친화적인 답변을 제공하는 용도임.
  • 명령어 레퍼런스를 탐색하는 기능이 제공됨.