vscli (Install)

개발 컨테이너 실행 및 감지

vscli open 명령은 현재 디렉터리 또는 지정된 경로에서 개발 컨테이너 설정을 자동으로 감지합니다. 감지 로직은 다음과 같이 작동합니다: 먼저 –config 플래그로 지정된 구성이 있으면それを 사용하고, 없으면 프로젝트 내의 devcontainer.json 파일을 찾아 하나 이상 존재할 경우 인터랙티브 선택 UI를 보여줍니다. 개발 컨테이너가 없을 경우 일반 VS Code를 실행합니다.

다중 에디터 지원

–command 플래그를 통해 code, code-insiders, cursor 등 다양한 에디터를 지정할 수 있습니다. 이는 사용자가 선호하는 에디터로 유연하게 전환할 수 있게 하며, 추가 인수를 — 뒤에 전달하여 에디터의 실행 옵션을 커스터마이징할 수 있습니다 (예: –disable-gpu).

외부 구성 관리

vscli config 하위 명령을 통해 ~/.local/share/vscli/configs/ (또는 VSCLI_CONFIG_DIR)에 개발 컨테이너 구성을 저장하고 관리할 수 있습니다. config add, config copy, config list, config ui, config rm 등을 통해 구성을 생성, 복사, 목록 보기, 편집, 삭제할 수 있으며, 저장된 구성을 –config 플래그로 어떤 프로젝트에도 적용할 수 있습니다.

컨테이너 관리

vscli container 하위 명령을 통해 실행 중인 개발 컨테이너를 목록 보기(container list), 상세 정보 확인(container info), 중지(container stop), 인터랙티브 선택(container ui)할 수 있습니다. -a 플래그로 중지된 컨테이너도 포함할 수 있으며, ct, cfg 등 단축 별칭도 지원됩니다.

역사 및 최근 작업 공간

vscli recent 명령은 최근에 열린 작업 공간의 인터랙티브 목록을 표시합니다. 이 UI에서는 키보드 또는 마우스로 항목을 선택하고, –hide-instructions, –hide-info 등으로 표시 내용을 커스터마이징할 수 있으며, –command 및 –behavior 플래그로 실행 방식을 재정의할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 Chocolatey 또는 Winget을 통해 vscli를 간편하게 설치할 수 있습니다. Chocolatey를 사용하는 경우 관리자 권한으로 PowerShell 또는 CMD를 열고 다음 명령을 실행합니다:

choco install vscli

Winget을 사용하는 경우 다음 명령을 실행합니다:

winget install vscli

또한 Rust의 Cargo를 통해 설치할 수도 있습니다:

cargo install vscli

설치 후 vscli 명령이 터미널에서 사용 가능하며, vs –version 등으로 버전을 확인할 수 있습니다.

기본 사용법/명령어

vscli는 다음과 같은 주요 하위 명령을 제공합니다:

• vscli open: 개발 컨테이너 또는 일반 프로젝트를 엽니다. 기본적으로 현재 디렉터리(.)를 대상으로 합니다.
• vscli recent: 최근 사용한 작업 공간의 인터랙티브 목록을 표시합니다.
• vscli config: 외부 개발 컨테이너 구성을 관리합니다 (추가, 목록, 복사, 편집, 삭제 등).
• vscli container: 실행 중인 개발 컨테이너를 목록 보기, 정보 확인, 중지 등을 수행합니다.
• vscli help: 도움말을 표시합니다.
• vscli version: 버전 정보를 출력합니다.

각 명령은 -h 또는 –help 플래그로 상세 옵션을 확인할 수 있으며, 일반적인 사용 예시는 다음과 같습니다:

vscli open # 현재 디렉터리의 프로젝트 열기 (개발 컨테이너 감지 시도)
vscli open /path/to/project # 특정 경로의 프로젝트 열기
vscli open –behavior force-container . # 개발 컨테이너가 없어도 강제로 컨테이너 모드로 실행
vscli open –behavior force-classic . # 개발 컨테이너가 있어도 강제로 일반 모드로 실행
vscli open –command cursor . # Cursor 에디터로 프로젝트 열기
vscli recent # 최근 작업 공간 목록 UI 열기
vscli config list # 저장된 외부 구성 목록 보기
vscli container list # 실행 중인 개발 컨테이너 목록 보기

이런 경우에 유용합니다

여러 프로젝트를 오가며 개발 환경을 자주 설정해야 하는 개발자에게 유용합니다. 특히 팀 내 개발 컨테이너 구성을 표준화하고 싶을 때, vscli의 외부 구성 기능을 통해 하나의 설정을 저장하고 모든 프로젝트에서 재사용할 수 있어 환경 차이로 인한 ‘내 machine에서는 동작한다’ 문제를 줄일 수 있습니다. 또한 VS Code 기반 에디터를 사용하면서도 컨테이너 기반 개발 워크플로에 익숙하지 않은 사용자는 vscli open 명령 하나로 복잡한 Docker 설정을 몰라도 개발 환경을 시작할 수 있습니다.

지원 환경·시스템 요구사항

vscli는 Rust로 작성되어 Windows, Linux, macOS에서 실행됩니다. Windows에서는 Chocolatey, Winget, Cargo 등을 통해 설치할 수 있으며, 실행에는 Docker가 필요합니다. 개발 컨테이너 기능을 사용하려면 Docker Engine이 설치되고 실행 중이어야 하며, VS Code 또는 지원되는 에디터가 시스템에 설치되어 있어야 합니다. 에디터는 PATH에 등록되어 있어야 하며, –command 플래그로 특정 에디터 경로를 지정할 수도 있습니다.

최신 버전·업데이트

현재 버전은 1.3.3이며, GitHub 저장소의 릴리스 페이지에서 변경 사항을 확인할 수 있습니다. 최신 버전은 cargo install vscli 또는 choco upgrade vscli 등을 통해 업데이트할 수 있습니다.

제한 사항·확인 사항

개발 컨테이너 기능을 사용하려면 Docker가 설치되고 실행 중이어야 합니다. Docker가 실행되지 않거나 접근 권한이 없을 경우 vscli는 일반 모드로 fallback하거나 오류를 발생시킬 수 있습니다. 또한 –config 플래그로 지정된 구성이 존재하지 않거나 유효하지 않은 devcontainer.json 파일을 포함하는 경우 오류가 발생합니다. 외부 구성은 기본적으로 ~/.local/share/vscli/configs/ 디렉터리에 저장되며, 이 경로에 대한 쓰기 권한이 필요합니다.