Easy Agent – 터미널 기반의 코딩 어시스턴트

무엇인가요 – Easy Agent는 TypeScript/Node.js로 작성된 오픈소스 명령줄 애플리케이션으로, 대규모 언어 모델(Claude, OpenAI, Gemini, Ollama 등)과 대화하고, 모델이 로컬 파일 시스템, 쉘, 웹, 또는 사용자 정의 플러그인에서 작동할 수 있도록 합니다. 이는 "Claude Code" 경험을 모방하지만, 완전히 터미널에서 작동하며 확장 가능하도록 설계되었습니다.

현재 상태 – 프로젝트는 36단계의 개발을 완료했으며, 릴리스 후보 버전입니다. 모든 핵심 기능, 단계별 튜토리얼, 패키징, 설치 스크립트, 문서가 준비되어 있으며, 남은 유일한 단계는 eagent 패키지의 npm 게시 및 게시된 바이너리가 제대로 작동하는지 확인하는 것입니다.

핵심 기능 (README에 기재됨)

LLM 통신 레이어 – Anthropic, OpenAI 호환, Gemini 및 로컬 Ollama 제공자와의 스트리밍 채팅.
터미널 UI – React‑Ink으로 구축된 인터랙티브한 REPL; 헤드리스 모드, JSON/NDJSON 출력, 이미지/스크린샷 입력도 지원.
도구 생태계 – 파일 읽기/쓰기, 다중 편집, glob/grep, Bash/PowerShell 실행, 웹 가져오기/검색, MCP(Model‑Control‑Protocol) 리소스.
권한 시스템 – 허용/요청/거부 규칙, Plan 모드(읽기 전용 계획), Auto 모드(분류기 기반 권한).
세션 관리 – 지속적 세션, 재개, 기록, 내보내기, 파일 체크포인트, 되돌리기, 토큰 예산 처리.
확장성 – 스킬, 사용자 정의 하위 에이전트, 훅, 플러그인, 커뮤니티 확장용 마켓플레이스.
멀티에이전트 협업 – 백그라운드 에이전트, 워크트리 격리, 조정된 작업을 위한 Agent Teams.
다중 모달 입력 – 이미지와 스크린샷을 모델에 전송할 수 있습니다.
패키징 – npm에서 단일 파일 ESM 번들로 배포; macOS/Linux용 설치 스크립트 제공.

빠른 시작 (README에서)

# Anthropic 토큰 설정 (또는 지원되는 다른 제공자 구성)
export ANTHROPIC_AUTH_TOKEN="your-token"

# 설치 없이 시도
npx --yes eagent@latest

# 또는 전역 설치
npm install -g --ignore-scripts eagent
 eagent   # REPL 시작

또한 제공된 설치 스크립트를 실행할 수 있습니다:

curl -fsSL https://raw.githubusercontent.com/ConardLi/easy-agent/main/install.sh | sh

설정은 ~/.easy-agent/settings.json (또는 프로젝트 로컬의 .easy-agent/settings.json)에 배치할 수 있습니다. OpenAI, Gemini, Ollama용 예제 프로파일은 README에 표시되어 있습니다.

일반적인 워크플로우 명령어

명령어	기능
`/help`	모든 REPL 명령어 목록
`/model …`	활성 모델/프로파일 전환
`/plan`	읽기 전용 계획 모드 진입
`/auto`	분류기 지원 권한 활성화
`/resume` / `/history`	저장된 세션 작업
`/rewind` / `/diff`	파일 변경 사항 확인 또는 되돌리기
`/plugin` / `/marketplace`	확장 기능 설치/관리
`-p "prompt"` (CLI)	헤드리스 모드에서 단일 프롬프트 실행, `--output-format json` 옵션도 가능

아키텍처 (설명됨)

터미널 UI
   ↓
QueryEngine (다중 터닝 오케스트레이션)
   ↓
Agentic Loop (사고 → 도구 → 관찰)
   ↓
도구 및 권한 강제
   ↓
프로바이더 API 어댑터 (스트리밍)

5개의 레이어는 소스맵을 포함하고, Node.js 외에 런타임 종속성이 없는 단일 npm 번들로 패키징되었습니다.

누구에게 적합한가요?

개발자 – 무거운 IDE 플러그인 없이 터미널 내에서 직접 LLM 기반 코딩 어시스턴트를 원하는 사람.
팀 – 커스텀 AI 보조 CLI 도구를 개발하는 사람. 시스템은 플러그인, 스킬, 하위 에이전트를 통해 확장되도록 설계됨.
연구자 또는 애호가 – 가벼운, 재현 가능한 환경에서 에이전트 루프, 도구 사용, 멀티에이전트 협업을 탐구하고 싶은 사람.

기여 방법 / 도움 요청

리포지토리 복제 후 npm install 실행, npm run dev로 핫리로딩 개발 빌드 실행.
npm run typecheck, npm run test:stage36 등의 제공된 스크립트를 실행하여 빌드 검증.
이슈는 수락되지만, 풀 리퀘스트는 아직 열려 있지 않음.
README에 문서 및 문제 해결 절차 포함.

라이선스 – MIT.

ConardLi/easy-agent

Easy Agent – 터미널 기반의 코딩 어시스턴트