Skip to content

Releases

VAMP v0.1.4 — Local Hypervisors

Pre-release

Choose a tag to compare

@wayfarer6 wayfarer6 released this 16 Nov 01:57

VAMP v0.1.4

  • Generalize extension metadata from VirtualBox-only to local hypervisors (VirtualBox, KVM, Hyper-V).
  • Document responsible use, human-in-the-loop guidelines, and liability disclaimer.
  • Link companion VAMP Vault extension and unified VHD / guest setup guides.

vamp-vault v0.1.1

vamp-vault v0.1.1 Pre-release
Pre-release

Choose a tag to compare

@wayfarer6 wayfarer6 released this 16 Nov 01:16

Sidebar for the vault in VS Code, and the .kdbx file as a first-class object.

New sidebar

The VAMP Vault icon in the activity bar now opens two views.

  • Vault Status — lock state, database and volume presence, mounted volumes, resolved KeePassXC/VeraCrypt versions and the approval mode. Reads only files and CLI paths; each row is clickable (setup, create, reveal).
  • Credentials — the KeePassXC groups and entries as a tree. Locked, without a CLI, or without a database, it shows the single action that fixes that instead of an empty pane. Entry rows show the title and the username once read, with $(key), $(folder) and $(trash) icons.

Right-click an entry for Copy Username, Copy Password (Approval Required) and Show Entry Details. The password copy asks in a modal dialog, then clears the clipboard 30 seconds later if it still holds that value. Details never include the password.

New commands

  • VAMP Vault: Reveal .kdbx File in OS File Explorer
  • VAMP Vault: Export .kdbx Copy to...
  • VAMP Vault: Search Credentials (QuickPick over every entry)
  • VAMP Vault: Refresh, VAMP Vault: Unlock, Copy Username, Copy Password, Show Entry Details

View title buttons carry Refresh, Search, Lock/Unlock, Reveal and Export.

Behaviour

  • Usernames are read with keepassxc-cli show without -s, so no password ever passes through the sidebar; the first 200 entries are filled in the background.
  • Unlocking from the sidebar verifies the typed master password against the database before storing it; a rejected stored password is forgotten rather than retried silently.
  • Export writes an encrypted copy to a path you choose — same master password, so the copy is worth as much as the vault; the dialog says so.

Tests

npm test now builds the extension and runs both suites: the MCP/CLI smoke test (42 checks, including the tree model, the manifest and a tree built from a real database) and test/extension-host.mjs (18 checks, which loads the real extension.js against a stand-in vscode module and drives the views, copy with and without approval, details, reveal, export, search, lock and unlock). All passing on Linux x64 with KeePassXC 2.8.0 and the VeraCrypt CLI.

Install

Download vamp-vault-0.1.1.vsix below, then Extensions → … → Install from VSIX. VAMP (wayfarer6.vamp-mcp) is a declared dependency and must be installed first.

vamp-vault v0.1.0

vamp-vault v0.1.0 Pre-release
Pre-release

Choose a tag to compare

@wayfarer6 wayfarer6 released this 16 Nov 00:46

VAMP Vault는 AI 에이전트에게서 비밀번호와 인증서를 떼어 놓기 위한 VS Code 확장입니다. 자격증명은 로컬 KeePassXC 데이터베이스에, 인증서는 VeraCrypt 암호화 볼륨에 두고, 에이전트가 지금 하는 작업에 필요한 값 하나만 사용자 승인을 받아 건네줍니다. VAMP(VirtualBox MCP) 확장의 컴패니언이며 wayfarer6.vamp-mcp를 확장 의존성으로 요구합니다.

초기 0.1.0 프리뷰입니다. Linux에서 KeePassXC 처리와 VeraCrypt 볼륨 생성 경로를 실제 바이너리로 확인했지만, 마운트·Windows·macOS 경로는 이 환경에서 검증하지 못했습니다. README의 제한 사항을 함께 봐 주세요.

