Skip to Content
Skip to Content
전체 명령 참조

전체 명령 참조

작업별 명령과 필요한 입력, 주요 옵션을 확인할 수 있습니다.

공통 사용 기준

  • 조직별 업무 명령은 선택 조직을 사용하며, --org ORG_SLUG로 해당 요청의 조직을 지정할 수 있습니다. 로그인·로컬 설정·PC 터널 연결은 각각의 입력 방식을 따릅니다.
  • ID는 목록 조회 결과에서 가져옵니다. 이름·조직 slug·리소스 ID를 서로 바꿔 쓰지 않습니다.
  • JSON·페이지 출력은 지원하는 명령에서만 사용합니다. 표에 적힌 옵션 외의 세부 옵션은 해당 명령의 --help를 확인하세요.
  • --force는 삭제·제거·탈퇴를 실행하겠다는 확인입니다. 권한 검사를 우회하거나 실패한 작업을 강제하는 옵션이 아닙니다. -f로도 입력할 수 있습니다.
  • admin은 CLI의 관리 명령 그룹입니다. 작업 대상에 따라 필요한 권한이 다릅니다.
  • 명령이 도움말에 표시되어도 계정 권한과 서버의 기능 제공 조건은 적용됩니다. 제한되는 기능을 사용하기 위해 임의로 개발용 배포로 전환하지 마세요.

최상위 그룹

그룹안내
auth, config로그인과 접속 환경
org조직 선택·정보
skill, agent, automation리소스 조회·관리
chat, drive, integration대화·파일·연동 조회
model모델 목록 조회
adminorg, agent, skill, integration, usage, audit, tunnel 관리 그룹
tunnelPC 터널 연결

admin skill github 아래에는 inspect, import, sync, credentials가 있으며, credentials 아래에는 set, clear가 있습니다. tunnel 아래의 실행 명령은 link입니다.

로그인과 접속 설정

설치·로그인·갱신·환경 전환 절차

명령입력·주요 옵션동작과 주의점
aipctl auth login없음브라우저 로그인 후 조직을 선택합니다. 같은 PC에서 로그인 안내를 완료합니다.
aipctl auth logout없음로컬 로그인 정보를 삭제합니다. 이미 전송된 작업을 취소하지 않습니다.
aipctl auth status없음저장된 로그인 상태와 만료 정보를 확인합니다. 서버 연결 성공을 검사하는 명령은 아닙니다.
aipctl auth whoami없음서버에서 현재 사용자 정보를 조회합니다.
aipctl auth refresh없음현재 인증 토큰을 갱신합니다. 갱신할 수 없는 세션은 다시 로그인합니다.
aipctl config set--app-url APP_URL접속 주소를 저장합니다. 주소가 바뀌면 로그인과 선택 조직이 초기화됩니다.
aipctl config status없음PC에 저장된 접속 주소와 설정을 확인합니다.

조직

조직 선택 · 조직 사용법

명령입력·주요 옵션동작과 주의점
aipctl org list[--json]접근할 수 있는 조직과 slug를 조회합니다.
aipctl org current없음저장된 기본 조직을 확인합니다.
aipctl org useORG_SLUG이후 명령에서 사용할 기본 조직을 저장합니다.
aipctl org select없음브라우저에서 기본 조직을 선택합니다.
aipctl org members[--org ORG_SLUG]조직 멤버를 조회합니다. AI Operator 권한이 필요합니다.
aipctl org capabilities[--org ORG_SLUG]조직에서 사용할 수 있는 기능을 조회합니다.
aipctl org settings없음현재 사용자 설정을 조회합니다. 조직 설정 수정 명령이 아닙니다.
aipctl org exit--force [--org ORG_SLUG]지정 조직에서 탈퇴합니다. 실행 전 조직을 확인하세요.

Skill

Skill 조회·복제·파일 전송·삭제 절차

