# dvina 명령 사용하기

> Dvina가 코드를 실행할 때 dvina 명령이 하는 일과 사용할 수 있는 명령, 승인이 필요한 명령을 알아보세요.

Dvina가 코드를 실행하거나 명령을 수행할 때 사용하는 자체 명령이 있습니다. 바로 `dvina`입니다. 스크립트나 여러 단계를 연속으로 실행하면서 이 명령을 사용해 사용자의 권한으로 Dvina를 검색하고, 문서와 메모리, 작업을 읽거나 추가하고, 항목에 접근할 수 있는 사람을 확인할 수 있습니다.

설치하거나 로그인할 필요가 없습니다. Dvina는 요청을 처리하는 데 필요할 때 이 명령을 사용합니다. 직접 사용을 요청할 수도 있습니다. 예를 들어 "dvina로 내 작업 목록을 확인하고 요약을 노트로 작성해 줘"라고 요청해 보세요.

## 작동 방식

- `dvina`는 사용자의 권한으로 사용자의 Dvina에서 작동하며, 역할에 허용된 범위와 평소 적용되는 한도를 따릅니다.
- 접근 권한은 Dvina가 요청을 처리하는 동안에만 유지됩니다. 응답이 끝나면 명령은 더 이상 사용자의 Dvina에 접근할 수 없습니다.
- 업로드할 파일처럼 명령에서 지정한 파일이나 폴더만 읽습니다.

## 명령

명령은 그룹별로 나뉩니다. `dvina <group> <command>` 뒤에 해당 명령의 인수와 플래그를 입력합니다.

| 그룹      | 명령                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: 채팅, 문서, 메모리, 월드를 한 번에 검색합니다.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: 메모리 파일 목록을 확인하거나 파일을 읽고, 추가하고, 수정합니다.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: 사용자의 주제, 특정 대상에 대해 Dvina가 알고 있는 내용, 사용자의 피드를 확인합니다.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: 라이브러리의 문서와 폴더를 다룹니다. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: 캔버스 페이지 목록을 확인하거나 페이지를 읽고, 만들고, 다시 작성합니다.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: 백그라운드 작업을 다룹니다.                                                        |
| `goals`    | `show`, `start`: 목표 달성을 위한 작업을 다룹니다.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: 일회성 또는 반복 예약 메시지와 알림을 다룹니다.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: 에이전트를 다룹니다.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: 스킬을 다룹니다.                                                                                |
| `projects` | `ls`, `show`: 프로젝트를 다룹니다.                                                                                             |
| `settings` | `get`, `set`: 메모리 켜기 또는 끄기 같은 환경설정을 다룹니다.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: 항목에 접근할 수 있는 사람과 다른 사람이 공유한 항목을 확인하고, 접근 권한을 부여하거나 제거합니다.  |

`dvina`는 항목을 영구 삭제하거나, 공개 링크를 열거나, 앱을 연결하거나 연결 해제하거나, 관리자 설정 또는 결제 설정을 변경할 수 없습니다.

### 도움말과 출력

- `dvina --help`는 그룹 목록을, `dvina <group> --help`는 해당 그룹의 명령 목록을, `dvina <group> <command> --help`는 해당 명령의 인수와 플래그 목록을 보여 줍니다.
- 출력은 짧은 텍스트입니다. JSON으로 출력하려면 `--json`을 추가하세요. 일부 필드만 남기려면 `--fields id,title`처럼 `--fields` 뒤에 쉼표로 구분한 목록을 입력하세요.
- 긴 목록은 `next: --cursor <c>`로 끝납니다. 다음 페이지를 보려면 해당 `--cursor`를 넣어 명령을 다시 실행하세요.
- 파일에서 값을 읽으려면 `--content-file notes.md`처럼 플래그에 `-file`을 붙이세요. `dvina docs upload <file>`은 파일을 업로드하고, `dvina skills add <folder>`는 SKILL.md가 포함된 스킬 폴더를 추가합니다.

### 종료 코드

| 코드 | 의미                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | 완료되었습니다.                                                                         |
| `1`  | 그 밖의 문제가 발생했습니다.                                                    |
| `2`  | 명령이 잘못되었습니다. 해당 명령의 `--help`를 확인하세요.                                     |
| `3`  | 찾을 수 없습니다.                                                                    |
| `4`  | 거부되었습니다. 사용자의 접근 권한, 회사 규칙 또는 데이터 보호 규칙에서 허용하지 않습니다. |
| `5`  | 사용자의 승인이 필요합니다.                                                       |
| `6`  | 사용량 한도에 도달했습니다.                                              |

## 변경 승인하기

- 읽기 명령은 승인을 요청하지 않고 실행됩니다.
- `docs create`, `memory add`, `tasks start`처럼 새 항목을 추가하는 명령은 승인을 요청하지 않고 실행됩니다. 기존 항목은 변경하지 않습니다.
- 항목을 변경하거나 제거하는 명령은 먼저 승인을 요청합니다. 이동, 이름 변경, 휴지통으로 이동, 노트 또는 메모리 파일 교체, 캔버스 페이지 다시 작성, 에이전트 또는 스킬 변경, 작업 중지, 예약 메시지 취소, 공유가 여기에 해당합니다. Dvina는 변경 내용을 직접 요약한 승인 카드를 채팅에 표시하고 매번 승인을 요청합니다. 거부하면 아무것도 변경되지 않습니다.

`dvina`가 추가하거나 변경하는 내용에는 Dvina의 다른 작업과 마찬가지로 회사의 데이터 보호 규칙이 적용되며, [감사 로그](/docs/teams/audit-log)에 기록됩니다.

## 관련 문서

- [MCP로 다른 앱에서 Dvina 사용하기](/docs/dvina-mcp/overview)
- [작업](/docs/use-dvina/features/tasks)
- [커넥터 개요](/docs/connectors/overview)