AgentEd 1.0.0은 YAML 프런트매터 편집과 실시간 토큰 추정 기능을 제공하는 시각적 마크다운 편집기다. Windows x64와 Apple Silicon 맥에서 사용할 수 있으며, Linux x86-64용 패키지는 실험 단계다. 일반 .md 파일을 원하는 폴더에서 열고 저장하며 계정이나 보관소 설정 없이 쓸 수 있다.

AgentEd는 무료 오픈소스 프로그램으로, 제작자는 자체 네트워크 호출이나 텔레메트리, 내장 클라우드 서비스를 제공하지 않는다고 설명한다. 다만 Windows에서는 기반 웹 런타임이 독립적으로 일부 연결을 할 수 있으며, 관련 조건은 SECURITY.md에 적혀 있다. 프로그램에 AI 채팅이나 에이전트 실행 기능은 없고, AI 도구에 사용할 문서를 준비하는 데 초점을 둔다.

  • 다운로드와 릴리스 정보는 GitHub 릴리스 페이지에서 확인할 수 있다. 설치 안내도 제공한다.
  • Windows 설치 파일은 5MB 미만이다. 이는 내려받는 설치 파일 크기이며, 설치 후 전체 용량이나 필요한 런타임 크기를 뜻하지 않는다.
  • 토큰 수는 오프라인에서 gpt-tokenizer의 cl100k_base를 이용해 추정한다. 다른 모델이나 채팅 형식, 첨부 파일을 사용하면 실제 합계가 달라질 수 있다.

편집 기능과 사용 대상

AgentEd는 제목, 목록, 체크리스트, 링크, 표를 시각적으로 편집하고, 입력 중 결과를 확인할 수 있게 한다. 떠 있는 도구 모음과 마크다운 입력 단축키를 제공하며, 메뉴에서 표의 행과 열을 추가하거나 삭제할 수 있다. 문서를 읽기용 서식으로 열 수 있고, 편집하려면 입력을 시작하면 된다.

일반 .md 파일을 사용하며 저장 시점을 사용자가 선택한다. 파일이 디스크에서 바뀌면 다시 불러오기, 덮어쓰기, 다른 위치에 저장하기 중 선택할 수 있다. 형식 관련 예외는 REQUIREMENTS.md에 정리돼 있다. 이미지는 문서 옆의 로컬 assets/ 폴더에 붙여넣거나 끌어놓거나 삽입할 수 있고, 접근성을 위한 이미지 설명도 추가할 수 있다. 이미지가 포함된 문서를 공유할 때는 이미지가 계속 표시되도록 참조된 assets/ 폴더도 함께 보내야 한다.

코드 블록은 언어를 선택하고 Copy 버튼으로 복사할 수 있으며, 줄 바꿈을 적용하는 일반 텍스트 블록도 지원한다. 각주 참조와 메모를 함께 삽입하고 참조 위에 마우스를 올려 메모를 읽을 수 있다. 메타데이터 패널에서 YAML 프런트매터를 편집하고, 빈 문서나 메타데이터가 있는 문서로 시작할 수 있다.

그 밖에 단어·문자 수와 토큰 추정치 표시, 대소문자·전체 단어·정규식 조건을 지정하는 찾기 및 바꾸기, 문서 주변 파일 구조를 보여주는 파일 패널을 제공한다. 화면은 밝게, 어둡게, 자동으로 설정하거나 준비된 색상 팔레트 중에서 고를 수 있다. 창마다 문서 하나를 열어 여러 창에서 작업할 수 있으며, 맞춤법 검사는 선택 기능이고 기본값은 꺼짐이다.

이 편집기는 재사용할 AI 지침과 프로젝트 맥락, 목표, 선호 사항, 경계를 마크다운과 YAML 메타데이터로 정리하려는 사람이나 일반 메모·지식 문서를 관리하는 사람을 대상으로 한다. 텍스트와 이미지, 표를 한 문서에 함께 넣을 수도 있다.

다운로드와 설치 조건

버전 1.0.0의 배포 대상과 상태는 다음과 같다.

