nora flows

flows 명령 그룹이 Flow 라이프사이클의 주요 핸들. 대부분 일상 CLI 작업이 이걸 통해 실행. nora flows use <slug> 로 활성 Flow 고정하면 모든 후속 명령이 그 Flow 기본.

명령

명령	설명
`flows list`	활성 워크스페이스의 모든 Flow 나열.
`flows get <slug>`	전체 Flow 페이로드 fetch.
`flows snapshot [slug]`	편집 가능 블록 + 엣지를 JSON 으로 인쇄.
`flows apply <slug> <file>`	JSON 파일에서 Flow 생성/upsert.
`flows delete <slug>`	Flow 삭제.
`flows use <slug>`	활성 Flow 고정.
`flows current`	활성 Flow slug 인쇄.
`flows publish [slug]`	Draft 를 라이브 버전으로 얼림.
`flows rollback <slug> <seq>`	라이브 포인터를 옛 버전으로 롤.
`flows versions list [slug]`	버전 나열.
`flows versions get <slug> <seq>`	한 버전 fetch.
`flows versions restore <slug> <seq>`	옛 버전을 Draft 에 복사.
`flows settings get [slug]`	Flow 설정 참고.
`flows settings update [slug]`	Flow 설정 참고.

`flows list`

nora flows list

활성 워크스페이스의 모든 Flow 를 slug, 이름, 마지막 배포 버전, 마지막 수정 시간과 표시. 기계 출력에 --json 추가 — Flow 당 한 줄.

`flows get`

nora flows get <slug>

전체 Flow 페이로드 인쇄: 블록, 와이어, 설정, 배포 상태, 타임스탬프. 항상 JSON. 흔한 용도:

위험 변경 전 Flow 백업: nora flows get support > support-backup.json.
특정 블록 검사: nora flows get support | jq '.blocks[] | select(.id=="ag_1")'.
두 워크스페이스 비교: diff <(nora --workspace ws1 flows get x) <(nora --workspace ws2 flows get x).

`flows snapshot`

nora flows snapshot > my-flow.json

편집 가능 페이로드 (블록과 엣지 — 설정이나 배포 상태 아님) 만 덤프. 이상적:

Nora 밖에서 Flow git 추적.
jq 나 yq 로 벌크 편집.
템플릿: 한 Flow 스냅샷, JSON 조정, 새 Flow 로 적용.

`flows apply`

nora flows apply <slug> my-flow.json

JSON 파일에서 Flow upsert. <slug> 가 없으면 생성됨. 업데이트에는 JSON 이 새 Draft 됨 — 별도 배포. 옵션 --name "..." 이 생성 시 표시 이름 설정. 전형 config-as-code 워크플로우:

# git 의 정본
nora flows snapshot support > flows/support.json
git add flows/support.json && git commit -m "sync support flow"

# main 머지 시 CI 에서
nora flows apply support flows/support.json
nora flows publish support --note "$(git log -1 --pretty=%s)"

`flows delete`

nora flows delete <slug>

Flow 삭제. 배포된 버전이 ID 로 유예 기간 동안 접근 가능하지만 slug 는 즉시 해제. --yes 안 넘기면 확인 필요. --yes 는 스크립트용 — 인터랙티브에 타이핑 전 생각.

`flows use` 와 `flows current`

nora flows use support-agent
nora flows current  # "support-agent" 인쇄

워크스페이스별 Flow 고정. Flow 에 기본하는 모든 명령 (agents create, tools list, flows publish 등) 이 고정된 slug 사용. 워크스페이스 전환? 고정이 따라옴 — 각 워크스페이스가 자체 고정 Flow 기억. 고정 변경 없이 한 명령만 오버라이드:

nora --flow other-flow tools list

배포

nora flows publish [slug] --note "release 2026-07-31 refund cleanup"

현재 Draft 를 새 버전으로 스냅샷하고 라이브 포인터 이동. Owner 와 Manager 만 배포 가능. 옵션 플래그:

--note <text> — 릴리스 노트 (강력 권장; versions list 와 감사 트레일에 표시).
--author-label <text> — 버전 카드에 표시. 계정 이름 기본.

사전 배포 서버 체크: 사이클 없음, 모든 입력 와이어링, 빈 프롬프트 없음, Draft ≠ 현재 배포 (no-op 배포 없음). 흔한 CI 레시피:

nora flows apply support flows/support.json
nora flows publish support --note "$(git log -1 --pretty=%B | head -n1)"

롤백

nora flows versions list <slug>
nora flows rollback <slug> <seq>

라이브 포인터를 옛 버전으로 롤. Draft 안 만짐. 즉시 — 재배포가 아닌 포인터 플립. 롤백 안전: 아무것도 잃지 않음. 언제든 새 버전으로 다시 롤 포워드 가능.

버전에서 Draft 복원

nora flows versions restore <slug> <seq>

옛 버전 페이로드를 Draft 에 복사. 프로덕션 안 만짐. 옛 버전을 있는 그대로 출시 안 하고 편집 하고 싶을 때 사용. 흔한 경우: 출혈 멈추려 v14 로 롤백; v16 변경을 오프라인에서 수정하고 싶음. 스크래치 Flow 에 v16 을 Draft 로 복원, 손 편집, 다시 적용, 배포.

버전 메타데이터

nora flows versions list <slug>          # 요약
nora flows versions get <slug> <seq>     # 전체 메타데이터 (페이로드 제외)

버전 이력이 배포, 롤백, 복원 커버. “누가 언제 뭐 배포했나” 재구성에 좋음. 구조화 출력에 --json 추가.

워크스페이스 간 작업

많은 명령이 호출별 --workspace 수용해 스크립트가 전환 없이 여러 워크스페이스에 액션 가능:

for ws in acme-dev acme-staging acme-prod; do
  nora --workspace $ws flows list --json | jq -r '.[].slug'
done

빈 캔버스와 동일한 Flow 재배포는 서버 쪽 거부. 앱의 Publish 버튼과 같은 가드레일.

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

명령

`flows list`

`flows get`

`flows snapshot`

`flows apply`

`flows delete`

`flows use` 와 `flows current`

배포

롤백

버전에서 Draft 복원

버전 메타데이터

워크스페이스 간 작업

​명령

​flows list

​flows get

​flows snapshot

​flows apply

​flows delete

​flows use 와 flows current

​배포

​롤백

​버전에서 Draft 복원

​버전 메타데이터

​워크스페이스 간 작업

명령

`flows list`

`flows get`

`flows snapshot`

`flows apply`

`flows delete`

`flows use` 와 `flows current`

배포

롤백

버전에서 Draft 복원

버전 메타데이터

워크스페이스 간 작업