명령입력·주요 옵션동작과 주의점
aipctl skill list[--search TEXT] [--json]접근 가능한 Skill 목록을 조회합니다.
aipctl skill getSKILL_ID [--json]상세 정보와 최대 10개의 파일 정보를 조회합니다.
aipctl skill uploadFILE [--overwrite].zip·.skill 파일을 등록합니다. 같은 이름을 교체할 때만 --overwrite를 사용합니다.
aipctl skill downloadSKILL_ID [-o FILE]다운로드 가능한 조직 Skill을 저장합니다. 같은 경로의 파일은 덮어씁니다.
aipctl skill deleteSKILL_ID --force대상 Skill을 확인한 뒤 삭제합니다.
aipctl skill library[--search TEXT]공유 라이브러리 목록입니다. --json은 지원하지 않습니다.
aipctl skill cloneSKILL_ID [SKILL_ID ...]라이브러리 Skill을 최대 5개 복제합니다. 항목별 결과를 확인합니다.
aipctl skill built-in[--search TEXT]기본 제공 Skill을 조회합니다. AI Operator 권한이 필요합니다.
aipctl skill clone-built-inSKILL_ID [SKILL_ID ...]기본 제공 Skill을 최대 5개 복제합니다. AI Operator 권한이 필요합니다.

Agent

Agent 조회와 활성 상태 변경

명령입력·주요 옵션동작과 주의점
aipctl agent list[--json]설치된 Agent 목록을 조회합니다.
aipctl agent getAGENT_ID [--json]이름·설명·필요한 연동 정보를 조회합니다.
aipctl agent enableAGENT_ID활성화 정책과 권한에 따라 Agent를 활성화합니다.
aipctl agent disableAGENT_IDAgent를 비활성화합니다.
aipctl agent chat--agentId AGENT_ID -m MESSAGE [--json] 또는 --conversation-id ID -m MESSAGE [--json]신규·계속 대화에 사용합니다. 메시지는 표준 입력으로도 전달할 수 있습니다. 결과 미확정 시 재전송 전에 대화 이력을 확인합니다.

자동화

자동화 생성·변경·트리거 설정 예시

명령입력·주요 옵션동작과 주의점
aipctl automation list[--name TEXT] [--json]이름으로 필터링하거나 JSON으로 조회합니다. 첫 50개를 조회하며 다음 페이지 옵션은 없습니다.
aipctl automation getAUTOMATION_ID [--json]저장된 상세 설정을 조회합니다. 비밀정보는 전체 표시되지 않을 수 있습니다.
aipctl automation triggerswebhook --service-type SERVICE_TYPEWebhook 설정 정보를 조회합니다. 외부 메일·저장소의 설정 정보 조회는 제한됩니다.
aipctl automation historyAUTOMATION_ID [--page N]실행 이력을 페이지별로 조회합니다.
aipctl automation createJSON_FILE예약·Webhook·My Drive 자동화를 생성합니다. 생성 JSON의 트리거 유형을 맞춰 입력합니다.
aipctl automation updateAUTOMATION_ID JSON_FILE지원하는 자동화의 설정을 수정합니다. 유지할 필드도 입력 파일에 포함합니다.
aipctl automation deleteAUTOMATION_ID --force자동화를 삭제합니다.
aipctl automation enableAUTOMATION_ID자동화를 활성화합니다. 조건에 따라 Agent가 실행될 수 있습니다.
aipctl automation disableAUTOMATION_ID자동화를 비활성화합니다. 이미 실행 중인 작업의 취소 완료를 뜻하지 않습니다.
aipctl automation runAUTOMATION_ID즉시 실행을 요청합니다. 완료 여부는 실행 이력에서 확인합니다.
aipctl automation cancelAUTOMATION_ID SEQ실행 이력의 순번으로 취소를 요청합니다. 취소 가능 상태와 최종 결과를 확인합니다.
aipctl automation webhook-regenAUTOMATION_ID [--show-sensitive]Webhook 주소를 재발급합니다. 기본 출력은 마스킹되며 외부 발신 측의 연결 주소도 확인해야 합니다.

automation triggers 도움말의 --account-id·--folder-id는 외부 서비스용 옵션입니다. 옵션을 입력할 수 있다는 이유로 현재 서버에서 그 서비스를 지원하는 것은 아닙니다. 지원 범위와 서비스 종류를 확인하세요.

대화와 My Drive

파일·대화 조회 절차와 제한

