로컬 코딩 에이전트를 위한 코딩 중심 워크스페이스

로컬 코딩 에이전트를 위한 코딩 중심 워크스페이스.

사용자 자신의 기기에서 에이전트를 실행하고, 모든 도구 호출과 diff를 확인하며, 모델, 코딩 세션, 워크스페이스 및 원격 측정 데이터를 사용자 통제 하에 유지하세요.

Get started · Features · Discord · Facebook Group · Issues · Contribute

대부분의 코딩 에이전트는 터미널이나 편집기에서 작동합니다. OpenAgentd는 사용자가 에이전트를 실행하고, 실시간으로 작업 과정을 추적하며, 변경된 내용을 검사하고, 컨텍스트를 잃지 않고 계속 작업을 진행할 수 있는 코딩 중심 네이티브 데스크톱 앱이자 모바일 컴패니언입니다.

작업 과정 확인. 스트리밍되는 응답, 도구 호출, 인자(arguments), 결과, 타이밍, 파일, diff, 터미널 출력 및 에이전트 상태가 하나의 인터페이스에서 표시됩니다.태스크 추적. 깔끔하고 사용자 친화적인 태스크보드 체크리스트를 통해 현재 작업과 진행 상황을 한눈에 확인할 수 있습니다.실제 리포지토리에서 작업. 코딩 세션은 로컬 폴더를 열고, 격리된 git worktree를 지원하며, 변경 사항과 히스토리를 보여주고, 편집 후 언어 서버 진단(language-server diagnostics)을 반환합니다.모델 선택. Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Copilot, Codex, Ollama 등 주요 클라우드 및 로컬 제공업체의 키를 사용하여 사용할 수 있습니다.로컬 우선 유지. 세션, 원격 측정 데이터, 구성 및 API 서버는 사용자의 기기에서 실행됩니다. 필요할 때 모바일 클라이언트나 다른 데스크톱에 안전하게 연결할 수 있습니다.

버전별 기능 카탈로그(feature catalogue)가 배포된 기능을 기록하는 표준 기록입니다.

현재 데스크톱 릴리스를 설치하세요:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/lthoangg/openagentd/main/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/lthoangg/openagentd/main/install.ps1 | iex

애플리케이션 폴더나 시작 메뉴에서 OpenAgentd를 실행하세요. 데스크톱 앱이 내장된 백엔드를 자동으로 실행하며, 새 설치는 키가 필요 없는 OpenCode Zen 기본값으로 즉시 대화를 시작할 수 있습니다. 모델을 전환하고 싶을 때 언제든지 설정(Settings)에서 다른 제공업체를 추가하세요.

릴리스 아티팩트는 최신 릴리스 페이지에서 macOS, Windows, 및 Linux용으로 이용 가능합니다. 서명되지 않은 데스크톱 빌드는 첫 실행 전에 명시적인 운영체제 확인이 필요할 수 있습니다.

iOS 앱은 컴퓨터에서 실행되는 OpenAgentd 서버(CLI 서버 참조)에 연결됩니다. App Store에는 없습니다. 각 릴리스는 사이드로드용 .ipa 파일을 포함합니다. SideStore를 사용하여 이 소스를 추가하고 앱과 업데이트를 받으세요:

SideStore 설정, 기타 사이드로딩 도구, 무료 Apple 계정 제한, 서버 연결 및 문제 해결에 대해서는 'iOS 앱 설치'를 참조하세요.

터미널에서 실행하거나, 브라우저 클라이언트를 사용하거나, 다른 장치에 연결하려면 백엔드를 설치하세요:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/lthoangg/openagentd/main/install.sh | sh -s -- --cli
openagentd server start

# Windows PowerShell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/lthoangg/openagentd/main/install.ps1))) -Cli

서버는 첫 시작 시 기본 에이전트와 구성을 생성합니다. API만 제공하므로, 데스크톱 앱의 서버 연결 대화 상자 또는 모바일 앱에서 출력된 Server: 주소에 연결한 다음 설정(Settings)에서 공급자를 추가하세요. 네트워크상의 휴대폰이나 다른 컴퓨터의 경우:

