From 9540b2375cb45cbb1109dcec7feff638955454f4 Mon Sep 17 00:00:00 2001 From: Jerry Chae Date: Tue, 26 May 2026 11:29:02 +0900 Subject: [PATCH] =?UTF-8?q?agy=20=EC=B6=94=EA=B0=80,=20pi=EB=A5=BC=20READM?= =?UTF-8?q?E=EC=97=90=EC=84=9C=20=EC=A0=9C=EA=B1=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 73 +++++++++++++++++++++++++------------------------ install-agy.ps1 | 61 +++++++++++++++++++++++++++++++++++++++++ install-agy.sh | 49 +++++++++++++++++++++++++++++++++ 3 files changed, 148 insertions(+), 35 deletions(-) create mode 100644 install-agy.ps1 create mode 100644 install-agy.sh diff --git a/README.md b/README.md index 7363700..8902d69 100644 --- a/README.md +++ b/README.md @@ -4,15 +4,26 @@ ## 지원 도구 +### 터미널 관리 - [tmux](https://github.com/tmux/tmux) - 터미널 멀티플렉서 -- [ttyd](https://github.com/tsl0922/ttyd) - 웹 기반 터미널 공유 유틸리티 + +### 모니터링 - [bottom](https://github.com/ClementTsang/bottom) - 호스트 모니터링 - [superfile](https://github.com/yorukot/superfile) - 터미널 파일 관리자 - [dua](https://github.com/byron/dua-cli) - 디스크 사용량 분석기 + +### 버전 관리 - [lazygit](https://github.com/jesseduffield/lazygit) - Git 터미널 UI + +### Docker 관련 - [Docker](https://www.docker.com/) - 컨테이너 플랫폼 (Linux 자동 설치, Mac/Windows는 안내) - [lazydocker](https://github.com/jesseduffield/lazydocker) / [ctop](https://github.com/bcicen/ctop) - 컨테이너 TUI (둘 중 하나 선택) + +### 파이썬 관련 - [uv](https://docs.astral.sh/uv/) - Python 패키지 관리자 + +### AI Agent 관련 +- [Antigravity CLI](https://antigravity.google) - 경량화 터미널 코딩 에이전트 CLI - [pi](https://pi.dev/) - CLI AI 코딩 어시스턴트 + 추천 패키지 일괄 설치 ## 설치 @@ -25,12 +36,6 @@ curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.sh?ref_type=heads" | bash ``` -**ttyd:** - -```bash -curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ttyd.sh?ref_type=heads" | bash -``` - **bottom:** ```bash @@ -92,6 +97,12 @@ curl -LsSf https://astral.sh/uv/install.sh | sh > source ~/.bashrc > ``` +**Antigravity CLI (agy):** + +```bash +curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.sh?ref_type=heads" | bash +``` + **pi (Pi Coding Agent + 추천 패키지):** ```bash @@ -106,12 +117,6 @@ curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-pi.s powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-tmux.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-tmux.ps1' -OutFile $t; & $t" ``` -**ttyd:** - -```powershell -powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-ttyd.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ttyd.ps1' -OutFile $t; & $t" -``` - **bottom:** ```powershell @@ -168,6 +173,12 @@ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | ie > [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User') > ``` +**Antigravity CLI (agy):** + +```powershell +powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-agy.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.ps1' -OutFile $t; & $t" +``` + **pi (Pi Coding Agent + 추천 패키지):** ```powershell @@ -206,28 +217,6 @@ tmux ls # 세션 목록 > `install-tmux` 스크립트는 `.tmux.conf`를 홈 디렉토리에 자동 배포합니다. 기존 파일이 있으면 백업 후 덮어씁니다. -### ttyd - -웹 브라우저를 통해 터미널을 접속할 수 있도록 해주는 유틸리티입니다. tmux 등과 연동하여 원격 모니터링/제어가 가능합니다. - -- **터미널 웹 공유** — 특정 포트를 통해 쉘(bash/zsh 등) 또는 명령어 실행 화면을 웹에 호스팅 -- **읽기 전용 모드** — 보안을 위해 웹 접속자가 터미널을 조작할 수 없도록 보기 전용 모드로 설정 가능 -- **인증 설정** — 웹 접속 시 사용자 이름과 비밀번호를 검증하도록 설정 가능 - -```bash -ttyd bash # 기본 bash 쉘을 웹(기본 포트 7681)에 호스팅 -ttyd tmux attach # 현재 실행 중인 tmux 세션을 웹에 연동 -ttyd -p 8080 zsh # 포트 8080을 사용하여 zsh 호스팅 -ttyd -c user:pass bash # 아이디/패스워드 로그인 설정 -``` - -| 옵션 | 설명 | -| --------------------- | ------------------------------------ | -| `-p, --port ` | 사용할 네트워크 포트 지정 (기본 7681)| -| `-i, --interface `| 바인딩할 네트워크 인터페이스 | -| `-c, --credential `| 웹 접속 인증용 사용자 계정 정보 | -| `-R, --readonly` | 접속자가 터미널을 입력할 수 없는 모드| - ### bottom 호스트 모니터링 터미널 UI 도구입니다. @@ -398,6 +387,20 @@ lazydocker | `x` | 컨테이너 제거 | | `[` `]` | 패널 간 이동 | +### Antigravity CLI + +Google Antigravity 2.0 플랫폼의 경량화 터미널 인터페이스입니다. 쉘 환경에 완벽히 연동되는 차세대 코딩 에이전트입니다. + +- **원활한 CLI 작업** — 로컬 프로젝트 디렉토리에서 터미널 기반 에이전트 작동 +- **Google 로그인 연동** — 첫 실행 시 보안인증(Google Sign-In) 자동 트리거 +- **스크립트 친화성** — CI/CD 파이프라인이나 스크립트에서 자동화 가능 + +```bash +agy # 대화형 에이전트 쉘 시작 +agy -p "요청사항" # 단일 프롬프트 실행 +agy --help # 도움말 및 사용법 표시 +``` + ### Pi Coding Agent CLI 기반 AI 코딩 어시스턴트입니다. `install-pi` 스크립트는 Pi 본체와 함께 다음 추천 패키지를 일괄 설치합니다. diff --git a/install-agy.ps1 b/install-agy.ps1 new file mode 100644 index 0000000..ef1a7f0 --- /dev/null +++ b/install-agy.ps1 @@ -0,0 +1,61 @@ +#Requires -Version 5.1 +<# +.SYNOPSIS + Google Antigravity 2.0 CLI (agy) 설치 스크립트. + +.DESCRIPTION + https://antigravity.google/cli/install.ps1 원격 파워쉘 스크립트를 + 보안이 설정된 환경에서 안전하게 가져와 실행하여 Antigravity CLI(agy.exe)를 설치합니다. + +.EXAMPLE + .\install-agy.ps1 + + # Windows 원라인 원격 실행 명령어: + powershell -ExecutionPolicy Bypass -c "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $t=\"$env:TEMP\install-agy.ps1\"; iwr -useb 'https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-agy.ps1' -OutFile $t; & $t" + +.NOTES + 실행 정책 에러가 발생하는 경우 다음 명령어로 해결할 수 있습니다: + Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser +#> + +[CmdletBinding()] +param() + +Set-StrictMode -Version Latest +$ErrorActionPreference = 'Stop' + +# HTTPS 통신을 위한 TLS 1.2 보안 프로토콜 설정 강제 +[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 + +# ──────────────────────────────────────────── +# 유틸리티 함수 정의 +# ──────────────────────────────────────────── +function Write-Info { param([string]$msg) Write-Host "[INFO] $msg" -ForegroundColor Cyan } +function Write-Warn { param([string]$msg) Write-Host "[WARN] $msg" -ForegroundColor Yellow } +function Write-Success { param([string]$msg) Write-Host "[OK] $msg" -ForegroundColor Green } +function Write-Err { param([string]$msg) Write-Host "[ERROR] $msg" -ForegroundColor Red; exit 1 } + +# ──────────────────────────────────────────── +# 상수 정의 +# ──────────────────────────────────────────── +$INSTALL_URL = "https://antigravity.google/cli/install.ps1" + +# ──────────────────────────────────────────── +# 메인 설치 프로세스 +# ──────────────────────────────────────────── +Write-Info "Google Antigravity 2.0 CLI (agy) 설치를 시작합니다..." +Write-Info "원격 설치 스크립트 가져오는 중: $INSTALL_URL" + +try { + # 원격 스크립트 다운로드 및 파이프(iex) 실행 + Invoke-RestMethod -Uri $INSTALL_URL -UseBasicParsing | Invoke-Expression + + Write-Host "" + Write-Host "==================================================" -ForegroundColor Green + Write-Success "Antigravity CLI 설치가 완료되었습니다!" + Write-Host "==================================================" -ForegroundColor Green + Write-Info "터미널 창을 다시 시작한 후 'agy' 명령어를 입력하여 실행하세요." + Write-Info "최초 가동 시 Google 계정 로그인 연동이 필요합니다." +} catch { + Write-Err "Antigravity CLI 설치 스크립트 실행 중 에러가 발생했습니다: $_" +} diff --git a/install-agy.sh b/install-agy.sh new file mode 100644 index 0000000..8af2885 --- /dev/null +++ b/install-agy.sh @@ -0,0 +1,49 @@ +#!/usr/bin/env bash +# shellcheck disable=SC2086 + +# Google Antigravity 2.0 CLI (agy) 설치 스크립트 +# Antigravity: https://antigravity.google +# +# 지원 플랫폼: +# macOS 및 Linux (공식 install.sh 실행) + +set -euo pipefail + +# ──────────────────────────────────────────── +# 상수 정의 +# ──────────────────────────────────────────── +INSTALL_URL="https://antigravity.google/cli/install.sh" + +# ──────────────────────────────────────────── +# 유틸리티 함수 (stderr 출력) +# ──────────────────────────────────────────── +info() { echo "[INFO] $*" >&2; } +warn() { echo "[WARN] $*" >&2; } +error() { echo "[ERROR] $*" >&2; exit 1; } +success() { echo "[OK] $*" >&2; } + +# ──────────────────────────────────────────── +# 필수 명령어 확인 +# ──────────────────────────────────────────── +for cmd in curl bash; do + command -v "$cmd" &>/dev/null || error "'$cmd' 명령어가 필요합니다." +done + +# ──────────────────────────────────────────── +# 메인 설치 로직 +# ──────────────────────────────────────────── +main() { + info "Google Antigravity 2.0 CLI (agy) 설치를 시작합니다..." + info "원격 설치 스크립트 가져오는 중: $INSTALL_URL" + + # 원격 스크립트 실행 + if curl -fsSL "$INSTALL_URL" | bash; then + success "Antigravity CLI 설치가 성공적으로 완료되었습니다!" + info "터미널에서 'agy' 명령어를 실행하여 서비스를 시작할 수 있습니다." + info "처음 실행 시 Google 계정 로그인 인증(Google Sign-In)이 진행됩니다." + else + error "Antigravity CLI 설치 스크립트 실행에 실패했습니다. 네트워크 연결 상태를 확인해 주세요." + fi +} + +main "$@"