명령입력·주요 옵션동작과 주의점
aipctl chat list[--json]본인 대화 목록을 조회합니다.
aipctl chat getCONVERSATION_ID본인 대화의 상세 정보입니다. --json은 없습니다. 웹의 첨부·태그·보관 상태 전체를 재현하지 않습니다.
aipctl chat messagesCONVERSATION_ID메시지당 최대 500자의 마스킹된 텍스트를 표시합니다. --json은 없습니다.
aipctl drive list없음My Drive 항목을 조회합니다. --json은 없습니다.
aipctl drive mkdirNAME루트에 폴더를 생성합니다. 상위 폴더 지정 옵션은 없습니다.
aipctl drive renameENTRY_ID NEW_NAME파일·폴더의 이름을 변경합니다.
aipctl drive deleteENTRY_ID [ENTRY_ID ...] --force파일·폴더를 하나 또는 여러 개 삭제합니다. 폴더는 하위 항목에도 영향을 줍니다.
aipctl drive usage없음저장 공간 사용량을 조회합니다.
aipctl drive uploadFILE로컬 파일을 루트에 업로드합니다. 출력된 ID와 목록으로 완료를 확인합니다.
aipctl drive downloadENTRY_ID --output FILE저장 경로가 필수입니다. -o로도 지정하며 같은 경로의 파일은 덮어씁니다.

연동과 모델

연동·도구·모델 정보 조회

명령입력·주요 옵션동작과 주의점
aipctl integration list없음접근 가능한 연동과 정책 상태를 조회합니다.
aipctl integration testINTEGRATION_ID연결 테스트를 요청합니다. 테스트를 지원하지 않는 연동은 거절될 수 있습니다.
aipctl model list없음모델 ID 목록을 조회합니다.

조직 멤버 관리

멤버 초대·역할 변경·제거

조직 관리 권한과 조직 정책이 적용됩니다.

명령입력·주요 옵션동작과 주의점
aipctl admin org inviteEMAIL [EMAIL ...] [--role ROLE]최대 100개의 이메일을 초대합니다. 기본 역할은 member이며 일부 실패가 있을 수 있습니다.
aipctl admin org remove-memberEMAIL [EMAIL ...] --force최신 멤버 상태를 확인한 뒤 조직에서 제거합니다.
aipctl admin org update-member-roleEMAIL [EMAIL ...] --role ROLE멤버 역할을 변경합니다. 역할은 owner, admin, aiOperator, member입니다.

조직 Agent 관리

Agent 생성·수정 JSON과 삭제·내보내기 절차

AI Operator 권한과 Agent 관리 정책이 적용됩니다.

명령입력·주요 옵션동작과 주의점
aipctl admin agent createJSON_FILEJSON 설정으로 Agent를 생성합니다. 필요한 설정과 활성화를 별도로 확인합니다.
aipctl admin agent updateAGENT_ID JSON_FILEAgent 유형에 맞는 JSON으로 설정을 수정합니다.
aipctl admin agent deleteAGENT_ID --force사용 중인 연결을 확인한 뒤 삭제합니다.
aipctl admin agent shareAGENT_ID공유 설정을 조회합니다. 공유 대상 수정 명령이 아닙니다.
aipctl admin agent templates없음Agent 템플릿 목록을 조회합니다.
aipctl admin agent exportAGENT_ID [--output FILE]YAML 형식으로 저장합니다. -o도 가능하며 생략 시 AGENT_ID.yaml에 저장합니다.

조직 Skill 관리

조직 Skill 관리 · GitHub 가져오기 · PAT 관리

AI Operator 권한이 필요합니다.

명령입력·주요 옵션동작과 주의점
aipctl admin skill list[--search TEXT] [--page N] [--page-size N] [--json]조직 Skill 목록을 페이지별로 조회합니다.
aipctl admin skill getSKILL_ID [--json]조직 Skill 상세와 GitHub 연결 정보를 확인합니다.
aipctl admin skill uploadFILE [--overwrite]조직 Skill 파일을 등록합니다. 같은 이름 교체 여부를 검토하세요.
aipctl admin skill downloadSKILL_ID [-o FILE]조직 Skill을 다운로드합니다. 같은 경로의 파일은 덮어씁니다.
aipctl admin skill deleteSKILL_ID --force조직 Skill을 삭제합니다.
aipctl admin skill publishSKILL_ID라이브러리에 공개합니다.
aipctl admin skill unpublishSKILL_ID라이브러리 공개를 해제합니다.
aipctl admin skill built-in[--search TEXT]기본 제공 Skill 목록을 조회합니다.
aipctl admin skill clone-built-inSKILL_ID [SKILL_ID ...]기본 제공 Skill을 최대 5개 복제합니다. 항목별 결과를 확인합니다.
aipctl admin skill github inspectGITHUB_URL [--pat-env ENV_NAME] [--json]저장소·브랜치 정보를 확인합니다.
aipctl admin skill github importGITHUB_URL [--pat-env ENV_NAME] [--overwrite] [--json]저장소 또는 Skill 폴더에서 조직 Skill을 가져옵니다.
aipctl admin skill github syncSKILL_ID [--apply] [--json]기본 동작은 변경 확인이며, --apply를 붙여야 업데이트합니다.
aipctl admin skill github credentials setSKILL_ID --pat-env ENV_NAME해당 Skill의 GitHub PAT를 저장·변경합니다. 변수 이름을 입력하세요.
aipctl admin skill github credentials clearSKILL_ID저장된 PAT를 삭제합니다. GitHub의 토큰 자체를 폐기하지는 않습니다.

