SirAllap/agentglass

🛰 Every AI coding agent on your machine, on one screen — live cost, tokens and tool calls across every provider, and a hold on anything dangerous until you say go. From your desk or your phone.

What is agentglass?

agentglass 는 이미 당신의 머신에서 실행 중인 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI, OpenCode 등)의 터미널, 풀 리퀘스트 차이점, 브라우저 패널, 기타 리소스를 하나의 창에 통합하는 데스크톱 UI입니다. 기존의 tmux 세션에 연결하고, 모든 정보를 로컬 SQLite 파일에 저장하며, 안드로이드 동반 앱을 제공하고, 플러그인을 지원합니다. 사전 빌드된 바이너리(Linux, macOS, Windows, Android) 또는 소스에서 설치 가능합니다. macOS 빌드는 서명되지 않았습니다. 기본적으로 클라우드 연결이 없으며, 데이터를 외부로 전송하는 것은 선택적 웹훅 또는 "설명" 버튼만 가능합니다. 프로젝트는 활발히 유지보수 중이며, 게이트 제어, macOS 서명 등 향후 로드맵도 계획되어 있습니다.

Core ideas

Idea What it means
One unified workspace 에이전트 관련 UI(tmux 패널, git diff 뷰어, PR 패널, 브라우저, 승인)는 하나의 Electron/React 창 내에 통합됩니다.
Attach, don’t replace agentglass 는 이미 사용 중인 CLI를 시작합니다. 단지 tmux 세션에 연결할 뿐이며, UI를 닫아도 에이전트는 계속 실행됩니다.
Local-first & privacy-first 모든 데이터는 로컬 SQLite 파일에 저장됩니다. 클라우드 계정이나 텔레메트리가 필요 없습니다. 외부로 나가는 유일한 동작은 사용자가 설정한 선택적 웹훅과 선택한 차이점을 모델에 전송할 수 있는 "설명" 버튼입니다(기본적으로 비활성화).
Extensible via plugins 플러그인은 스코프가 지정되고 취소 가능한 토큰을 가진 별도 프로세스에서 실행되며, 앱 내 카탈로그에서 설치할 수 있습니다.
Mobile companion 안드로이드 앱은 QR 코드 스캔을 통해 데스크톱 인스턴스와 페어링되어, 모바일에서 승인, PR, 터미널 출력을 확인할 수 있습니다.

Main features

  • Agent management – 작업이나 GitHub 이슈에서 에이전트를 시작; 각각 git worktree, 브랜치, tmux 패널을 생성합니다.
  • Real tmux terminals – 실제 tmux 패널을 표시하고 제어 가능; make 타겟이나 npm 스크립트를 클릭하여 실행합니다.
  • Lantern status bar – 빨간색/노란색 인디케이터로 승인 게이트 대기 중이거나 입력을 기다리는 에이전트를 표시합니다.
  • Diff viewer – 에이전트/워크트리에 따라 단어 단위 변경을 그룹화; 직접 스테이징, 커밋, 스태시, 충돌 해결이 가능합니다.
  • Pull-request panel – 체크, 대화, 파일을 확인하고 브라우저를 열지 않고 인라인 리뷰를 작성할 수 있습니다.
  • Browser panel – 에이전트가 내장된 Chromium 뷰어를 제어할 수 있습니다. 이미 사용자 자격 증명으로 로그인되어 있습니다.
  • System view – Docker 컨테이너, 로그, 수신 대기 중인 포트, CPU/메모리, 세션별 비용 추적을 표시합니다.
  • Android companion – QR 코드 페어링을 통해 스마트폰에서도 동일한 패널과 승인을 확인할 수 있습니다.
  • Plugin system – 새로운 패널이나 통합을 추가 가능; 플러그인은 세밀한 토큰으로 사전에 제한된 환경에서 실행됩니다.

Installing & running

  1. 최신 릴리스에서 적절한 바이너리(AppImage, .deb, .dmg, .exe, .apk)를 다운로드합니다. 별도의 서버 프로세스는 필요 없습니다.
  2. macOS note – 서명되지 않은 빌드는 Gatekeeper가 차단합니다. 한 번만 xattr -dr com.apple.quarantine /Applications/agentglass.app 를 실행하세요.
  3. From source (Bun, Python 3, git, tmux, Claude Code CLI 필요):
    git clone https://github.com/SirAllap/agentglass && cd agentglass
bun install
AGENTGLASS_STATE_DIR=~/.local/state/agentglass-dev bun run dev   # UI는 http://localhost:4000
python3 hooks/install_hooks.py   # Claude Code 훅 등록
  4. 플랫폼별 전제 조건(예: git, tmux, GitHub CLI, Docker 등)은 docs/INSTALL.md 를 따르세요.

Platforms supported

