taracodlabs/aiden

Aiden — Autonomous AI agent that operates your computer with prompts: browser control, terminal execution, workflows, tools, recovery systems, and persistent memory. Built solo. AGPL-3.0.

Aiden – 자율형 AI 작업 엔진

무엇인가요 – Aiden은 오픈소스 기반의 Node 기반 AI 에이전트로, 고수준의 목표(예: "이 리포지토리의 실패하는 테스트를 수정하라" 또는 "주제를 조사하고 보고서를 작성하라")를 받아 사용자의 컴퓨터에서 전체 워크플로우를 수행할 수 있습니다. 계획을 세우고 명령어를 실행하며 브라우저와 상호작용하고 API를 호출하며 파일과 Git 저장소를 조작한 후, 작업이 성공했음을 검증 가능한 증거를 생성합니다. 모든 작업은 TUI/CLI를 통해 이루어지며, 위험한 단계에 대한 승인, 예산 설정, 수행 내역의 지속 가능한 로그를 확인할 수 있습니다.

왜 중요한가요 – 대부분의 채팅 기반 도구는 조언을 제공하는 데 그칩니다. Aiden은 "무엇을 해야 할까요?" 와 "제가 해드릴게요" 사이의 간극을 메우며, 사용자가 제어권을 유지하고 감사 로그를 제공합니다. 이는 개발 및 자동화 환경에 어떤 곳에도 통합할 수 있는 일반 목적의 "작업자"로 설계되었습니다.

핵심 기능

기능	기능 설명
목표에서 실행까지	자연어로 입력된 목표를 받아 다단계 계획을 생성하고 OS, 터미널, 브라우저, API, 버전 관리 시스템에서 실행합니다.
지속 가능한 상태 및 증거	모든 작업이 Job → Attempt → Effect → Evidence → Verification → Proof 체인으로 SQLite에 기록되어, 충돌 후 재시작이 가능하고 나중에 결과를 검증할 수 있습니다.
위험 수준 기반 승인	파괴적인 작업(예: 코드 커밋, 네트워크 요청) 전에 명시적인 승인이 필요한 신뢰 수준(관찰자/보조자/파트너)을 설정할 수 있습니다.
다중 LLM 제공자 지원	OpenAI, Anthropic, Google Gemini, Groq, Ollama 및 사용자 정의 엔드포인트(BYOK)를 지원합니다.
서브 에이전트	대규모 작업은 출력이 검증되기 전까지 수용되지 않는 격리된 서브 에이전트로 분할할 수 있습니다.
데몬 / 트리거	파일, 스케줄, 이메일, 웹훅을 모니터링하고 자동으로 자율 실행을 시작하는 선택적 백그라운드 모드입니다.
풍부한 채널	내장 TUI, Discord, Slack, Telegram, 이메일, 일반 웹훅을 통해 상호작용할 수 있습니다.
코드베이스 모드	리포지토리 스냅샷을 가져와 구조를 분석하고 안전한 파일 변경을 수행하며 테스트/빌드를 실행하고 Git 작업을 검증 가능한 효과로 기록합니다.
워크벤치 UI	웹 기반 워크벤치(`aiden web`)를 통해 시각적이고 타입 지정된 워크플로우를 설계할 수 있으며, 동일한 실행 계약으로 컴파일됩니다.

기술 스택

언어 / 런타임 – TypeScript 5 (Node 20/22 대상), ESM npm 패키지(aiden-runtime)로 제공.
번들러 – esbuild.
지속성 – better-sqlite3를 통한 SQLite와 FTS5.
브라우저 자동화 – Playwright (헤드리스 Chromium).
컨테이너 사전 – 선택적 Docker 지원으로 격리된 실행을 가능하게 합니다.
통신 – 스트리밍 출력을 위한 Server-Sent Events (SSE); 선택적 데몬 모드.
모델-컨텍스트 프로토콜 (MCP) – 일관된 모델 상호작용을 위한 커스텀 1.0 프로토콜.
크로스 플랫폼 – Windows 11, Linux, WSL, macOS (API-only 모드)에서 작동.

시작하기 (약 60초)

# 런타임을 전역으로 설치
npm install -g aiden-runtime
# 인터랙티브 CLI (Operator TUI) 시작
aiden

또는 설치 없이 단일 인스턴스 실행:

npx aiden-runtime@latest

처음 실행 시 빠른 설정 마법사가 표시된 후 REPL로 이동하여 목표를 입력할 수 있습니다. 예시:

> 최신 Rust async 패턴을 조사하고 마크다운 요약을 출력하라

계획이 표시되고 권한이 필요한 단계를 승인한 후, 마크다운 파일과 검증 로그를 받게 됩니다.

일반적인 사용 사례

시나리오	예시 프롬프트
코드베이스 유지보수	"CI 테스트가 실패하는 이유를 찾아 버그를 수정하고, 테스트 스위트를 실행하며, 서명된 커밋으로 변경 사항을 커밋하라."
연구 및 보고서 작성	"트랜스포머 양자화에 관한 최근 논문을 수집하고, 결과를 비교하여 구조화된 보고서를 생성하라."
웹 자동화	"example.com에 로그인하고, 내 정보로 가입 양식을 채우고, 확인 PDF를 다운로드하여 ~/Downloads에 저장하라."
백그라운드 자동화	"~/Inbox에 새로운 .txt 파일이 추가되면, 내용을 자동으로 Google 문서에 요약하라."*
다중 에이전트 오케스트레이션	"UI 모크업을 생성한 후, 서브 에이전트에게 React 컴포넌트를 작성하게 하고, 마지막으로 둘을 리포지토리에 통합하라."

성숙도 및 커뮤니티

버전 – 안정판 v4.21.1 (npm latest로 배포됨).
라이선스 – AGPL-3.0 (오픈소스, 수정 사항의 소스 배포가 필수).
활동성 – 월간 릴리스, 상세한 변경 로그, 활발한 Discord 커뮤니티.
설치 크기 – 단일 npm 패키지 + 선택적 Docker(사전 실행용); 무거운 바이너리 없음.
알려진 제한 사항 – 제3자 계정 연결은 수동으로 제공자 설정 필요; 강한 터미널 리사이징 시 일부 시각적 문제 발생; Windows 설치 프로그램은 포함되지 않음(런타임만).

빠른 참조 링크

npm 패키지 – https://www.npmjs.com/package/aiden-runtime
문서 – 리포지토리 내 docs/v4.5/ (CLI 명령어, 모델 전환, 스킬 확장 등 포함)
Discord 커뮤니티 – https://discord.gg/CU5wshJW4F
릴리스 노트 – RELEASE-NOTES-v4.21.1.md 및 이전 태그 참조.

결론 – Aiden은 채팅을 넘어서는 풀스택 자율형 AI 에이전트로, 개발자와 고급 사용자가 단일 목표를 제시하고, 검증 가능하고 복구 가능한 워크플로우를 자신의 컴퓨터에서 실행할 수 있게 합니다. 이는 AI 에이전트 분야에서 진정으로 유지보수되고 있는 소프트웨어 프로젝트입니다.