포함된 기능

  • KeePassXC·VeraCrypt MCP 도구 9개 — vault_create, vault_get_credential, vault_set_credential, vault_update_credential, vault_delete_credential, vault_list_credentials, vault_mount_volume, vault_unmount_volume, vault_status. 각 결과는 JSON이며 keepassxc_missing, vault_locked, approval_required, entry_not_found, volume_missing 같은 코드로 실패 이유를 구분합니다.
  • 운영체제별 자동 다운로더 — PATH와 기본 설치 경로를 먼저 찾아 이미 설치된 KeePassXC/VeraCrypt를 재사용하고, 없을 때만 공식 릴리스에서 플랫폼에 맞는 바이너리를 받습니다. Linux는 AppImage를 확장 저장소에 풀어 LD_LIBRARY_PATH를 설정한 런처를 만들고, Windows는 포터블 ZIP을 사용합니다. 받은 파일은 게시자의 SHA-256(.DIGEST, sha256sum.txt)과 대조해 일치할 때만 실행합니다.
  • 가상 USB식 암호화 볼륨 마운트 — VeraCrypt 볼륨을 폴더나 드라이브로 마운트해 NPKI 공인인증서 같은 인증서를 게스트 작업에 쓸 수 있게 합니다. PIM, 키 파일, 읽기 전용, 슬롯 지정을 지원하고, 비밀번호는 --stdin으로만 전달합니다.
  • 승인 게이트와 세션 캐시 — 비밀 조회는 VS Code 모달 대화상자로 승인합니다. 마스터 비밀번호는 VS Code secret storage에만 보관하고, 읽은 값은 기본 5분간만 MCP 서버 메모리에 남깁니다. 대화상자가 닿지 않는 환경에서는 confirm:true 없이는 값을 내주지 않습니다.
  • 명령 5개와 상태 표시줄 — CLI 설정, 볼트 생성, 상태 보기, 잠금(마스터 비밀번호 삭제), 안내 열기.

설치

  1. wayfarer6.vamp-mcp 0.1.3 이상을 먼저 설치합니다.
  2. vamp-vault-0.1.0.vsix를 내려받아 VS Code의 **Extensions → Install from VSIX…**로 설치합니다.
  3. VAMP Vault: Set Up KeePassXC & VeraCrypt CLI를 실행합니다.
  4. VAMP Vault: Create Vault로 마스터 비밀번호를 정하고, MCP 서버 관리에서 VAMP Vault를 시작합니다.

첨부파일

  • vamp-vault-0.1.0.vsix: VS Code 확장 패키지(약 491 KB). MCP 서버 번들, 런처용 모듈, 아이콘, 문서, 의존성 라이선스 고지를 포함합니다.
  • SHA256SUMS: VSIX 체크섬. 받은 폴더에서 sha256sum -c SHA256SUMS로 확인할 수 있습니다.
  • GitHub의 Source code ZIP/TAR.GZ: 릴리스 태그의 전체 소스와 테스트.

로드맵 — 게스트 VM 내부 패스키(WebAuthn)

KeePassXC 2.8은 이미 패스키를 저장하고 KeePassXC-Browser로 노출하지만, 그 패스키가 호스트에 있으면 에이전트와 같은 자리에 있는 셈입니다. 다음 단계는 인증자를 게스트 안으로 옮기는 것입니다.

  • VAMP의 게스트 설치가 끝난 뒤 사후 설치 훅(post-install hook) 이 게스트 내부에서 KeePassXC와 CLI를 배포판 저장소에서 설치하고, 게스트 브라우저에 KeePassXC-Browser를 정책으로 넣고, 네이티브 메시징 매니페스트를 등록합니다.
  • 호스트 볼트의 패스키 항목은 게스트 데이터베이스로 한 번 옮긴 뒤 내보낸 파일을 삭제하고, 게스트 데이터베이스의 잠금 해제는 게스트 화면에서 사용자가 직접 합니다. 패스키 개인키가 호스트 에이전트 프로세스로 넘어오지 않는 구조입니다.
  • 게스트를 다시 만들 때 재등록할 수 있도록 공개키와 복구 코드를 호스트 볼트에 남깁니다.
  • 이 기능은 0.1.0에 포함되지 않았습니다. 게스트 훅 프레임워크, VM 내부 네이티브 메시징, 관리형 브라우저 프로필 정책에 의존하므로 README 로드맵에 계획으로만 적어 두었습니다.

