cli-anything-mermaid은(는) 무엇을 하나요?
Mermaid 다이어그램을 상태 저장 프로젝트 파일과 mermaid.ink 렌더러를 통해 생성, 편집 및 렌더링합니다. GUI 없이 플로차트, 시퀀스 다이어그램 및 기타 시각화를 생성해야 하는 AI 에이전트 및 파워 유저를 위해 설계되었습니다.
설치
이 CLI는 cli-anything-mermaid 패키지의 일부로 설치됩니다:
pip install cli-anything-mermaid
전제 조건:
- Python 3.10+
- 외부 소프트웨어 필요 없음 (렌더링은 mermaid.ink 클라우드 서비스를 사용)
사용법
기본 명령어
# 도움말 보기
cli-anything-mermaid --help
# 대화형 REPL 모드 시작
cli-anything-mermaid
# 새 프로젝트 생성
cli-anything-mermaid project new -o diagram.json
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-mermaid --json project info
REPL 모드
하위 명령어 없이 호출되면 CLI가 대화형 REPL 세션을 시작합니다:
cli-anything-mermaid
# 탭 완성 및 기록과 함께 명령어를 대화형으로 입력
명령어 그룹
프로젝트
프로젝트 라이프사이클 명령어입니다.
| 명령어 | 설명 |
|---|---|
new | 선택적 샘플 프리셋 및 테마와 함께 새 Mermaid 프로젝트 생성 |
open | 기존 Mermaid 프로젝트 파일 열기 |
save | 현재 프로젝트를 파일에 저장 |
info | 현재 프로젝트 정보 표시 |
samples | 사용 가능한 샘플 다이어그램 프리셋 나열 |
다이어그램
다이어그램 소스 조작 명령어입니다.
| 명령어 | 설명 |
|---|---|
set | Mermaid 소스 텍스트를 인라인 또는 파일에서 교체 |
show | 현재 Mermaid 소스 코드 출력 |
내보내기
렌더링 및 공유 명령어입니다.
| 명령어 | 설명 |
|---|---|
render | mermaid.ink를 통해 SVG 또는 PNG로 다이어그램 렌더링 |
share | 공유를 위한 Mermaid Live Editor URL 생성 |
세션
세션 상태 명령어입니다.
| 명령어 | 설명 |
|---|---|
status | 현재 세션 상태 표시 |
undo | 마지막 다이어그램 소스 변경 실행 취소 |
redo | 마지막 취소된 변경 다시 실행 |
예제
플로차트 생성 및 렌더링
# 플로차트 샘플로 프로젝트 생성
cli-anything-mermaid project new --sample flowchart -o flow.json
# 다이어그램 소스 교체
cli-anything-mermaid --project flow.json diagram set --text "graph TD; A-->B; B-->C;"
# SVG로 렌더링
cli-anything-mermaid --project flow.json export render output.svg --format svg
시퀀스 다이어그램 생성
# 시퀀스 샘플로 프로젝트 생성
cli-anything-mermaid project new --sample sequence -o seq.json
# 파일에서 다이어그램 설정
cli-anything-mermaid --project seq.json diagram set --file my_diagram.mmd
# PNG로 렌더링
cli-anything-mermaid --project seq.json export render output.png --format png
다이어그램 공유
# 편집 가능한 Mermaid Live URL 생성
cli-anything-mermaid --project flow.json export share --mode edit
# 보기 전용 URL 생성
cli-anything-mermaid --project flow.json export share --mode view
대화형 REPL 세션
cli-anything-mermaid
# new flowchart
# set graph TD; A-->B; B-->C;
# render output.svg
# share
# quit
상태 관리
CLI는 다음을 통해 세션 상태를 유지합니다:
- 실행 취소/다시 실행: 다이어그램 소스 변경 되돌리기 또는 재생
- 프로젝트 영속성: 프로젝트 상태를 JSON으로 저장/로드
- 세션 추적: 수정 및 변경 사항 추적
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽을 수 있음 (기본값): 표, 색상, 형식화된 텍스트
- 기계가 읽을 수 있음 (
--json플래그): 에이전트 소비를 위한 구조화된 JSON
# 사람 출력
cli-anything-mermaid project info
# 에이전트용 JSON 출력
cli-anything-mermaid --json project info
AI 에이전트용
CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그를 사용하여 구문 분석 가능한 출력 확보 - 반환 코드 확인 - 0은 성공, 0이 아니면 오류
- 실패 시 오류 메시지를 위해 stderr 구문 분석
- 모든 파일 작업에 절대 경로 사용
- 렌더링 작업 후 출력이 존재하는지 확인
추가 정보
- 전체 문서: 패키지 내 README.md 참조
- 테스트 범위: 패키지 내 TEST.md 참조
- 방법론: cli-anything-plugin 내 HARNESS.md 참조
버전
1.0.0