연동 관리 조회

연동 상세·도구 목록 확인

AI Operator 권한이 필요합니다.

명령입력·주요 옵션동작과 주의점
aipctl admin integration available없음사용할 수 있는 연동 목록을 조회합니다.
aipctl admin integration getINTEGRATION_ID연동의 상세 설정 상태를 확인합니다.
aipctl admin integration toolsINTEGRATION_ID도구 이름·설명·정책 상태를 확인합니다. 도구를 실행하지 않습니다.
aipctl admin integration updateINTEGRATION_ID JSON_FILE해당 연동의 계약에 맞는 JSON으로 수정합니다. 조회 결과를 그대로 입력하지 마세요.
aipctl admin integration deleteINTEGRATION_ID --force연결에 사용하는 Agent·Preset을 확인한 뒤 삭제합니다.

사용량과 감사 로그

기간·사용자·이벤트 필터 예시

사용량은 조직 관리자 권한, 감사 로그는 해당 플랜과 접근 권한이 필요합니다. 사용량 기간은 기본적으로 이번 달 1일부터 오늘까지이며 날짜는 YYYY-MM-DD로 지정합니다.

명령입력·주요 옵션동작과 주의점
aipctl admin usage credit[--start DATE] [--end DATE]기간 내 크레딧 사용량과 사용자 통계를 조회합니다.
aipctl admin usage top-users[--start DATE] [--end DATE] [--limit N]사용자별 사용량 순위입니다. 기본 상위 10개입니다.
aipctl admin usage daily-graph[--start DATE] [--end DATE]일별 사용량을 조회합니다.
aipctl admin usage daily-users[--start DATE] [--end DATE] [--page N] [--user-id USER_ID]일별 사용자 통계를 조회하고 특정 사용자로 좁힙니다.
aipctl admin usage mcp-top[--start DATE] [--end DATE] [--limit N]MCP 도구 사용량 순위입니다. 기본 상위 10개입니다.
aipctl admin audit list[--type EVENT_TYPE] [--page N]이벤트 유형과 페이지를 지정해 감사 로그를 조회합니다.
aipctl admin audit types없음감사 이벤트 유형의 식별자를 조회합니다.

PC 터널 연결

터널 연결 절차

연결 토큰은 웹의 PC 연결 안내에서 준비합니다. 일반 관리용 로그인과 별개입니다.

명령입력·주요 옵션동작과 주의점
aipctl tunnel linkCONNECTION_TOKENPC 터널을 연결합니다. 작업 중 프로세스를 유지하고 Ctrl+C로 종료합니다.
aipctl admin tunnel status[--org ORG_SLUG]해당 조직에서 본인의 연결 상태를 조회합니다. 조직 전체 연결 조회가 아닙니다.
aipctl admin tunnel config[--show-sensitive] [--org ORG_SLUG]연결 명령과 연결 수 정보를 조회합니다. 비밀정보는 기본 마스킹됩니다.
aipctl admin tunnel token[--org ORG_SLUG]연결 토큰 생성을 요청합니다. 성공 출력이 토큰 원문을 표시하는 것은 아닙니다.

출력·실패 처리 함께 확인하기

개별 명령에 필요한 입력을 확인하려면 실행할 명령 끝에 --help를 붙이세요. 도움말은 작업을 실행하지 않습니다.

Last updated on