설치와 첫 실행
Windows에 Liverary를 설치하고, AI 에이전트를 연결해 첫 프로젝트 작업을 시작합니다.
Liverary는 AI 에이전트와 대화하면서 프로젝트의 파일, 터미널, Git 변경 내용을 함께 다루는 작업 공간입니다. 이 가이드는 2026년 11월 14일 공개된 Liverary v1.0.0을 기준으로 작성했습니다.
처음에는 Windows 앱을 설치하고 에이전트 하나를 연결하면 됩니다. 별도의 Liverary 회원가입은 없으며, AI 작업에는 선택한 제공자의 계정이나 API 인증이 필요합니다.
1. 설치 파일 선택하기
GitHub 최신 릴리스의 Assets에서 사용할 파일을 내려받습니다. 일반적인 Windows 사용에는 첫 번째 EXE 파일을 선택하세요.
| 사용 목적 | v1.0.0 파일 | 설명 |
|---|---|---|
| Windows x64 데스크톱 앱 | Liverary-1.0.0-x64.exe | 창으로 실행하는 앱과 내장 CLI를 설치합니다. |
| Windows x64 독립 CLI | liverary-1.0.0-win32-x64.zip | 데스크톱 앱 없이 명령줄 실행 환경을 구성할 때 사용합니다. |
| Linux·WSL x64 독립 CLI | liverary-1.0.0-linux-x64.tar.gz | Linux 또는 WSL에서 실행 환경을 구성할 때 사용합니다. |
현재 공개 릴리스에는 macOS와 Linux 데스크톱 설치 파일이 없습니다. .blockmap, latest.yml, SHA256SUMS는 일반 사용자가 실행하는 설치 프로그램이 아닙니다.
EXE를 실행해 설치를 마친 뒤 Liverary를 엽니다. 현재 Windows 설치본은 코드 서명이 없어 운영체제에 게시자 확인 안내가 나타날 수 있습니다. 내려받은 주소와 파일명이 위 공식 릴리스와 일치하는지 확인하세요.
이전 설치본에서 옮기는 경우
이 릴리스는 버전 번호를 1.0.0부터 다시 시작한 배포입니다. 이전 T3 Custom·Ondam·Liverary의 1.0.x·1.1.x·1.2.x를 사용했다면 앱을 종료하고 새 EXE를 직접 실행해야 합니다. 이전 설치본의 자동 업데이트만으로 전환할 수 없으며, 기존 데이터 폴더를 삭제할 필요는 없습니다.
독립 CLI를 사용했다면 새 압축 파일을 새 폴더에 풀고 실행 경로를 바꿉니다. 이후 업데이트는 설정과 업데이트에서 확인하세요.
2. 에이전트 하나 연결하기
- 첫 실행 화면에서 사용할 컴퓨터를 확인합니다. 내 PC에서 작업하려면 로컬 환경을 사용합니다.
- 에이전트 연결에서 사용할 Codex·Claude 등의 에이전트를 선택합니다.
- 설치 상태를 확인하고, 필요한 경우 화면의 설치 또는 설정을 진행합니다.
- 제공자가 안내하는 브라우저나 터미널에서 로그인을 완료합니다.
- 준비 완료 상태를 확인한 뒤 작업 화면으로 이동합니다.
같은 컴퓨터에서 이미 Codex나 Claude를 쓰고 있다면 기존 CLI 인증을 사용할 수 있습니다. 앱이 실행 파일을 찾지 못하면 설정 → AI 제공자의 실행 파일 경로를 확인합니다. 자세한 계정 추가와 모델 설정은 AI 제공자와 모델에 정리했습니다.
에이전트 없이 시작을 선택해 화면을 먼저 둘러볼 수도 있습니다. 이 경우 실제 AI 요청을 보내기 전에 제공자를 연결해야 합니다.
3. 프로젝트 열고 첫 요청 보내기
- 홈 또는 사이드바에서 프로젝트 추가를 엽니다.
- 로컬 폴더를 선택하고 작업할 폴더를 등록합니다. Git 저장소가 있다면 해당 저장소의 루트 폴더를 선택하세요.
- 프로젝트에서 새 대화를 열고 사용할 제공자와 모델을 확인합니다.
- 입력창의 권한에서 승인 방식을 확인한 뒤 첫 요청을 보냅니다.
처음에는 프로젝트를 이해하는 요청으로 연결 상태와 작업 위치를 확인할 수 있습니다.
이 프로젝트의 폴더 구조와 실행 방법을 설명해 줘.
파일을 수정하기 전에 어떤 파일을 읽을지 먼저 알려 줘.응답이 나오고 프로젝트 파일을 정상적으로 읽으면 첫 연결이 된 것입니다. 승인 요청이 나타나면 요청한 명령이나 파일을 확인하고 진행하세요. 이후 작은 수정 하나를 요청한 뒤 변경 내용에서 결과를 검토합니다.
Git 주소에서 복제하거나 새 프로젝트를 만드는 방법은 프로젝트와 작업 공간, 계획 모드와 승인 방식은 대화와 작업 진행에서 이어집니다.
4. 이미 쓰던 대화 이어가기
자동 공유를 지원하는 제공자의 대화는 별도 가져오기 없이 표시됩니다. 같은 실행 환경과 제공자 계정, 세션 저장소를 사용해야 합니다. 원래 앱에서 실행 중인 작업을 마친 뒤 Liverary에서 이어 쓰세요.
지원 범위는 설정 → AI 제공자 → 세션 공유에서 확인합니다. Codex·Claude·Cursor는 공유 방식이 서로 다르므로, 대화 이어쓰기의 지원표를 먼저 확인하면 좋습니다.
다음으로 할 일
| 하려는 일 | 안내 |
|---|---|
| 다른 AI 계정과 모델 연결 | AI 제공자와 모델 |
| 프로젝트 추가, 복제, 워크트리 사용 | 프로젝트와 작업 공간 |
| 요청에 파일을 넣고 승인 방식 선택 | 대화와 작업 진행 |
| 파일 편집, 터미널, 변경 검토와 되돌리기 | 파일·터미널·Git |
| 다른 앱에서 하던 작업 이어가기 | 대화 이어쓰기 |
| 다른 컴퓨터 또는 WSL에서 작업 | 실행 환경 연결 |
| 화면, 단축키, 데이터 위치, 업데이트 | 설정과 업데이트 |
| 연결이나 작업이 진행되지 않는 경우 | 문제 해결 |