전체 명령 참조
작업별 명령과 필요한 입력, 주요 옵션을 확인할 수 있습니다.
공통 사용 기준
- 조직별 업무 명령은 선택 조직을 사용하며,
--org ORG_SLUG로 해당 요청의 조직을 지정할 수 있습니다. 로그인·로컬 설정·PC 터널 연결은 각각의 입력 방식을 따릅니다. ID는 목록 조회 결과에서 가져옵니다. 이름·조직 slug·리소스 ID를 서로 바꿔 쓰지 않습니다.- JSON·페이지 출력은 지원하는 명령에서만 사용합니다. 표에 적힌 옵션 외의 세부 옵션은 해당 명령의
--help를 확인하세요. --force는 삭제·제거·탈퇴를 실행하겠다는 확인입니다. 권한 검사를 우회하거나 실패한 작업을 강제하는 옵션이 아닙니다.-f로도 입력할 수 있습니다.admin은 CLI의 관리 명령 그룹입니다. 작업 대상에 따라 필요한 권한이 다릅니다.- 명령이 도움말에 표시되어도 계정 권한과 서버의 기능 제공 조건은 적용됩니다. 제한되는 기능을 사용하기 위해 임의로 개발용 배포로 전환하지 마세요.
최상위 그룹
| 그룹 | 안내 |
|---|---|
auth, config | 로그인과 접속 환경 |
org | 조직 선택·정보 |
skill, agent, automation | 리소스 조회·관리 |
chat, drive, integration | 대화·파일·연동 조회 |
model | 모델 목록 조회 |
admin | org, agent, skill, integration, usage, audit, tunnel 관리 그룹 |
tunnel | PC 터널 연결 |
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 use | ORG_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
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl skill list | [--search TEXT] [--json] | 접근 가능한 Skill 목록을 조회합니다. |
aipctl skill get | SKILL_ID [--json] | 상세 정보와 최대 10개의 파일 정보를 조회합니다. |
aipctl skill upload | FILE [--overwrite] | .zip·.skill 파일을 등록합니다. 같은 이름을 교체할 때만 --overwrite를 사용합니다. |
aipctl skill download | SKILL_ID [-o FILE] | 다운로드 가능한 조직 Skill을 저장합니다. 같은 경로의 파일은 덮어씁니다. |
aipctl skill delete | SKILL_ID --force | 대상 Skill을 확인한 뒤 삭제합니다. |
aipctl skill library | [--search TEXT] | 공유 라이브러리 목록입니다. --json은 지원하지 않습니다. |
aipctl skill clone | SKILL_ID [SKILL_ID ...] | 라이브러리 Skill을 최대 5개 복제합니다. 항목별 결과를 확인합니다. |
aipctl skill built-in | [--search TEXT] | 기본 제공 Skill을 조회합니다. AI Operator 권한이 필요합니다. |
aipctl skill clone-built-in | SKILL_ID [SKILL_ID ...] | 기본 제공 Skill을 최대 5개 복제합니다. AI Operator 권한이 필요합니다. |
Agent
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl agent list | [--json] | 설치된 Agent 목록을 조회합니다. |
aipctl agent get | AGENT_ID [--json] | 이름·설명·필요한 연동 정보를 조회합니다. |
aipctl agent enable | AGENT_ID | 활성화 정책과 권한에 따라 Agent를 활성화합니다. |
aipctl agent disable | AGENT_ID | Agent를 비활성화합니다. |
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 get | AUTOMATION_ID [--json] | 저장된 상세 설정을 조회합니다. 비밀정보는 전체 표시되지 않을 수 있습니다. |
aipctl automation triggers | webhook --service-type SERVICE_TYPE | Webhook 설정 정보를 조회합니다. 외부 메일·저장소의 설정 정보 조회는 제한됩니다. |
aipctl automation history | AUTOMATION_ID [--page N] | 실행 이력을 페이지별로 조회합니다. |
aipctl automation create | JSON_FILE | 예약·Webhook·My Drive 자동화를 생성합니다. 생성 JSON의 트리거 유형을 맞춰 입력합니다. |
aipctl automation update | AUTOMATION_ID JSON_FILE | 지원하는 자동화의 설정을 수정합니다. 유지할 필드도 입력 파일에 포함합니다. |
aipctl automation delete | AUTOMATION_ID --force | 자동화를 삭제합니다. |
aipctl automation enable | AUTOMATION_ID | 자동화를 활성화합니다. 조건에 따라 Agent가 실행될 수 있습니다. |
aipctl automation disable | AUTOMATION_ID | 자동화를 비활성화합니다. 이미 실행 중인 작업의 취소 완료를 뜻하지 않습니다. |
aipctl automation run | AUTOMATION_ID | 즉시 실행을 요청합니다. 완료 여부는 실행 이력에서 확인합니다. |
aipctl automation cancel | AUTOMATION_ID SEQ | 실행 이력의 순번으로 취소를 요청합니다. 취소 가능 상태와 최종 결과를 확인합니다. |
aipctl automation webhook-regen | AUTOMATION_ID [--show-sensitive] | Webhook 주소를 재발급합니다. 기본 출력은 마스킹되며 외부 발신 측의 연결 주소도 확인해야 합니다. |
automation triggers 도움말의 --account-id·--folder-id는 외부 서비스용 옵션입니다. 옵션을 입력할 수 있다는 이유로 현재 서버에서 그 서비스를 지원하는 것은 아닙니다. 지원 범위와 서비스 종류를 확인하세요.
대화와 My Drive
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl chat list | [--json] | 본인 대화 목록을 조회합니다. |
aipctl chat get | CONVERSATION_ID | 본인 대화의 상세 정보입니다. --json은 없습니다. 웹의 첨부·태그·보관 상태 전체를 재현하지 않습니다. |
aipctl chat messages | CONVERSATION_ID | 메시지당 최대 500자의 마스킹된 텍스트를 표시합니다. --json은 없습니다. |
aipctl drive list | 없음 | My Drive 항목을 조회합니다. --json은 없습니다. |
aipctl drive mkdir | NAME | 루트에 폴더를 생성합니다. 상위 폴더 지정 옵션은 없습니다. |
aipctl drive rename | ENTRY_ID NEW_NAME | 파일·폴더의 이름을 변경합니다. |
aipctl drive delete | ENTRY_ID [ENTRY_ID ...] --force | 파일·폴더를 하나 또는 여러 개 삭제합니다. 폴더는 하위 항목에도 영향을 줍니다. |
aipctl drive usage | 없음 | 저장 공간 사용량을 조회합니다. |
aipctl drive upload | FILE | 로컬 파일을 루트에 업로드합니다. 출력된 ID와 목록으로 완료를 확인합니다. |
aipctl drive download | ENTRY_ID --output FILE | 저장 경로가 필수입니다. -o로도 지정하며 같은 경로의 파일은 덮어씁니다. |
연동과 모델
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl integration list | 없음 | 접근 가능한 연동과 정책 상태를 조회합니다. |
aipctl integration test | INTEGRATION_ID | 연결 테스트를 요청합니다. 테스트를 지원하지 않는 연동은 거절될 수 있습니다. |
aipctl model list | 없음 | 모델 ID 목록을 조회합니다. |
조직 멤버 관리
조직 관리 권한과 조직 정책이 적용됩니다.
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl admin org invite | EMAIL [EMAIL ...] [--role ROLE] | 최대 100개의 이메일을 초대합니다. 기본 역할은 member이며 일부 실패가 있을 수 있습니다. |
aipctl admin org remove-member | EMAIL [EMAIL ...] --force | 최신 멤버 상태를 확인한 뒤 조직에서 제거합니다. |
aipctl admin org update-member-role | EMAIL [EMAIL ...] --role ROLE | 멤버 역할을 변경합니다. 역할은 owner, admin, aiOperator, member입니다. |
조직 Agent 관리
AI Operator 권한과 Agent 관리 정책이 적용됩니다.
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl admin agent create | JSON_FILE | JSON 설정으로 Agent를 생성합니다. 필요한 설정과 활성화를 별도로 확인합니다. |
aipctl admin agent update | AGENT_ID JSON_FILE | Agent 유형에 맞는 JSON으로 설정을 수정합니다. |
aipctl admin agent delete | AGENT_ID --force | 사용 중인 연결을 확인한 뒤 삭제합니다. |
aipctl admin agent share | AGENT_ID | 공유 설정을 조회합니다. 공유 대상 수정 명령이 아닙니다. |
aipctl admin agent templates | 없음 | Agent 템플릿 목록을 조회합니다. |
aipctl admin agent export | AGENT_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 get | SKILL_ID [--json] | 조직 Skill 상세와 GitHub 연결 정보를 확인합니다. |
aipctl admin skill upload | FILE [--overwrite] | 조직 Skill 파일을 등록합니다. 같은 이름 교체 여부를 검토하세요. |
aipctl admin skill download | SKILL_ID [-o FILE] | 조직 Skill을 다운로드합니다. 같은 경로의 파일은 덮어씁니다. |
aipctl admin skill delete | SKILL_ID --force | 조직 Skill을 삭제합니다. |
aipctl admin skill publish | SKILL_ID | 라이브러리에 공개합니다. |
aipctl admin skill unpublish | SKILL_ID | 라이브러리 공개를 해제합니다. |
aipctl admin skill built-in | [--search TEXT] | 기본 제공 Skill 목록을 조회합니다. |
aipctl admin skill clone-built-in | SKILL_ID [SKILL_ID ...] | 기본 제공 Skill을 최대 5개 복제합니다. 항목별 결과를 확인합니다. |
aipctl admin skill github inspect | GITHUB_URL [--pat-env ENV_NAME] [--json] | 저장소·브랜치 정보를 확인합니다. |
aipctl admin skill github import | GITHUB_URL [--pat-env ENV_NAME] [--overwrite] [--json] | 저장소 또는 Skill 폴더에서 조직 Skill을 가져옵니다. |
aipctl admin skill github sync | SKILL_ID [--apply] [--json] | 기본 동작은 변경 확인이며, --apply를 붙여야 업데이트합니다. |
aipctl admin skill github credentials set | SKILL_ID --pat-env ENV_NAME | 해당 Skill의 GitHub PAT를 저장·변경합니다. 변수 이름을 입력하세요. |
aipctl admin skill github credentials clear | SKILL_ID | 저장된 PAT를 삭제합니다. GitHub의 토큰 자체를 폐기하지는 않습니다. |
연동 관리 조회
AI Operator 권한이 필요합니다.
| 명령 | 입력·주요 옵션 | 동작과 주의점 |
|---|---|---|
aipctl admin integration available | 없음 | 사용할 수 있는 연동 목록을 조회합니다. |
aipctl admin integration get | INTEGRATION_ID | 연동의 상세 설정 상태를 확인합니다. |
aipctl admin integration tools | INTEGRATION_ID | 도구 이름·설명·정책 상태를 확인합니다. 도구를 실행하지 않습니다. |
aipctl admin integration update | INTEGRATION_ID JSON_FILE | 해당 연동의 계약에 맞는 JSON으로 수정합니다. 조회 결과를 그대로 입력하지 마세요. |
aipctl admin integration delete | INTEGRATION_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 link | CONNECTION_TOKEN | PC 터널을 연결합니다. 작업 중 프로세스를 유지하고 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] | 연결 토큰 생성을 요청합니다. 성공 출력이 토큰 원문을 표시하는 것은 아닙니다. |
출력·실패 처리 함께 확인하기
- 스크립트와 목록 조회: 명령별 JSON 지원, 페이지 옵션, 종료 코드
- 제약사항과 문제 해결: 인증·권한·한도·조회 제한·변경 결과 미확정 대응
개별 명령에 필요한 입력을 확인하려면 실행할 명령 끝에 --help를 붙이세요. 도움말은 작업을 실행하지 않습니다.
Last updated on