검증과 제한

  • MCP 서버를 실제 keepassxc-cli 2.8.0과 veracrypt 1.26.31에 붙여 27개 검사를 통과했습니다: 도구 목록, 볼트 생성과 덮어쓰기 거부, 항목 추가·조회·수정·삭제(휴지통 이동), 세션 캐시, 승인 대화상자 거부, 브리지 토큰 검증, 데이터베이스 원본에 평문 비밀번호가 없는지 확인까지 포함합니다.
  • 다운로드 경로는 KeePassXC AppImage를 실제로 받아 체크섬 검증·압축 해제·런처 실행까지 확인했습니다. VeraCrypt AppImage도 체크섬 검증까지 확인했지만, 이 검증 환경에 GTK 3가 없어 실행 단계는 확인하지 못했습니다(데스크톱 배포판에는 기본 포함).
  • VeraCrypt 마운트는 드라이버(FUSE)와 권한이 필요해 컨테이너에서 확인하지 못했습니다. 실패하면 이유와 함께 failed로 보고하도록 구현되어 있습니다.
  • Windows와 macOS는 포터블 바이너리를 배포하지 않으므로 설치 프로그램 또는 패키지 관리자(winget, brew) 안내를 반환합니다. VeraCrypt CLI는 서명된 설치 프로그램이 등록하는 커널 드라이버를 쓰기 때문에 관리자 권한 없이는 동작하지 않습니다.
  • TOTP는 읽기만 지원합니다. keepassxc-cli가 시드 쓰기를 지원하지 않아 otpauth:// 등록은 KeePassXC 응용 프로그램에서 해야 합니다. PIM은 항목의 사용자 지정 특성에서 읽습니다.

README · 소스 · VAMP 문서

VAMP v0.1.3 — Preview

Pre-release

Choose a tag to compare

@wayfarer6 wayfarer6 released this 15 Nov 16:26

로컬 VM 샌드박스에서 OCR·UI 인식과 Robot/Python RPA를 연결하는 VAMP의 첫 GitHub 프리뷰 릴리스입니다. 반복적인 GUI 작업을 로컬 RPA로 실행해 AI 에이전트의 토큰 비용을 줄이는 것이 개발 목적입니다.

하루 동안 사용자와 Codex가 바이브 코딩으로 만든 초기 버전으로, 완성도·안정성·예외 처리·문서에 부족한 점이 많습니다. 현재 시험한 가상화 환경은 KVM/SPICE와 VirtualBox 정도이며, Hyper-V는 실험적·미검증입니다.

포함된 기능

  • VirtualBox MCP 19개 도구와 VS Code 확장: VM 조회·기동, 화면 캡처, 키보드·마우스 입력, 녹화·실행 이력 조회.
  • Robot/Python RPA와 별도 SPICE/KVM·YOLO/OCR 구성.
  • 선택적 게스트 GUI 레코더, 공유 소스 검사, 명시적 스냅샷 도구.

0.1.3 정리 사항

  • 메인 README를 소개·개발 동기·Mermaid 구조도·빠른 시작 중심으로 축약.
  • 상세 실행법과 영상 재현 절차를 docs로 이동하고 문서 목차 추가.
  • Marketplace 설명과 검증 범위를 정리하고 저장소 주소를 wayfarer6/vamp-mcp로 통일.
  • 아이콘을 242 KB로 축소하고 빌드 시 1024 KB 제한 검사.

설치와 첨부파일

vamp-mcp-0.1.3.vsix를 다운로드한 뒤 VS Code의 **Extensions → Install from VSIX…**로 설치하세요. 호스트에 VirtualBox 7.x와 Python 3.11+가 필요합니다. 설치 후 VAMP: Set Up Python Environment를 실행하세요.

  • vamp-mcp-0.1.3.vsix: VS Code 확장 패키지. YOLO/PaddleOCR와 SPICE/Hyper-V는 별도 구성입니다.
  • SHA256SUMS: VSIX 체크섬. 다운로드 폴더에서 sha256sum -c SHA256SUMS로 확인할 수 있습니다.
  • GitHub의 Source code ZIP/TAR.GZ: 릴리스 태그의 전체 소스와 문서.

새 VM의 공개 테스트 계정은 vboxuser / password123!입니다. Windows 라이선스는 사용자가 준비해야 하며, 설치 시작은 설치 완료를 뜻하지 않습니다.

검증과 제한

이번 문서·패키징 변경 후 MCP 프로토콜 테스트 3개와 VSIX 무결성·버전·아이콘 크기·문서 링크를 확인했습니다. 기존 전체 검증 기록에는 Python 63개와 상류 어댑터 101개 통과 결과가 있습니다. 새 OS 무인 설치 완료, 스냅샷 복원과 다양한 호스트·가속기 조합은 추가 검증이 필요합니다.

사용법과 문서 · 실행 영상 · 상세 검증

Marketplace의 기존 0.1.2 업로드는 그대로이며, 새 설명을 반영하려면 이 VSIX를 새 버전으로 업로드해야 합니다.