CLI 명령어 레퍼런스
모든 최상위 Multiflow CLI 명령어를 한 페이지로 정리한 개요입니다. 전체 사용법은 `multiflow <command> --help`를 실행하세요.
Multiflow CLI는 Web UI에서 할 수 있는 거의 모든 작업을 그대로 제공합니다(이슈 생성, 에이전트 할당, 데몬 시작 등). 이 페이지는 모든 최상위 명령어를 한 줄 설명과 함께 나열합니다. 전체 플래그와 예제는 multiflow <command> --help를 실행하세요.
인증하기
CLI를 처음 사용할 때 이 명령을 실행해 **개인 액세스 토큰(personal access token, PAT)**을 발급받으세요:
multiflow login브라우저가 자동으로 열립니다. 웹 앱에서 승인하면 CLI가 PAT(mul_ 접두사)를 ~/.multica/config.json에 저장합니다. 이후 모든 명령은 이 PAT로 인증됩니다.
CI나 headless 환경에서는 브라우저 플로우를 건너뛰세요. 웹 앱의 설정 → API 토큰에서 PAT를 만든 뒤 multiflow login --token <mul_...>로 직접 전달하면 됩니다.
토큰 유형 간의 차이는 인증과 토큰을 참고하세요.
인증과 설정
| 명령어 | 용도 |
|---|---|
multiflow login | 로그인하고 PAT 저장 |
multiflow auth status | 현재 로그인 상태, 사용자, 워크스페이스 표시 |
multiflow auth logout | 로컬 PAT 삭제 |
multiflow setup cloud | Multiflow Cloud용 원샷 설정(로그인 + 데몬 설치) |
multiflow setup self-host | 자체 호스팅 백엔드용 원샷 설정 |
워크스페이스와 멤버
| 명령어 | 용도 |
|---|---|
multiflow workspace list | 접근할 수 있는 모든 워크스페이스 나열 |
multiflow workspace create --name "..." --slug "..." [--issue-prefix "..."] [--description "..."] [--context "..."] | 워크스페이스 생성(생성자가 owner가 됩니다). --name과 --slug는 필수이며 slug는 생성 후 변경할 수 없습니다. 현재 워크스페이스는 전환되지 않습니다. |
multiflow workspace get <slug> | 워크스페이스 하나의 상세 정보 표시 |
multiflow workspace member list | 현재 워크스페이스의 멤버 나열 |
multiflow workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."] | 워크스페이스 메타데이터 업데이트(admin/owner). 긴 필드는 --description-stdin / --context-stdin을 사용할 수 있습니다. |
이슈와 프로젝트
list 계열 명령(multiflow issue list, autopilot list, project list 등)은 기본적으로 짧고 바로 복사해 붙여 넣을 수 있는 ID를 출력합니다. 이슈는 MUL-123 같은 이슈 키이고, 나머지 리소스는 짧은 UUID 접두사입니다. 아래 후속 명령의 <id> 인자는 짧은 ID와 전체 UUID를 모두 받으므로, 일반적인 흐름은 multiflow issue list → 키 복사 → multiflow issue get MUL-123입니다. 정식 UUID가 필요할 때는 list 명령에 --full-id를 전달하세요.
| 명령어 | 용도 |
|---|---|
multiflow issue list | 이슈 나열(복사해 붙여 넣을 수 있는 이슈 키 출력) |
multiflow issue get <id> | 단일 이슈 표시(이슈 키 또는 UUID를 받음) |
multiflow issue create --title "..." | 새 이슈 생성 |
multiflow issue update <id> ... | 이슈 업데이트(상태, 우선순위, 담당자 등) |
multiflow issue assign <id> --to <name> | 멤버, 에이전트, 또는 스쿼드에 할당(에이전트에 할당하면 실행이 트리거됨) |
multiflow issue status <id> <status> | 상태 변경 단축 명령 |
multiflow issue search <query> | 키워드 검색 |
multiflow issue children <id> | 하위 이슈를 stage별로 나열 |
multiflow issue pull-requests <id> | 연결된 pull request와 상태 나열 |
multiflow issue runs <id> | 이슈의 에이전트 실행 표시 |
multiflow issue run-messages <task-id> | 한 실행의 메시지 표시 |
multiflow issue usage <id> | 이슈의 집계 token 사용량 표시 |
multiflow issue rerun <id> | 이슈의 현재 에이전트 담당자에게 새 작업을 다시 큐에 넣기 |
multiflow issue cancel-task <task-id> | 대기 중이거나 실행 중인 작업 취소 |
multiflow issue comment <id> ... | 중첩: 댓글 보기 / 작성 |
multiflow issue comment resolve/unresolve <comment-id> | 댓글 스레드를 해결 / 미해결로 표시 |
multiflow issue subscriber <id> ... | 중첩: 구독 / 구독 취소 |
multiflow issue metadata <id> ... | 중첩: 이슈 metadata 읽기 / 쓰기 |
multiflow issue label <id> ... | 중첩: 이슈의 label 관리 |
multiflow project list/get/create/update/delete/status | 프로젝트 CRUD |
multiflow label list/create/update/delete | 워크스페이스 label CRUD |
에이전트와 스킬
| 명령어 | 용도 |
|---|---|
multiflow agent list | 워크스페이스의 에이전트 나열 |
multiflow agent get <slug> | 에이전트의 구성 표시 |
multiflow agent create ... | 에이전트 생성 |
multiflow agent update <slug> ... | 에이전트 업데이트 |
multiflow agent archive <slug> | 보관 |
multiflow agent restore <slug> | 보관된 에이전트 복원 |
multiflow agent tasks <slug> | 에이전트의 작업 기록 표시 |
multiflow agent avatar <slug> | 에이전트 아바타 업로드 |
multiflow agent env <slug> ... | 에이전트 custom environment variables 읽기 / 교체 |
multiflow agent skills ... | 중첩: 스킬 연결 / 분리 |
multiflow skill list/get/create/update/delete | 스킬 CRUD |
multiflow skill import ... | GitHub, ClawHub, 또는 로컬 기기에서 스킬 가져오기 |
multiflow skill files ... | 중첩: 스킬의 파일 관리 |
스킬 가져오기 충돌
multiflow skill import --url <url>의 기본값은 --on-conflict fail입니다. 같은 이름의 스킬이 이미 있으면 명령은 구조화된 conflict 결과로 종료되며 워크스페이스를 변경하지 않습니다.
기존 스킬을 만든 사용자이고, 스킬 ID와 에이전트 연결은 유지한 채 내용을 바꾸려면 --on-conflict overwrite를 사용하세요. 기존 스킬을 그대로 두고 복사본을 가져오려면 --on-conflict rename을 사용하면 -2 같은 접미사가 자동으로 붙습니다. 같은 이름의 항목을 그냥 건너뛰려면 --on-conflict skip을 사용하세요.
multiflow skill import --url https://skills.sh/acme/repo/review-helper
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict overwrite
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict rename
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict skip스쿼드
| 명령어 | 용도 |
|---|---|
multiflow squad list | 워크스페이스의 스쿼드 나열 |
multiflow squad get <id> | 단일 스쿼드 표시 |
multiflow squad create --name "..." --leader <agent> | 스쿼드 생성(owner / admin) |
multiflow squad update <id> ... | 이름, 설명, 지침, 리더, 또는 아바타 업데이트 |
multiflow squad delete <id> | 보관(소프트 삭제) — 할당된 이슈를 리더에게 이관 |
multiflow squad member list/add/remove/set-role <squad-id> | 스쿼드 멤버 관리 및 역할 직접 업데이트 |
multiflow squad activity <issue-id> <action|no_action|failed> --reason "..." | 스쿼드 리더 에이전트가 매 턴마다 평가를 기록할 때 사용 |
전체 모델은 스쿼드를 참고하세요.
오토파일럿
| 명령어 | 용도 |
|---|---|
multiflow autopilot list | 워크스페이스의 모든 오토파일럿 나열 |
multiflow autopilot get <id> | 단일 오토파일럿 표시 |
multiflow autopilot create ... | 오토파일럿 생성 |
multiflow autopilot update <id> ... | 업데이트 |
multiflow autopilot delete <id> | 삭제 |
multiflow autopilot runs <id> | 실행 기록 표시 |
multiflow autopilot trigger <id> | 수동으로 실행 트리거 |
multiflow autopilot trigger-add/update/delete <id> | schedule 또는 webhook trigger 관리 |
multiflow autopilot trigger-rotate-url <id> <trigger-id> | webhook trigger URL 회전 |
multiflow autopilot create/update는 create_issue 모드 autopilot이 만드는 이슈의 기본 구독자를 설정하는 --subscriber도 받습니다. update에서는 --clear-subscribers로 제거할 수 있습니다.
데몬과 런타임
| 명령어 | 용도 |
|---|---|
multiflow daemon start | 데몬 시작(기본은 백그라운드; --foreground를 추가하면 포그라운드 실행) |
multiflow daemon stop | 데몬 중지 |
multiflow daemon restart | 데몬 재시작 |
multiflow daemon status | 데몬의 온라인 여부와 동시 실행 수 확인 |
multiflow daemon logs | 데몬 로그 보기 |
multiflow runtime list | 현재 워크스페이스의 런타임 나열 |
multiflow runtime usage | 리소스 사용량 표시 |
multiflow runtime activity | 최근 활동 로그 |
multiflow runtime update <id> ... | 런타임에서 CLI 업데이트 시작 |
multiflow runtime delete <id> [--cascade] | 런타임 삭제, 필요하면 연결된 에이전트도 보관 |
multiflow runtime profile ... | 사용자 지정 runtime profile과 로컬 경로 override 관리 |
기타
| 명령어 | 용도 |
|---|---|
multiflow repo checkout <url> | 에이전트가 사용할 수 있도록 리포지토리를 로컬에 클론 |
multiflow config | 로컬 CLI 구성 보기 또는 편집 |
multiflow version | CLI 버전 출력 |
multiflow update | CLI를 최신 릴리스로 업그레이드 |
multiflow attachment download <id> | 이슈나 댓글에서 첨부 파일 다운로드 |
전체 플래그 확인하기
모든 명령은 --help를 지원합니다:
multiflow issue create --help
multiflow agent update --helpv2에서는 각 명령마다 전용 상세 레퍼런스 페이지를 제공할 예정입니다.
다음 단계
- 인증과 토큰 — PAT vs. JWT vs. 데몬 토큰
- 데몬과 런타임 —
daemon명령이 내부적으로 동작하는 방식 - 에이전트 생성과 구성 —
multiflow agent create의 모든 옵션