플랫폼설치 파일상태
Windows x64AgentEd_1.0.0_x64-setup.exe정식 배포
macOS, Apple SiliconAgentEd_1.0.0_aarch64.dmg정식 배포
Linux x86-64AgentEd_1.0.0_amd64.deb실험 단계

Windows가 주 개발·테스트 플랫폼이다. macOS 빌드는 Apple Silicon용이며 Intel 기반 맥은 지원하지 않는다. Linux 패키지는 Ubuntu 24.04의 GNOME과 Wayland 환경에서 테스트됐다. Linux 지원은 실험 단계로, 다른 배포판에서는 테스트하지 않았다.

설치 파일은 공식 릴리스에서 내려받고 파일 이름과 버전을 확인한다. 릴리스마다 SHA-256 체크섬이 제공돼 내려받은 파일이 게시된 파일과 일치하는지 확인할 수 있다. 체크섬이 일치하더라도 소프트웨어가 안전하다는 사실까지 입증되는 것은 아니다. 보안 소프트웨어가 구체적인 위협을 탐지하면 진행을 중단하고 정확한 경고 문구와 릴리스 버전을 신고해야 한다. 아래 안내는 인식되지 않거나 검증되지 않은 앱에 대한 경고에만 적용된다.

설치 순서는 플랫폼에 맞는 설치 파일을 내려받고 설치한 뒤, 기존 마크다운 파일을 열거나 새 문서를 만들어 컴퓨터의 폴더에 저장하는 방식이다. Windows 설치 파일은 디지털 서명을 받지 않았고 macOS 앱은 Apple 공증을 받지 않았다. 설치 또는 첫 실행 때 보안 경고가 나타날 수 있다.

Windows

AgentEd_1.0.0_x64-setup.exe를 실행한다. Microsoft Defender SmartScreen에 ‘Windows에서 PC를 보호했습니다’라는 경고가 표시되고, 출처를 확인한 뒤 계속하기로 결정했다면 해당 옵션이 있을 경우 ‘자세한 정보’에서 ‘실행’을 선택할 수 있다.

별도의 Windows 권한 요청 창(UAC)에 ‘알 수 없는 게시자’가 표시될 수도 있다. 이는 SmartScreen 대화상자가 아니며 같은 버튼을 제공하지 않는다. Windows가 게시자의 신원을 확인할 수 없다는 뜻이다. 관리되는 컴퓨터나 다른 Windows 보안 설정 때문에 설치가 차단될 수도 있다. 설치를 진행하려고 백신 보호나 SmartScreen을 끄지 않는다.

코드 서명은 향후 릴리스에서 계획하고 있다. 그림이 포함된 안내는 설치 가이드에서 볼 수 있다.

macOS

macOS 빌드는 M1 이상 Apple Silicon 맥용이며 Intel 맥에서는 지원하지 않는다. Apple 공증을 받지 않아 첫 실행 때 macOS가 앱을 차단한다. 이 안내는 AgentEd 1.0.0을 macOS 26.6과 27에서 확인한 절차다.

AgentEd_1.0.0_aarch64.dmg를 열어 AgentEd를 Applications로 끌어놓는다. 디스크 이미지가 아니라 Applications에서 실행한다. macOS가 앱을 확인할 수 없어 ‘AgentEd가 열리지 않음’이라고 표시하면 ‘완료’를 누른다. 시스템 설정의 개인정보 보호 및 보안으로 이동해 보안 항목까지 내려간 뒤, AgentEd가 차단됐다는 메시지에서 ‘그래도 열기’를 선택한다.

다음 대화상자에서도 ‘그래도 열기’를 누른다. 앱을 삭제하는 강조 표시 버튼인 ‘휴지통으로 이동’은 선택하지 않는다. 암호를 입력하면 승인 후에는 이 설치본에서 같은 절차를 반복하지 않고 앱을 열 수 있다. AgentEd를 교체하거나 다시 설치하면 macOS가 매번 다시 확인을 요구하며 절차도 동일하다. ‘그래도 열기’ 옵션은 차단 시도 뒤 약 한 시간 동안 사용할 수 있다.

