Adnify: 코드를 위한 AI 네이티브 엔지니어링 워크스페이스

Adnify Logo

중국어 | English | 일본어 | 한국어 | Español | Français | Deutsch | Português (Brasil) | Русский

코드를 당신의 AI에 연결하세요.

직접 실행과 통제된 다중 에이전트 플래닝을 위한 AI 네이티브 엔지니어링 워크스페이스입니다.

Adnify는 코드 편집, AI 실행, 자산 생성(asset generation), 브라우저 검증(browser verification) 기능을 하나의 데스크톱 워크스페이스에 통합했습니다. Agent Mode를 사용하여 직접 구현하거나, Plan Mode를 사용하여 요구사항 명확화, 검토된 작업 그래프(reviewed task graphs), 의존성 인식 실행(dependency-aware execution), 결과 검증을 수행할 수 있습니다. 창 간의 명령 및 백그라운드 서비스를 관리하고, 시스템 알림 또는 자체 웹훅 리시버(webhook receiver)를 통해 작업 결과를 받을 수 있습니다.

"Adnify의 모든 코드 라인 뒤에는 우리 커뮤니티의 에너지 스파크가 있습니다!" ⚡️

아낌없이 지원해주신 후원자분들께 진심으로 감사드립니다. 여러분이 제공해주신 커피, 밀크티, 에너지 드링크 덕분에 Adnify는 계속 발전하고 있습니다! 이름은 특정 순서가 아닙니다. 오류나 누락된 부분이 있다면 저자에게 연락 주십시오.

Adnify 사용 및 개발에 대해 토론하려면 커뮤니티에 참여하세요!

💡 문제나 제안 사항은 Gitee Issues 또는 Github Issues에 제출해 주세요.

• 아키텍처 설계 (Architecture Design)
• 핵심 기능 (Core Features)
• 자산 생성 (Asset Generation)
• 브라우저 검증 (Browser Verification)
• 실행 관리 (Execution Management)
• 알림 및 백그라운드 작업 (Notifications & Background Tasks)
• Adnify가 다른 점 (What Makes Adnify Different)
• 빠른 시작 (Quick Start)
• 브랜드 자산 (Brand Assets)
• 기능 상세 정보 (Feature Details)
• 키보드 단축키 (Keyboard Shortcuts)
• 프로젝트 구조 (Project Structure)
• 기여 방법 (Contributing)

Adnify architecture diagram

Renderer UI

• src/renderer에 있는 React 컴포넌트들은 에디터, Agent surfaces, Plan Workbench, 터미널, 미리보기(previews), 사용자 인터페이스 상호작용 흐름을 담당합니다.

Agent Runtime

src/renderer/agent는 모델 라우팅, 컨텍스트 플로우, 도구 정책(tool policies), 승인(approvals), 예산(budgets), 복구(recovery)를 포함하여 Agent 및 Plan 작업 워커를 위한 공유 실행 커널을 제공합니다.

Plan Runtime

• Plan 영역은 UI와 독립적으로 요구사항, 작업 의존성, 실행 상태, 아티팩트, 유효성 검사, 히스토리를 모델링하며, 각 작업을 위해 동일한 검증된 Agent 커널을 재사용합니다.

상태 및 세션(State and Session)

• 렌더러 측 스토어(Renderer-side stores)는 UI 상태, 스레드, 체크포인트, 브랜치, 그리고 세션 생명주기(session lifecycle)를 관리합니다. 전용 세션 저장소 프로세스(session-storage process)가 SQLite 히스토리를 영속화하며, 핫/콜드 메시지 창은 UI에 로드되는 히스토리 양을 제한합니다.

프론트엔드 서비스(Frontend Services)

• 렌더러 내의 경량 클라이언트 서비스들은 터미널 UX, 자동 완성 기능(completions), 워크스페이스/세션 도우미, 그리고 Electron API로 교차하는 요청들을 조정합니다.

렌더러 워커(Renderer Workers)

• 브라우저 워커는 텍스트/diff 처리와 같은 계산 집약적인 렌더러 작업을 처리하며, Monaco 언어 워커는 에디터의 언어 기능을 UI 스레드에서 분리합니다.

Preload Bridge

src/main/preload.ts는 타입이 지정된 contextBridge 서피스를 노출하여 렌더러가 직접적인 Node 접근 없이 특권 기능에 액세스할 수 있도록 합니다.

IPC 핸들러(IPC Handlers)