OS Status Distribution format
Linux ✅ Working AppImage, .deb
macOS ✅ Working (unsigned) .dmg (Intel 및 Apple-silicon)
Windows 🧪 실제 하드웨어에서 검증되지 않음 (CI 통과) .exe
Android ✅ Working .apk (페어링된 컴패니언 앱)

Security & privacy

  • Data stays local – 모든 상태는 디스크 상의 단일 SQLite 파일에 저장됩니다.
  • No default outbound traffic – 외부로 나가는 유일한 기능은 다음 두 가지 선택 사항입니다:
    1. 사용자가 설정한 웹훅.
    2. "Explain" 버튼: 선택한 차이점을 언어 모델에 전송합니다.
  • Token-scoped plugins – 각 플러그인은 접근 범위를 제한하는 취소 가능한 토큰을 가진 별도 프로세스에서 실행됩니다.
  • 신뢰 모델, 보관 정책, 취약점 보고 방법은 SECURITY.md 를 참조하세요.

Extensibility

  • docs/EXTENDING.md 와 PLUGINS.md 를 따라 플러그인을 작성: 필요로 하는 HTTP API를 정의하고, 스코프가 지정된 토큰을 요청한 후 앱 내 카탈로그를 통해 배포합니다.
  • 아키텍처는 Bun/SQLite 백엔드, React/Vite UI, Electron 데스크톱 쉘, Claude Code 훅용 소규모 Python 포워더로 구성됩니다.

Roadmap highlights

  • Now: Lantern 기반 결론 스트립, macOS 서명/노타리제이션, 병렬 에이전트 충돌 경고.
  • Next: 규칙 기반 도구 게이트, 프로젝트별 게이트 정책, MCP 기반 코크피트 쿼리, Windows 하드웨어 검증.
  • Later: 단일 프롬프트 제출로 가능한 인라인 차이점 리뷰, 팀 엔드포인트용 API 패널, 의사결정 로그 마이닝, 음성 입력.

Community & contribution

  • GitHub에서 디스커션, 이슈 트래커, "help-wanted" 라벨이 활성화되어 있습니다.
  • 기여를 환영합니다. 프로젝트는 가볍게 유지하려고 하며(Bun, SQLite, React, Electron, React-Native, stdlib Python) 목표를 가지고 있습니다.
  • 라이선스: MIT (2026) + 번들된 아트워크에 대한 별도의 CC-BY-4.0 표시.

요약하면: agentglass 는 개인정보 보호를 우선시하는 로컬 실행형 UI로, 개발자가 AI 코딩 에이전트의 모든 워크플로우(터미널, PR 리뷰, 차이점, 브라우저 작업, 승인 등)를 하나의 확장 가능한 창 안에서 통합 관리할 수 있도록 합니다.

관련

  • 프로젝트
    LucieEveille/kiwi-mem

    kiwi‑mem은 LLM 채팅에 인간처럼 장기 기억을 추가하는 자체 호스팅 FastAPI 게이트웨이입니다. 사실은 PostgreSQL + pgvector에 저장되며, 시간이 지나면서 감소하는 열량을 부여하고, 매일 밤 "드림" 사이클을 통해 관련 정보를 통합하며, 오래된 채팅을 계층적 캘린더 요약으로 압축합니다. OpenAI 호환 또는 Anthropic 네이티브 API와 호환되며, 웹 관리 패널을 제공하고, 단일 Docker‑Compose 명령어로 실행됩니다.

  • 프로젝트
    PinelliaChill/Operant

    Operant is a local, extensible AI‑agent platform that lets a single user run multiple LLMs in coordinated workflows (planning, coding, reviewing, etc.). It offers safety‑first approvals, a versioned memory system for re‑using experience, plugin‑based tool extensions, and several interfaces (CLI, web UI, TUI, desktop). All state is stored locally and model calls go to any OpenAI‑compatible API you configure. The project is in beta (macOS arm64 & Ubuntu 24.04 validated) and is licensed for non‑commercial use only.

  • 프로젝트
    hermes-hq/hermes-ide

    Hermes IDE is a cross‑platform desktop app that lets you run multiple code‑generation agents (Claude, Codex, Copilot, etc.) side‑by‑side, each in its own real terminal and Git worktree. It provides inbox notifications, per‑turn diffs, a Review Desk for merging, and optional structured Claude‑view UI, all built with Tauri, React and Rust.

  • 프로젝트
    huisezhiyin/sdd-riper

    SDD‑RIPER Light는 LLM 기반 코딩 에이전트에 제어 플레인을 제공하는 경량이고 리포지토리 내재형 프레임워크입니다. 명확한 루프(목표 재제시, 최소 사양 생성, 인간 승인 대기, 실행, 증거로 검증, 결과 동기화)를 통해 코드를 안전하고 감사 가능하며 복구 가능한 방식으로 수정할 수 있습니다. 네 가지 모듈식 '스킬'(light, strict, codemap, new‑chat‑ready)로 일상 업무, 고위험 작업, 낯선 코드베이스, 인수인계에 대응합니다.