이 안내는 검증되지 않은 앱 경고에만 적용되며, 악성코드를 탐지했거나 컴퓨터에 피해를 줄 수 있다는 경고에는 적용되지 않는다. Finder에서 연 문서는 각각 별도 창으로 열린다. 파일 → 새 창 또는 Cmd+Shift+N으로 빈 창을 열 수 있다. 그림이 포함된 절차는 설치 가이드에서 확인할 수 있다.

Linux

Linux 빌드는 실험 단계다. VirtualBox 가상 머신에서 3D 가속을 끈 Ubuntu 24.04의 GNOME과 Wayland 환경으로만 테스트했으며, 다른 배포판에서는 시험하지 않았다. .deb 패키지는 x86-64 시스템용이며 glibc 2.34 이상과 WebKitGTK 4.1이 필요하다. APT는 선언된 의존성을 확인하고, 설정된 저장소에서 구할 수 있는 누락 패키지를 설치한다.

패키지를 내려받아 SHA-256 체크섬을 확인한 다음 패키지가 있는 폴더에서 실행한다.

sh
sudo apt install ./AgentEd_1.0.0_amd64.deb

설치 후 AgentEd가 애플리케이션 목록에 나타난다. 테스트한 기본 Ubuntu 환경에서는 마크다운 파일을 여는 기본 앱으로도 설정된다. Files의 ‘다른 프로그램으로 열기’를 사용해 다른 앱을 선택할 수 있다. 여는 파일마다 별도 창이 만들어지며 .txt처럼 지원하지 않는 파일 형식은 열 수 없는 이유를 설명한다.

삭제할 때는 다음 명령을 실행한다.

sh
sudo apt remove agent-ed

문서는 삭제되지 않는다. AgentEd 설정은 다음 위치에 남으며, 설정까지 지우려면 해당 폴더를 별도로 삭제할 수 있다.

text
~/.local/share/com.agentedapp.editor
~/.config/com.agentedapp.editor

단축키

Windows와 macOS에서 공통으로 쓰는 기능은 아래와 같다. Windows 단축키는 왼쪽, macOS 단축키는 오른쪽에 표시했다.

  • 굵게·기울임·밑줄: Ctrl+B / Ctrl+I / Ctrl+U · Cmd+B / Cmd+I / Cmd+U
  • 링크 삽입 또는 커서 위치의 링크 편집·삭제: Ctrl+K · Cmd+K
  • 시스템 브라우저에서 링크 열기: Ctrl+클릭 · Cmd+클릭
  • 인라인 코드: Ctrl+E · Cmd+E
  • 코드 블록: Ctrl+Shift+K · Cmd+Shift+K
  • 제목 수준 1~6: Ctrl+Alt+1 … Ctrl+Alt+6 · Cmd+Option+1 … Cmd+Option+6
  • 본문 텍스트: Ctrl+Alt+0 · Cmd+Option+0
  • 취소선: Ctrl+Shift+S · Cmd+Shift+S
  • 실행 취소·다시 실행: Ctrl+Z / Ctrl+Y · Cmd+Z / Cmd+Shift+Z 또는 Cmd+Y
  • 모두 선택: Ctrl+A · Cmd+A
  • 저장: Ctrl+S · Cmd+S. 다른 이름으로 저장은 파일 메뉴에서 선택한다.
  • 열기: Ctrl+O · Cmd+O
  • 마크다운으로 해석해 붙여넣기·일반 텍스트로 붙여넣기: Ctrl+V / Ctrl+Shift+V · Cmd+V / Cmd+Shift+V
  • 찾기·바꾸기: Ctrl+F / Ctrl+H · Cmd+F / Cmd+Option+F
  • 각주 삽입: Ctrl+Alt+F · Cmd+Option+R
  • 파일 패널 열기·닫기: Ctrl+Shift+E · Cmd+Shift+E
  • 다음 찾기·이전 찾기: F3 / Shift+F3 · Fn+F3 / Fn+Shift+F3
  • 문단 안에서 줄 바꿈: Shift+Enter · Shift+Enter
  • 목록 들여쓰기·내어쓰기, 표 셀 이동: Tab / Shift+Tab · Tab / Shift+Tab

macOS에서 Cmd+H는 바꾸기가 아니라 AgentEd를 숨긴다.