openagentd server start --host 0.0.0.0 --key
openagentd server status

--key는 모든 클라이언트가 전송해야 하는 액세스 키를 설정하며, 서버는 이 키 없이는 루프백(loopback)을 넘어 듣기를 거부합니다. 내장된 TLS 기능이 없으므로, 신뢰할 수 있는 네트워크 외부에서 노출하기 전에 HTTPS 리버스 프록시를 앞에 두세요. 현재 명령어 참조를 위해 openagentd --help 및 <명령어> --help를 사용하세요.

파이프 친화적인 터미널 응답이 필요할 때 현재 프로젝트 디렉터리를 대상으로 한 에이전트 턴을 직접 실행하세요:

openagentd run --model openai:gpt-5.5 --thinking high --prompt

명령어는 현재 디렉터리를 코딩 워크스페이스로 검증하고, 해당 턴을 위한 새로운 세션을 유지하며, 에이전트의 응답 텍스트를 표준 출력으로 스트리밍합니다. 도구 권한 이벤트는 런타임의 기존 자동 허용 정책(auto-allow policy)을 따릅니다. 대화형 에이전트 질문은 비대화형 명령을 중지시킵니다. 다른 워크스페이스를 사용하려면 `-C DIR`를, 세션을 계속하려면 `--continue` 또는 `--session ID`를 사용하고, 스트림 이벤트당 하나의 JSON 라인을 원하면 `--json`을 사용합니다.

Rust 툴체인(`cargo`)과 Bun이 필요합니다:

git clone https://github.com/lthoangg/openagentd.git
cd openagentd
bun install --cwd web
...

`make run`은 백엔드만 시작합니다.

| 실행할 수 있는 대화 | 보기로 유지되는 워크스페이스 |
|---|---|
![]() | ![]() |

| 변경 사항 검사 | 로컬 사용량 주시 |
|---|---|
![]() | ![]() |

**계획하고 코딩합니다.** 읽기 전용 탐색 및 결정 완료 계획을 위한 'Plan 모드'와 정밀한 구현을 위한 'Code 모드' 사이를 전환할 수 있습니다. 컴포저(composer)에서 또는 `Tab` 키로 세션 중간에 전환하세요.

**빌드하고 검사합니다.** 파일을 첨부하고, 코딩 워크스페이스를 탐색하며, `@` 멘션을 사용하고, 실시간 diff를 검토하며, 대화창을 벗어나지 않고 구조화된 도구 출력을 검사할 수 있습니다. 통합 타임라인을 통해 여러 전문가에게 독립적인 하위 작업을 위임하세요.

**자신감 있게 작동합니다.** 제공업체(providers), MCP 서버, 스킬, 경로 금지 목록 권한(path denylist permissions), 예약된 작업(scheduled tasks), 할 일(todos), 그리고 코딩 워크스페이스의 로컬 원격 측정(local telemetry)을 관리할 수 있습니다. OpenAgentd는 동일한 API를 대상으로 데스크톱, 브라우저, 터치 우선 모바일 클라이언트를 지원합니다.

- 기능 (Features) — 배포된 버전별 기능 목록입니다.
- 릴리스 (Releases) — 빌드를 다운로드하고 릴리스 노트를 읽으세요.
- Discord — 커뮤니티 서버에 참여하여 대화하고 질문하세요.
- Facebook Group — 커뮤니티 그룹에 참여하여 연결하고 공유하세요.
- 이슈 (Issues) — 기능 요청, 버그, 로드맵 토론 및 알려진 문제점입니다.
- 보안 정책 (Security policy) — 취약점을 비공개로 신고하세요.
- 기여 (Contributing) — 개발 체크아웃을 설정하고 변경 사항을 제출하세요.

OpenAgentd는 Apache 2.0 라이선스 하에 배포됩니다.