DevMate

프로젝트 분석 (analyze)

프로젝트 디렉터리나 단일 소스 파일을 분석하여 언어, 프레임워크, 도구를 감지하고, 파일 수, 줄 수, 주석 수, 종속성 요약, TODO/FIXME 마커, 중복 자산, 큰 파일 등을 보고합니다. 상세 모드에서는 아키텍처 그래프, 순환 종속성, 중복 코드, Git 인텔리전스(브랜치, 커밋, 기여자 등)를 추가로 제공합니다.

JSON 도구 (json)

JSON 파일의 유효성 검사, 포맷팅, 축소, 두 파일 간의 차이 비교를 지원합니다.

환경 변수 검사 (env)

.env 파일을 검사하여 중복, 빈 값, 잘못된 형식, 소스 코드에서 참조하는 변수 누락 등을 찾아내고, .env.example과의 차이를 비교합니다.

Git 요약 (git)

현재 저장소의 브랜치 상태, 커밋, 기여자, 수정된 파일 등을 요약합니다.

JWT 도우미 (jwt)

HMAC JWT를 생성, 디코드, 검증할 수 있습니다. HS256, HS384, HS512 알고리즘을 지원합니다.

시스템 상태 (system)

CPU, RAM, 디스크, 네트워크, 배터리, GPU 등의 시스템 정보를 일회성 또는 실시간 대시보드(–watch)로 표시합니다.

파일 감사 (files)

파일 검색, 트리 보기, 통계, 중복 파일 찾기를 지원하며, .gitignore 규칙을 존중하고 .git, node_modules, target과 같은 무거운 폴더는 건너뜁니다.

Doctor 검사 (doctor)

프로젝트에 필요한 개발 도구(Git, 편집기 등)가 설치되어 있는지 확인하고, 필수/권장/선택으로 분류하여 알려줍니다.

안전한 프로세스 정리 (kill)

리소스를 많이 사용하는 프로세스를 미리 보여주고, 사용자 확인 후 종료합니다. 시스템 프로세스나 현재 DevMate 프로세스는 보호합니다.

Windows

winget을 통해 설치할 수 있습니다: winget install ADELA.Devmate. 또는 GitHub Releases에서 zip 파일을 다운로드하여 압축을 풀고, devmate.exe setup을 실행합니다. 이후 PATH에 폴더를 추가하면 어디서든 devmate 명령을 사용할 수 있습니다.

Linux 및 macOS

GitHub Releases에서 tar.gz 파일을 다운로드하여 압축을 풀고, devmate setup을 실행합니다. 사용자 설치를 원하면 ~/.local/bin에 복사하고 PATH에 추가합니다. macOS에서 다운로드한 파일이 차단된 경우, 시스템 설정에서 허용하거나 xattr -d com.apple.quarantine 명령으로 해제할 수 있습니다.

Rust 사용자

Rust가 설치되어 있다면 cargo install devmate --force로 설치할 수 있습니다.

기본 사용법

설치 후 devmate setup을 실행하면 현재 프로젝트에 대한 온보딩이 시작됩니다. 이후 devmate doctor, devmate analyze, devmate system 등을 실행할 수 있습니다. 대부분의 진단 명령은 --json 옵션을 지원하여 스크립트에서 활용할 수 있습니다.

활용 예시

• 프로젝트 상태 점검: devmate analyze로 코드 품질, 종속성, 잠재적 문제를 파악합니다.
• 환경 변수 누락 확인: devmate env inspect --example .env.example로 .env 파일과 예제 파일의 차이를 확인합니다.
• JWT 디버깅: devmate jwt decode <token>으로 토큰을 검사하고, devmate jwt verify <token> --secret <secret>으로 서명을 검증합니다.
• 시스템 모니터링: devmate system --watch로 실시간 시스템 상태를 확인합니다.
• 중복 파일 찾기: devmate files dupes로 프로젝트 내 중복 파일을 찾습니다.

업데이트 및 제거

devmate update 명령으로 설치 방법에 맞게 업데이트할 수 있습니다. devmate uninstall 명령으로 제거할 수 있으며, 수동 설치의 경우 실행 파일 삭제를 예약하고 PATH에서 폴더를 제거하라는 안내를 받습니다.

제한 사항 및 라이선스

DevMate는 CLI 전용 도구로 그래픽 인터페이스가 없으며, 터미널 사용에 익숙한 사용자를 대상으로 합니다. 이 소프트웨어는 MIT 라이선스로 배포됩니다.