알려진 제한과 프로젝트 상태

이번 릴리스의 제한 사항은 다음과 같다.

  • 문단 안에서 줄을 바꾸려면 Shift+Enter를 사용한다. 도구 모음이나 메뉴에는 이 기능이 없다.
  • 파일이 ---로 시작하고 뒤에 같은 구분선이 다시 나오면 AgentEd는 그 사이 내용을 메타데이터로 해석한다. 따라서 손으로 만들었거나 다른 도구에서 만든 일부 파일은 잘못 표시될 수 있다. 닫는 구분선이 코드 블록 안에 있는 경우도 포함된다. 자세한 예외는 REQUIREMENTS.md에 있다.
  • Windows에서 마우스 오른쪽 버튼 메뉴의 ‘일반 텍스트로 붙여넣기’는 일반 붙여넣기처럼 동작한다. 서식 없는 텍스트를 그대로 붙이려면 Ctrl+Shift+V를 사용한다.
  • 맞춤법 검사는 한 번에 한 언어만 지원한다. Windows에서는 사전이 있는 첫 번째 기본 설정 언어를 사용하고, 해당 사전이 없으면 Windows 표시 언어로 대체한다. 기본 설정 언어 목록의 변경은 AgentEd의 모든 창을 닫고 앱을 다시 시작한 뒤 적용된다.
  • Linux 테스트는 3D 가속을 끈 가상 머신의 Ubuntu 24.04, GNOME, Wayland로 제한됐다. 다른 배포판과 데스크톱 환경, X11, 3D 가속을 켠 환경은 테스트하지 않았다. .rpm 패키지는 제공하지 않는다.
  • 삽입 → 메타데이터로 메타데이터를 넣는 작업은 실행 취소 기록에 포함되지 않는다. 패널에서 모든 필드를 삭제하면 메타데이터 블록도 제거된다.

형식 처리 방식과 예외는 REQUIREMENTS.md에 더 자세히 설명돼 있다. AgentEd는 활발히 개발 중이며 1.0 계열은 로컬 마크다운 파일을 시각적으로 편집하는 데 초점을 둔다. Windows와 macOS용 릴리스가 나왔고 Windows가 주 개발·테스트 플랫폼이다. Linux 빌드는 계속 실험 단계다.

소스 빌드와 기여

권장 Node.js 버전은 24이며 CI에서도 사용한다. 허용 버위는 저장소의 package.json에 있는 engines 필드에서 확인할 수 있다. rustup으로 설치할 수 있는 Rust 툴체인과 Tauri 플랫폼 사전 요구 사항도 필요하다.

sh
git clone https://github.com/cgxopen/AgentEd.git
cd AgentEd
npm install
npm run tauri dev

Tauri CLI는 프로젝트 개발 의존성에 포함돼 있다. 배포용 빌드는 다음 명령으로 수행한다.

sh
npm run tauri build

풀 리퀘스트를 열기 전에는 검증 체크리스트에 따라 린터, 타입 검사, 테스트, 웹 빌드를 실행해야 한다. 기여는 환영하며 먼저 CONTRIBUTING.md를 읽어야 한다. 큰 변경은 작업을 시작하기 전에 이슈를 열어 방향을 논의하도록 안내한다. 저장소의 코드와 문서, 커밋, 풀 리퀘스트, 이슈는 모두 영어로 작성된다.

AgentEd는 한 사람이 만든 무료 오픈소스 프로그램이며 MIT 라이선스를 따른다. 라이선스는 코드에 적용되며 AgentEd 이름과 로고에는 적용되지 않는다. 포크는 가능하지만 별도 이름을 사용해야 한다. 제작자는 카탈린 바실레(Cătălin Vasile)이며 Claude Code를 사용해 만들었다. 버그 신고와 기능 요청은 이슈 페이지에서 받는다. 보안 취약점은 공개 이슈를 여는 대신 SECURITY.md의 절차를 따라야 한다. 라이선스 전문은 LICENSE에서 확인할 수 있다.

AgentEd는 2026년 3월 29일 시작됐으며, 저장소는 2026년 8월 새로운 단계에 들어섰다.