Apargon은 macOS와 Linux에서 별도 설치나 서버 없이 HTML 파일을 데스크톱 앱처럼 실행하는 프로그램이다. 권한을 요청하는 파일은 실행 전에 허용 항목을 표시하며, 코딩 에이전트로 앱 파일을 만들 수도 있다.

Apargon에서 사용하는 .papp 파일은 추가 <meta> 태그가 포함된 HTML 파일이다. 파일을 두 번 클릭하면 격리된 창에서 열린다. 태그가 지정하지 않은 기능은 차단되며, 폴더 읽기·파일 수정·네트워크 접속·프로그램 실행 등의 권한을 요청할 수 있다.

설치와 실행

설치 방법은 Apargon 저장소에 안내돼 있다. 설치 스크립트는 macOS에서 앱의 공증 여부를 확인하고, Linux에서는 .deb 파일을 릴리스의 SHA256SUMS와 대조한 뒤 설치한다.

macOS 또는 Ubuntu 24.04에서는 다음 명령으로 설치할 수 있다. 에이전트용 papp 스킬을 설치하지 않으려면 명령에 sh -s -- --no-skill을 붙인다.

sh
curl -fsSL https://apargon.com/install.sh | sh

최신 릴리스에서 macOS용 .dmg(arm64 또는 x64)이나 Ubuntu 24.04용 .deb를 내려받을 수도 있다. Windows는 아직 지원하지 않는다. macOS에서는 Homebrew로도 설치할 수 있다.

sh
brew trust --cask orcaryn/tap/apargon
brew install --cask orcaryn/tap/apargon

설치한 뒤 .papp 파일을 두 번 클릭하거나, macOS에서는 open page.papp, Linux에서는 apargon page.papp을 실행한다. 처음 실행할 때 Apargon은 에이전트가 앱을 만들 수 있도록 papp 스킬을 설치할지 묻는다. 하루 한 번 GitHub에서 새 버전을 확인하며, Permissions → Check for Updates Automatically에서 자동 확인을 끌 수 있다. 이 기능을 끄면 보안 업데이트를 위해 저장소의 릴리스를 직접 확인해야 한다.

권한과 보안

태그가 없는 페이지는 자기 폴더만 볼 수 있다. 페이지가 더 많은 권한을 요청하면 실행 전에 팝업에 표시된다. 팝업에서 빨간색으로 표시된 항목은 체크해야 허용되며, Permissions → Approved Pages에서 이전 승인을 취소할 수 있다.

papp-node 태그로 전체 Node.js 기능을 허용한 페이지는 네트워크만 차단된 상태로 사용자 권한으로 실행된다. Apargon은 이런 페이지를 신뢰할 때만 열라고 안내한다. 앱이 강제하는 보안 규칙과 강제하지 않는 항목은 SECURITY.md에 정리돼 있다.

코딩 에이전트로 앱을 만들려면 papp 스킬을 제공하면 된다. 설치에 동의하면 Apargon이 스킬을 ~/.claude/skills/papp/와 ~/.agents/skills/papp/에 설치한다. 또는 Apargon 없이 다음 명령으로 직접 설치할 수 있다.

sh
for dir in ~/.claude/skills/papp ~/.agents/skills/papp; do
 mkdir -p "$dir"
 curl -fsSL https://apargon.com/.well-known/agent-skills/papp/SKILL.md -o "$dir/SKILL.md"
done

스킬을 설치한 뒤에는 예를 들어 “~/notes의 Markdown 메모를 보여주고 수정할 수 있는 papp을 만들어줘”라고 요청할 수 있다.