Agenv — AI 에이전트를 구축, 실행 및 모니터링하기 위한 풀 IDE

Source: Dev.to

번역할 텍스트를 제공해 주시겠어요?
위에 있는 Source 라인만으로는 번역할 내용이 없습니다. 전체 내용(마크다운 형식 포함)을 알려주시면 한국어로 번역해 드리겠습니다.

개요

Agenv (에이전트 개발 환경)은 Claude, Gemini, Vertex 또는 CLI 기반 모델과 같은 AI 에이전트를 실행하고 모니터링하기 위해 특별히 제작된 완전 웹‑기반 IDE입니다. 하나의 작업 공간에서 다음을 할 수 있습니다:

• 분할 터미널 창에서 여러 에이전트를 나란히 실행
• 30개 이상의 언어에 대한 구문 강조와 함께 코드 편집
• 내장 Git 통합을 통한 스테이징, 차이 보기, 커밋
• 세션당 실시간 토큰 사용량 및 비용 추적
• 브라우저 충돌 및 재연결 후에도 지속되는 세션 유지

Agenv는 데스크톱 앱(Electron을 통해)으로도 사용하거나, 전화기를 포함한 모든 장치에서 접근 가능한 웹 서버로도 사용할 수 있습니다.

기능

• 분할 터미널 – 여러 에이전트를 동시에 실행하고 각각 고유한 지속적인 PTY 세션을 가집니다. Alt+1‑9 또는 탭 바로 전환하고, 파일을 터미널에 직접 끌어다 놓을 수 있습니다.
• 전체 기능 파일 편집기 – 구문 강조, 트리 뷰 탐색기, 빠른 파일 검색(Ctrl+P), 프로젝트 전체 텍스트 검색(Ctrl+T)을 제공합니다.
• Git 사이드바 – 파일을 스테이징하고, 차이를 확인하며, 커밋을 작성하고, IDE를 떠나지 않고 푸시할 수 있습니다.
• 세션 지속성 – 스크롤백 기록, 실행 중인 프로세스, 환경 상태가 브라우저 종료 후에도 유지됩니다; 데이터는 AES‑256‑GCM으로 암호화되어 저장됩니다.
• 비용 모니터링 – 실시간 토큰 사용량 및 에이전트 세션당 비용을 표시하고, 실행 중, 대기 중, 오류 상태에 대한 상태 표시기가 있습니다.
• 보안 – 데스크톱 모드는 로컬에서 실행되며 포트를 열지 않습니다; 웹 모드는 128비트 랜덤 토큰 인증, scrypt 해시 비밀번호, 속도 제한, CSP 헤더, AES‑256‑GCM 암호화를 사용합니다.
• 경량 아키텍처 – 순수 JavaScript 모듈(React/Vue 없음), 최소한의 의존성, 빠른 UI를 제공합니다.

설치

# Global install via npm
npm install -g @adibenmatdev/agenv

또는 설치하지 않고 실행:

npx @adibenmatdev/agenv

선택적인 데스크톱 앱 경험을 위해 Electron을 전역에 설치하세요:

npm install -g electron

빠른 시작

# Launch the environment (desktop app if Electron is installed, otherwise web mode)
agenv

# Force web mode (opens in browser, accessible from any device)
agenv --web

# Web mode on a custom port
agenv --web --port 8080

# Launch directly into an agent (example with Claude)
agenv run claude --model

사용법

여러 에이전트 실행

각 에이전트는 자체적인 영구 PTY 세션에서 실행됩니다. Alt+1‑9 또는 탭 바를 사용해 에이전트 간에 전환할 수 있습니다. 브라우저를 닫거나 노트북 전원을 끈 후에도 세션은 스크롤백 기록과 실행 중인 프로세스를 유지합니다.

파일 편집

내장 편집기는 30개 이상의 언어에 대한 구문 강조, 트리 뷰 파일 탐색기, 빠른 파일 검색(Ctrl+P), 그리고 프로젝트 전체 텍스트 검색(Ctrl+T)을 지원합니다. 터미널과 외부 편집기 사이를 전환할 필요가 없습니다.

Git 통합

사이드바에서 다음 작업을 할 수 있습니다:

• 파일 스테이징 및 언스테이징
• 차이점 보기
• 커밋 메시지 작성
• 원격 저장소에 푸시

IDE를 떠나지 않고도 대부분의 중간 세션 버전 관리 요구를 충족합니다.

세션 지속성 및 보안

• 모든 세션 데이터는 AES‑256‑GCM으로 암호화되어 저장됩니다.
• 데스크톱 모드는 로컬에서 실행되며 열려 있는 네트워크 포트가 없습니다.
• 웹 모드는 128‑비트 무작위 토큰을 인증에 사용하고, scrypt‑해시된 비밀번호, 속도 제한, 엄격한 CSP 헤더를 적용합니다.

비용 모니터링

실시간 토큰 사용량과 비용이 에이전트 세션별로 표시되어 예상치 못한 청구를 방지할 수 있습니다.

데스크톱 모드 vs. 웹 모드

# Desktop mode (default when Electron is available)
agenv

# Web mode – accessible from any device on your network
agenv --web --host 0.0.0.0

# Remote access via built‑in ngrok integration (enable from UI)
agenv --web

아키텍처

Agenv는 스택을 최소화합니다:

• express – HTTP 서버
• ws – WebSocket 통신
• @lydell/node-pty – 터미널 에뮬레이션
• qrcode-terminal – 모바일 접근을 위한 QR 코드 생성

프론트엔드는 순수 JavaScript 모듈로 구성되어 있으며, React, Vue 또는 빌드 단계가 필요하지 않습니다.

License & Links

• GitHub:
• npm package: @adibenmatdev/agenv
• License: Apache‑2.0

AI 에이전트를 사용해 개발하고 있다면, Agenv를 한 번 사용해 보세요. 이슈, 풀 리퀘스트, 그리고 스타 모두 환영합니다.