워크스페이스와 조직

워크스페이스는 조직 기능이 있는 인스턴스에서 작업이 놓이는 곳으로, 학교의 반이나 회사의 팀에 해당합니다. 이 Nodaro CLI 명령들은 명령이 작동할 워크스페이스를 선택하고, 조직과 멤버를 관리하고, 사용량 보고서를 내보냅니다. 조직은 인스턴스마다 켜는 Nodaro Cloud 기능이며, 조직 기능이 없는 인스턴스에서는 이 명령들을 사용할 수 없습니다.

명령이 작동할 워크스페이스 선택

브라우저는 모든 화면에 현재 워크스페이스를 보여 줍니다. 터미널은 아무것도 보여 주지 않으므로, CLI에서는 선택을 명시적으로 합니다. 설정하는 방법은 세 가지이며, 각 방법은 그 아래의 방법보다 우선합니다.

nodaro --workspace <id> workflows list   # 1. this command only
export NODARO_WORKSPACE=<id>             # 2. this shell, or this CI job
nodaro workspace use <id>                # 3. saved on the profile until you change it

• nodaro workspace current는 현재 위치와, 세 가지 중 어느 방법으로 정해졌는지를 알려 줍니다. 그렇지 않으면 상속된 NODARO_WORKSPACE가 저장된 워크스페이스와 똑같아 보일 수 있습니다.
• nodaro workspace use는 워크스페이스를 저장하기 전에 확인하므로, 오타가 있으면 그 자리에서 한 번만 실패하고 이후 모든 명령에서 실패하지 않습니다.
• nodaro workspace clear는 저장된 워크스페이스를 제거합니다.
• 워크스페이스를 설정하지 않으면 모든 작업이 내 개인 공간에서 이루어집니다.

워크스페이스는 목록을 어느 워크스페이스에서 읽을지와 생성한 항목이 어디에 놓일지를 정합니다. 접근 권한은 절대 정하지 않습니다. ID로 지정한 항목을 읽고, 수정하고, 삭제하고, 실행하는 것은 그 항목이 속한 워크스페이스를 따릅니다. 따라서 --workspace를 빠뜨려도 내 작업이 숨겨지지 않고, 잘못 지정해도 다른 사람의 작업에 접근할 수 없습니다.

워크스페이스 명령

nodaro workspace list [--json]
nodaro workspace current [--json]
nodaro workspace use <id> [--json]
nodaro workspace clear
nodaro workspace get <id> [--json]
nodaro workspace members <id> [--limit <n>] [--cursor <token>] [--json]
nodaro workspace join <code> [--json]
nodaro workspace usage [id] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--tz <iana>] [--group-by member|model|day|none] [--user <id>] [--limit <n>] [--cursor <token>] [--csv] [--json]

workspace join은 워크스페이스 관리자가 공유하는 8자리 참여 코드를 받습니다. 참여 코드를 사용하면 한 워크스페이스의 일반 멤버가 됩니다.

조직 명령

nodaro org list [--json]
nodaro org get <id> [--json]
nodaro org create --name <name> --kind school|team [--slug <slug>] [--accept-terms] [--json]
nodaro org members <orgId> [--limit <n>] [--cursor <token>] [--json]
nodaro org invite <orgId> --email a@x.com --email b@x.com [--role admin|member] [--workspace <id>] [--workspace-role admin|member] [--json]
nodaro org invitations <orgId> [--status open|accepted|revoked|expired] [--limit <n>] [--cursor <token>] [--json]
nodaro org revoke <invitationId> [--json]
nodaro org audit <orgId> [--limit <n>] [--cursor <token>] [--json]
nodaro org usage <orgId> [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--tz <iana>] [--group-by workspace|member|model|day|none] [--workspace <id>] [--user <id>] [--limit <n>] [--cursor <token>] [--csv] [--json]

• org create --kind school에는 --accept-terms가 필요합니다. 소유자가 학생을 등록할 권한이 있음을 밝히는 것입니다.
• 새 조직은 보통 대기 상태로 시작하며, 플랫폼이 승인하면 활성 상태가 됩니다. 그 전까지는 조직 안의 어떤 것도 변경할 수 없습니다.
• org revoke는 초대를 취소하며, 초대 링크는 더 이상 작동하지 않습니다.
• org audit는 조직의 감사 로그를 나열합니다.

사용자 초대

반이나 팀 전체를 인스턴스에 데려오는 일은 한 번에 대량으로 하는 작업이며, nodaro org invite는 이를 위해 만들어졌습니다. 사람마다 --email을 한 번씩 반복하고, 원하면 모든 사람을 하나의 워크스페이스에 배치하세요.

nodaro org invite org_abc --email ada@school.edu --email grace@school.edu --workspace ws_xyz --workspace-role member

이 명령은 주소마다 한 줄씩, 그 주소로 이메일을 보냈는지를 출력합니다. 메일 공급자가 없는 설치에서는 누구에게도 이메일을 보낼 수 없습니다. 이때 각 줄에는 not emailed (link_only)가 표시되고, 다음 줄에 초대 링크가 나옵니다.

그 링크는 직접 보내세요. 그러지 않으면 초대는 만들어졌지만 아무도 접근할 수 없습니다. 초대는 14일 후에 만료됩니다.

사용량 보고서

nodaro org usage와 nodaro workspace usage는 기간 동안 누가 무엇에 크레딧을 얼마나 썼는지 알려 줍니다.

• --from과 --to는 시작일과 종료일을 포함하는 날짜로, YYYY-MM-DD 형식으로 작성합니다. --tz는 일별 집계의 시간대를 설정하며, 기본값은 터미널의 시간대입니다.
• --group-by는 보고서를 workspace(조직 보고서만 해당), member, model, day 기준으로 묶습니다. none은 개별 실행을 최신순으로 나열합니다.
• 기본 출력은 합계 줄이 있는 표입니다. --json은 전체 보고서를 출력하고, --csv는 CSV를 표준 출력에 써서 바로 파일로 리디렉션할 수 있게 합니다.

nodaro org usage org_abc --from 2026-09-01 --to 2026-09-30 --group-by member --csv > september.csv

일반 워크스페이스 멤버는 자신의 사용량만 볼 수 있습니다. 워크스페이스 관리자는 워크스페이스의 모든 사람의 사용량을 볼 수 있으며, 조직 보고서는 소유자와 조직 관리자를 위한 것입니다.