src/main/ipc/*.ts는 렌더러 요청이 검증되고 메인 프로세스 기능으로 라우팅되는 계약 경계입니다.

공유 계약(Shared Contracts)

src/shared는 렌더러와 메인 코드 모두에서 사용되는 교차 프로세스 타입, 설정, 유틸리티 및 공유 오류 정의를 포함합니다.

메인 프로세스 서비스(Main Process Services)

src/main은 창/앱 생명주기, 파일 시스템 및 셸 권한, 명령어 스케줄링, LLM 및 MCP 백엔드, LSP 관리, 알림, 그리고 격리된 서비스의 조정을 담당합니다.

격리 서비스 프로세스(Isolated Service Processes)

• 코드 인덱싱(Code indexing), 세션 저장소(session storage), 에셋 저장소(asset storage), 콘텐츠 처리(content processing)는 필요에 따라 시작되는 Electron 유틸리티 프로세스에서 실행됩니다. 각 워크스페이스는 자체 윈도우와 공유하는 인덱스 서비스(index service)를 가지며, 파싱 및 SQLite 워커(worker)는 이 서비스 내부에서 실행됩니다. 자세한 내용은 프로세스 격리(Process Isolation)를 참고하세요.

프로세스 격리 (Process Isolation)

• 렌더러(renderer)는 사용자 경험(UX)과 오케스트레이션에 집중하는 반면, 메인 프로세스(main process)는 명시적인 IPC 경계 뒤에서 특권이 필요한 작업들을 포함합니다.

백그라운드 작업 (Background Work)

• 렌더러 워커는 UI 측 계산을 처리하고, 서비스 프로세스는 인덱싱, 데이터베이스, 임베딩(embeddings), 대규모 문서 파싱 등을 처리합니다. 서비스 시작(Service startup), 마감일(deadlines), 종료(shutdown), 복구(recovery)는 관리되는 라이프사이클(managed lifecycle)을 공유합니다.

운영 안전성 (Operational Safety)

• 프리로드 브릿지(preload bridge), 공유 계약(shared contracts), 메인 프로세스 보안 계층(main-process security layers)은 기능 노출 범위를 좁고 감사 가능하게 유지합니다.

• 다중 테마 지원 (Multi-Theme Support): 세심하게 디자인된 네 가지 내장 테마
  Adnify Dark

• 기본 다크 테마, 부드럽고 눈에 편안한 Midnight

• 짙은 자정의 파란색, 집중적인 코딩을 위한 Cyberpunk

• 네온 사이버펑크 스타일의 Dawn

• 밝은 주간 테마

• 글래스모피즘 디자인 (Glassmorphism Design): 미묘하게 빛나는 경계와 역동적인 그림자가 있는 전역 프로스티드 글래스(frosted glass) 스타일 -
  몰입형 레이아웃 (Immersive Layout): 프레임 없는 윈도우, Chrome 스타일의 탭, 브레드크럼 네비게이션

Adnify는 의도적으로 두 가지 모드를 노출합니다. 이전의 독립적인 채팅 모드(Chat mode)는 에이전트(Agent)에 통합되어, 질문, 조사, 구현을 하나의 연속적인 컨텍스트로 공유하며 사용자에게 대화와 액션 중 하나를 선택하도록 강요하지 않습니다.

• 에이전트 모드 🤖 — 직접 실행 (execute directly) - 질문하기, 코드베이스 검사, 파일 편집, 명령어 실행, 문서 검색 및 결과 확인을 하나의 스레드에서 수행합니다.
• 권한 인식 도구(Permission-aware tools), 체크포인트(checkpoints), 진단 기능(diagnostics), 루프 감지(loop detection) 및 복구 기능을 통해 자율적인 작업이 관찰 가능하고 되돌릴 수 있도록 합니다.
• 점진적 컨텍스트 압축(Progressive context compression)과 요약/인계 지원은 핵심 결정을 잃지 않으면서 장기 실행 작업을 처리합니다.

Plan Mode 🧠 — 실행 전에 작업 검토하기 - 네 단계의 워크벤치가 안내합니다: 요구사항 검토 → 계획 검토 → 실행 센터 → 결과 검토. - 플래너는 예상 아티팩트, 우선순위, 역할/모델 할당, 순차적 또는 병렬 실행 경로를 갖춘 의존성 인식 작업을 생성합니다. - 구조적 검사는 실행 전에 의존성 사이클, 누락된 전제 조건, 병렬 쓰기 충돌을 포착합니다. - 각 작업은 공유 에이전트 커널의 격리된 워커 스레드에서 실행됩니다. 진행 상황을 검사하고, 작업 스레드를 열고, 승인을 처리하며, 실행을 일시 중지/재개하고, 변경 사항을 요청하고, 최종 결과를 수락할 수 있습니다.

• 네 단계의 워크벤치가 안내합니다

워크스페이스 작업: 범위가 지정된 권한과 diff 미리보기를 통해 파일 읽기, 생성, 편집, 이동 및 삭제를 수행합니다.코드 인텔리전스: 텍스트/정규식 검색, LanceDB 시맨틱 검색, 심볼, 정의, 참조, 호버 정보 및 LSP(Language Server Protocol)를 통한 진단 기능을 제공합니다.터미널 실행: 포그라운드/백그라운드 명령어, 실시간 출력, 대화형 입력, 취소 및 신뢰할 수 있는 종료 코드 캡처를 지원합니다.연구 및 통합: 웹 검색, URL 읽기, MCP 도구/리소스/프롬프트 및 재사용 가능한 스킬을 활용합니다.스마트 컨텍스트 참조: 파일 언급 외에도 @codebase, @git, @terminal, @symbols, 그리고 @web을 사용할 수 있으며; 파일과 폴더도 스레드로 드래그할 수 있습니다.모델 자유도: OpenAI, Anthropic, Google, DeepSeek, Ollama 및 OpenAI 호환 제공업체 간 전환이 가능하며, 추론 제어(reasoning controls)와 제공업체별 옵션을 포함합니다.

사용자 서비스 연결: 설정(Settings) → 확장 기능(Extensions) → 에셋 기능(Asset Capabilities)에서 이미지, 비디오, 오디오 및 파일용 HTTP JSON API를 연결할 수 있습니다. API 문서를 기반으로 구성 초안을 생성하거나, 수동으로 편집하거나, JSON을 가져올 수 있습니다.작업 내에서 생성: 활성화된 기능은 참조 이미지 입력 등 서비스가 지원하는 경우 에이전트 도구(Agent tools)가 됩니다. 동기식 결과와 비동기 작업 모두를 지원하며, 재시작 후에도 보류 상태 확인이 복원됩니다.결과 미리 보기 및 재사용: 이미지를 확대하고, 출력물 간 전환하며, 비디오 및 오디오를 재생하고, 파일을 찾고, 대화에서 내보낼 수 있습니다. 에셋 라이브러리에서 저장된 결과와 참조 이미지 기록을 탐색할 수 있습니다.스토리지 제어: 전역 또는 프로젝트별 출력 디렉터리를 선택하고, 에셋을 다시 생성하지 않고도 실패한 다운로드를 재시도할 수 있습니다. 자격 증명은 안전한 스토리지에 사용되며 구성 내보내기에서 제외됩니다.

설정 및 API 예시는 에셋 기능(Asset Capabilities)을 참조하세요.

편집기에서 프론트엔드 변경 사항 확인: 에이전트는 개발 미리 보기 또는 HTTP(S) 페이지를 열고, DOM, 스타일, 레이아웃, 콘솔 및 네트워크 진단 기능을 검사하며, 구성된 비전 모델용 스크린샷을 캡처할 수 있습니다.페이지 상호 작용: 검증 작업의 일부로 클릭하고, 양식을 채우고, 키를 누르고, 스크롤하고, 탐색하며, 요소가 나타날 때까지 기다릴 수 있습니다.반응형 레이아웃 확인: 데스크톱, 휴대폰, 태블릿 보기 간에 전환할 수 있으며, 세로 및 가로 방향을 포함합니다. 장치 변경 시 페이지와 양식 입력이 유지되며, 미리 보기는 패널에 맞게 조정됩니다.프로젝트 세션 분리 유지: 각 프로젝트는 자체 창에서 공유되는 영구적인 브라우저 스토리지를 가집니다. 동일한 localhost 주소를 사용하더라도 다른 프로젝트들은 격리된 상태를 유지합니다.

장치 에뮬레이션은 Chromium을 사용합니다. 프로젝트별 세션으로 업그레이드한 후에는 각 프로젝트의 미리 보기에서 다시 로그인해야 합니다. 브라우저 미리 보기(Browser Preview)를 참조하세요.

창 간 통합 뷰(One view across windows): 터미널 패널 또는 설정(Settings) → 에디터(Editor)에서 실행 관리자(execution manager)를 열어 명령어, 백그라운드 서비스, 터미널 세션, 용량 사용량, 대기 이유, 종료 코드 등을 확인할 수 있습니다.작업 및 기록 관리: 예약된 명령을 취소하고, 실행 중인 작업을 중지하며, 로그를 확인하거나 내보내고, 보관된 출력을 고정하거나 삭제할 수 있습니다. 저장된 기록은 앱 재시작 후에도 계속 사용할 수 있습니다.개발 서비스 호스팅: 모든 창이 닫힌 후에도 로컬 백그라운드 서비스를 명시적으로 호스팅하여 사용 가능하게 유지하며, 시스템 트레이에서 제어합니다. Adnify를 종료하면 호스팅된 서비스가 중지되고, 재시작 시에는 서비스를 다시 시작하지 않고도 로그를 복원할 수 있습니다.리소스 제한 설정: 창 및 작업별로 동시성(concurrency)과 큐(queues)를 구성할 수 있으며, 출력(output), 디스크 로그(disk-log), 기록(history) 예산도 설정 가능합니다. 일반 명령어와 백그라운드 서비스는 별도의 예산을 가지며, 기록은 프로세스 슬롯을 소모하지 않습니다.선택된 유휴 세션 회수: 로컬 에이전트 터미널(Agent terminal)을 폐기 가능한(disposable) 상태로 표시하여 유휴 재활용을 허용합니다. 수동으로 제어되는, 점유된, 알 수 없는, 그리고 자식 세션을 가진 세션은 보호됩니다.

놓친 메시지 검토 (Review missed messages): 오른쪽 하단의 지속적인 메시지 센터는 에디터 메시지와 워크스페이스 작업 이벤트를 접근 가능하게 유지하며, 미확인 필터링, 읽음 표시, 전송 상태, 그리고 작업으로 돌아가는 링크를 제공합니다. 주의가 필요한 것 선택 (Choose what needs attention): 완료, 실패, 입력 요청, 승인, Plan 실행, 인덱싱, 자산에 대한 추천 알림, 작업 결과만 보기(task-results-only), 또는 선택된 이벤트를 사용합니다. 시스템 알림은 백그라운드 창 전용 전달을 지원하며 관련 대화방 열기 기능을 제공합니다. 결과를 도구로 전송 (Send results to your tools): 이벤트 필터, 헤더, JSON 메시지 템플릿 등을 사용하여 최대 다섯 개의 일반 웹훅 채널을 구성하고 배달 테스트를 할 수 있습니다. 메시지에는 이벤트 요약이 포함되며, 웹훅 구성은 암호화되어 일반 설정 내보내기에서 제외됩니다. 장기 실행 작업 추적 (Follow long-running work): 지원되는 경우 작업 표시줄 또는 Dock의 진행 상황이 Agent와 Plan 활동을 반영합니다. 선택적 절전 방지 기능이 작업 실행 중 적용되며, 기상 확인은 선택된 모델 엔드포인트 도달 가능성 및 기존 MCP 연결 상태를 보고합니다. 성능 조사 (Investigate performance): 프로세스 메모리 스냅샷을 내보내거나 설정(Settings) → 로그 및 진단(Logs & Diagnostics)에서 10초 트레이스를 캡처하여 리소스 사용량과 창 및 서비스 프로세스를 상호 연관 지어 분석합니다.

설정 세부 정보: 알림, 백그라운드 작업, 성능 진단.

스킬 (Skills): 마켓플레이스 또는 GitHub에서 설치하거나, 프로젝트/글로벌 명령어 패키지를 생성하고 자동으로 또는 명시적으로 로드할 수 있습니다. MCP: 필요한 경우 핫 리로드 및 OAuth 지원과 함께 npm, PyPI, Docker/OCI, Cargo, NuGet, MCPB, HTTP, SSE 서버를 검색하고 설치합니다. 크로스 에디터 마이그레이션 (Cross-editor migration): 수동으로 설정을 재구축하는 대신 Claude Desktop/Code, Codex, Cursor에서 호환되는 MCP 서버, 스킬(Skills), 및 규칙(Rules)을 검색하여 가져올 수 있습니다. 프로젝트 메모리 (Project memory): 승인 인식 쓰기 경로 뒤에 프로젝트별 관례와 지식을 유지합니다.**