Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Alethe는 Claude Code, Codex, Copilot 등 여러 AI 에이전트와 사용자의 셸을 하나의 로컬 우선 데스크톱 앱에서 통합 관리하는 작업 공간입니다. 이 도구는 각 에이전트를 독립적인 PTY 세션으로 실행하여 세션 손실이나 동기화 문제를 해결하고, 복잡한 멀티 에이전트 코딩 작업을 지원합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Alethe Logo
멀티 에이전트 코딩 작업 공간.
Claude Code, Codex, Copilot 및 사용자의 셸을 하나의 로컬 우선 데스크톱 앱에서 나란히 실행하세요.
중국어 설명
다운로드 · 버그 신고 · 기능 요청 · 보안 · 개인정보 보호 · 기여하기
중요
Alethe는 초기 공개 버전입니다. 데스크톱 앱은 무료이며 오픈 소스이고 로컬 우선(local-first)이지만, 로컬 전용(local-only)은 아닙니다: 업데이트 확인 및 제공자 사용 폴링은 기본으로 켜져 있으며, 다른 네트워크 기능은 선택 사항이거나 액션 트리거 기반입니다. 수동 GitHub Gist 동기화는 이미 사용할 수 있습니다. 퍼스트 파티 호스팅 동기화 또는 클라우드 백업은 나중에 별도로 제공될 수 있습니다. 개인정보 보호 및 데이터 흐름 가이드를 참조하세요.
하나의 터미널에서 하나의 에이전트를 사용하는 것은 쉽습니다. 세 개의 리포지토리에 걸쳐 다섯 개의 에이전트를 사용하는 것이 실제 작업이며, 이때는 터미널 탭으로는 작동하지 않습니다: 세션이 손실되고, MCP 서버가 에이전트 간에 동기화되지 않으며, 누가 무엇을 하고 있는지 아무도 알지 못합니다.
Alethe는 이를 위해 구축된 데스크톱 작업 공간입니다. 모든 에이전트는 지속적인 프로젝트 레이아웃 내의 실제 PTY에서 실행되며, 자체 세션과 히스토리를 유지하고, UI를 재배열해도 살아남습니다. 게다가 Alethe는 에이전트들이 공유하는 것들: 그들의 CLI, 그들의 MCP 서버, 그들의 스킬, 그리고 사용자가 그들 사이에서 이동하는 대화들을 관리합니다.
크로스 플랫폼(Windows, macOS, Linux), 로컬 우선(local-first), Tauri, Rust, React 및 xterm.js로 구축됨
.
“로컬 우선”은 인터넷 연결이 자유롭다는 보장이 아니라 작업 공간의 지속성을 설명합니다. 현재 네트워크 기본값, 자격 증명 및 보존에 대해서는 docs/PRIVACY.md를 참조하세요.
| macOS | Windows | Linux |
|---|---|---|
| macOS에서 사용 가능 | Windows에서 사용 가능 | Linux에서 사용 가능 |
누락된 CLI는 Alethe 내부에서 설치, 업데이트 및 제거할 수 있습니다. 이는 Node, npm, WinGet, Scoop, Chocolatey를 검색하여 실제로 작동하는 방법만 제공하며, 각 공급업체의 공식 설치 프로그램을 선호합니다. 이미 설치된 CLI는 PATH, 레지스트리, npm/pnpm/Volta/fnm/nvm/Bun/Cargo/Scoop/Chocolatey 전반에서 발견되며 사용자 지정 경로를 가리킬 수 있습니다. 플러그인은 이 목록에 자체 에이전트를 추가할 수 있습니다.
에이전트는 선택적으로 9router를 통해 라우팅될 수 있으며, 이는 트래픽을 여러 공급업체에 분산시키고 자동 폴백(automatic fallback) 기능을 제공하는 로컬 프록시입니다. Alethe는 전역 npm 패키지를 건드리지 않고 자체적이고 버전이 고정된 사본을 설치하고 실행합니다. 라우팅은 기본적으로 비활성화되어 있으며, 활성화된 이후에 열리는 터미널에만 적용됩니다.
에이전트를 병렬로 실행하기
컨텍스트 유지하기
에이전트가 공유하는 것을 관리하기
MCP 탭: 해당 장치에 구성된 모든 MCP 서버를 서버별로 그룹화하고, 어떤 에이전트가 이를 사용하고 있는지 보여줍니다 — Claude Code, Codex, Cursor, OpenCode, Antigravity 설정에서 읽어옵니다. 서버를 한 에이전트에서 다른 에이전트로 추가, 제거, 복사할 수 있으며, 공식 레지스트리에서 검색하고 각 에이전트에게 실제로 해당 서버에 도달할 수 있는지 확인하도록 요청할 수 있습니다. 모든 쓰기 작업은 백업되고, 재분석되며, 원자적으로 커밋됩니다.Skills 탭: 각 에이전트에 설치된 스킬을 보여주며, 링크와 공유 저장소를 해결하여 공유되는 스킬은 한 번만 표시됩니다.Graphify: 프로젝트의 코드 그래프를 MCP 서버로 에이전트에게 제공합니다.
플러그인으로 확장하기
플러그인 게시하기
플러그인은 이름이 plugin.json의 id와 일치하는 폴더이며, window.alethe에 바인딩되는 main.js 번들을 옆에 둡니다 (React 포함 — 절대 자체 번들링하지 마세요). 매니페스트는 탭, 명령 및 기능을 선언하고, 코드가 이를 구현합니다.
**로컬에서 사용해 보세요.**폴더를 <profile>/plugins/<id>/에 드롭하세요.
, 또는 Preferences ▸ Plugins ▸ *플러그인 가져오기(Import plugin)*를 사용합니다. 플러그인은 비활성화된 상태로 도착하며, 활성화할 때 신뢰 대화 상자를 거칩니다.zip 파일 배포. 플러그인 폴더를 zip으로 압축하고, SHA-256 값을 얻은 다음, 릴리스에 첨부합니다: zip -r my-plugin.zip my-plugin && sha256sum my-plugin.zip
.목록 등록(Get it listed). 이 저장소에 대한 풀 리퀘스트를 열고 plugins.json 파일에 다음 항목을 추가합니다:
{
"id": "",
"name": "",
"downloadUrl": ""
}
그리고 Alethe 내부에서 설치 가능하게 하려면, package.url과 package.sha256을 추가합니다.
zip 파일이 변경될 때마다 다시 해시(Re-hash)해야 합니다.- 병합되면, 목록은 6시간 이내에 모든 사용자에게 도달하거나 새로 고침(Refresh) 시 즉시 도달합니다.
목록 등록은 사람이 풀 리퀘스트를 읽는 것이지 감사(audit)가 아닙니다: 플러그인은 여전히 비활성화된 상태로 도착하며, 여전히 신뢰 대화 상자를 거칩니다. docs/examples/notes-plugin/은 빌드 단계가 없는 순수 JavaScript로 작동하는 플러그인이며, 플러그인 가이드에 전체 계약(full contract)이 있습니다.
통제권을 유지하세요(Stay in control)
gh CLI를 통해 에이전트 worktree의 열린 GitHub PR을 찾아 메타데이터를 열고, 동일한 격리된 worktree 내부에서 AI 검토를 시작할 수 있습니다 — 읽기 전용이며, 커밋, 푸시, 병합 또는 GitHub 댓글 기능은 없습니다. Squash-merging은 명확한 인간의 행동으로 유지되며, 헤드 SHA가 이동했거나, PR이 초안(draft)인 경우, 또는 GitHub에서 충돌을 보고하면 차단됩니다. GitHub 토큰은 저장되지 않으며, 인증은 gh에 위임됩니다..- 터미널 옆 콘텐츠 패널: 파일 탐색기, Markdown, diffs, 이미지, 비디오, 임베디드 브라우저.
http://127.0.0.1:8888/callback를 리디렉션 URI로 지정하여 연결합니다. 현재 릴리스는 해당 자격 증명을 로컬 프로필 파일에 저장하므로, 프로필 데이터를 내보내거나 공유하기 전에 개인 정보 보호 가이드를 확인하십시오.그룹(Group) |
함께 열리고, 접히고, 일시 중지되는 프로젝트 모음입니다. |
프로젝트(Project) |
저장된 작업 컨텍스트: 터미널, 레이아웃, 색상, 로컬 상태. |
컨테이너(Container) |
열린 프로젝트의 보이는 프레임입니다. 닫는다고 해서 아무것도 종료되지는 않습니다. |
패널(Pane) |
컨테이너 내부의 터미널 보기입니다. |
하위 탭(Sub-tab) |
같은 패널 내의 별도 에이전트 또는 셸 세션입니다. |
PTY |
UI와 독립적으로 살아있는 실제 백엔드 프로세스.
최대화된 IDE보다는 선택적 기능을 갖춘 핵심에 초점을 맞추었으며, Obsidian과 더 가깝습니다. 필수적이지 않은 기능들은 기능 플래그나 옵트인 설정 뒤에 배치되며, 클린 설치는 일급 경험으로 유지됩니다. 양(Volume)보다 응집성(Coherence)에 중점을 둡니다.
릴리스 페이지에서 게시된 설치 파일을 사용하세요.
경고
Windows 빌드는 아직 코드 서명되지 않았기 때문에, Defender가 alethe.exe를
Trojan:Win32/Bearfoos.A!ml로 플래그 지정하고 격리할 수 있습니다. 여기서 !ml 접미사는 게시자 서명이 아닌 머신러닝(machine-learning) 휴리스틱을 나타내며, 자식 프로세스 생성 및 PTY 생성과 같은 터미널 멀티플렉서 동작은 오탐지를 유발할 수 있습니다. 다운로드가 공식 릴리스 페이지에서 왔는지 확인하고; 다른 출처의 아티팩트에 대해 경고를 무시하지 마십시오.
복구 방법: Windows 보안 → 바이러스 및 위협 방지 → 보호 기록 → 작업 → 복원을 수행한 다음, %LOCALAPPDATA%\Alethe (소스에서 빌드하는 경우 src-tauri/target)에 대한 예외를 추가하십시오. 잘못된 탐지에 대한 보고는 Microsoft Security Intelligence로 보내주십시오. macOS 빌드 역시 아직 노타라이즈(notarized)되지 않았으므로, 앱을 마우스 오른쪽 버튼으로 클릭하고 열기를 선택하여 Gatekeeper를 우회하십시오. 서명 및 노타라이징은 로드맵에 있습니다.
git clone https://github.com/Kc1t/alethe-agents.git
cd alethe-agents
npm install
...
요구 사항: Node.js 18 이상, Rust stable, Windows용 Visual Studio Build Tools, Linux용 Tauri 시스템 종속성:
sudo apt install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
npm run app # 핫 리로드가 가능한 데스크톱 앱
npm run dev # 프론트엔드 전용
npm run build # 타입 검사 + 프론트엔드 빌드
...
설정 ▸ 통합 ▸ 터미널 명령어에서 alethe 명령어를 설치하십시오:
alethe # 현재 폴더를 프로젝트로 엽니다
alethe ~/some/project # 주어진 폴더를 엽니다
만약 해당 폴더가 이미 프로젝트라면, 중복되지 않고 작업 공간으로 가져와집니다. Alethe가 이미 실행 중이라면, 기존 창이 포커스됩니다. 이 명령어는 ~/.local/bin/alethe (macOS/Linux) 또는 %LOCALAPPDATA%\Alethe\bin\alethe.cmd (Windows)에 위치합니다 — 앱을 이동한 후에는 다시 설치하십시오.
기여를 환영합니다. CONTRIBUTING.md 파일을 참고하여 설정, 프로젝트 레이아웃 및 내부 규칙을 확인하세요. 가장 쉬운 기여 방법은 다음과 같습니다:
good first issue 또는 help wanted라고 표시된 이슈를 선택하고 댓글을 달아 소유권을 주장하기.더 큰 변경 사항의 경우, 방향을 논의할 수 있도록 먼저 이슈를 생성하세요.
Alethe를 작업 공간으로 구축한 프로젝트 및 제품들 — 병렬로 실행되는 에이전트, 그 옆에서 작동하는 쉘(shell), 그리고 날을 넘나드는 세션 재개 기능.
아직 아무것도 없습니다. Alethe로 무언가를 만들었나요? SHOWCASE.md에 추가해주세요.
— 한 줄의 풀 리퀘스트(pull request)만으로 가능하며, 기여자 목록에도 이름을 올릴 수 있습니다.
전체 목록과 제출 방법은 SHOWCASE.md를 참고하세요.
Alethe가 실제 개발 워크플로우에서 어떻게 사용되는지 확인하고 코딩 에이전트를 병렬로 오케스트레이션(orchestrate)하는 방법을 배우세요.
| 영상 | 내용 |
|---|---|
| 한 번에 하나의 AI 에이전트만 사용하는 것을 멈추세요: AI 에이전트 오케스트레이션하기 (Stop Using One AI Agent at a Time: Orchestrate AI Agents) | |
| 한 번에 하나씩 작업하는 대신 여러 AI 코딩 에이전트를 조정하는 실용적인 소개. Kauã Miguel - Dev · 포르투갈어 | |
| 소프트웨어 개발자의 하루 — 개발 로그 1 (A Day in the Life of a Software Developer — Devlog 1) | |
| 일상적인 코딩 과정의 일부로 Alethe를 보여주는 실제 개발자 워크플로우. Guilherme Dev · 포르투갈어 |