<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/logo/adroit-logo-horizontal-light.svg?v=6770c89">
<img src="https://raw.githubusercontent.com/adroit-app/Adroit/HEAD/assets/logo/adroit-logo-horizontal.svg?v=6770c89" alt="Adroit" width="360">
</picture>
</p>
Adroit
Vim 환경에서 생활하는 사람들을 위한 에이전트 워크스페이스: 직접 그리고 편집하는 방식 그대로, 모든 코딩 에이전트를 자체 터미널 인터페이스에서 구동합니다.
[!NOTE]
Adroit는 초기 단계입니다. 작동은 하지만, 미흡한 부분과 변경 사항을 예상해야 합니다.
Claude Code, Codex, Pi, OpenCode 세션들이 하나의 창에 나란히 배치되며, 각 에이전트가 자체 인터페이스를 유지하며 작동합니다. 사용자는 자신이 선택한 매핑 및 플러그인으로 설정된 Adroit용 실제 Neovim에서 프롬프트를 작성하고, Vim의 동작(motion)을 사용하여 탭, 스플릿, 트리, 디테일 패널 사이를 이동할 수 있습니다.
세션들은 저장소(repository)를 가로지르는 워크스페이스와 작업트리(worktree)별로 그룹화되며, 사용자에게 대기 중인 항목들이 가장 먼저 나열됩니다.
api ← 하나의 저장소 (a repository)
├── main ← 하나의 작업트리 (a worktree)
│ ├── auth-revamp ← Claude Code 세션
...
창을 닫아도 세션과 셸은 계속 실행됩니다. Adroit를 다시 열면 해당 세션으로 돌아갈 수 있으며, 동일한 작업을 위해 여러 개의 창을 열 수도 있습니다. 디테일 패널에서는 해당 세션의 개요, 변경 사항, 기록(history), 에이전트, 리소스, 그리고 에이전트가 작업 내용을 기록하는 타임라인을 확인할 수 있습니다.
┌──────────────┬──────────────────────────────────┬─────────────┐
│ tree │ 1 auth-revamp │ 2 review-api │ details │
│ ├────────────────┬─────────────────┤ │
...
Adroit가 누구를 위한 것이며 그 배경에 담긴 아이디어는 개념(the concept)을 참고하십시오.
빌드 및 설치 (Build and install)
Adroit는 git과 PATH 환경 변수에 최소 하나의 지원되는 에이전트가 필요합니다. 릴리스 버전은 Neovim과 프롬프트 및 콘솔 리더를 함께 제공하며 실행됩니다. 소스에서 빌드하고 실행할 경우, 이는 PATH에 있는 nvim을 사용하거나 ADROIT_NVIM이라는 프로그램 이름을 사용합니다. 어느 쪽이든 Neovim에서 파일을 열면 PATH의 nvim이 실행됩니다.
| 에이전트 | 프로그램 |
|---|
| Claude Code | claude |
| ... | |
| jj를 설치하여 jj 리포지토리를 읽고 jj 워크스페이스를 생성하세요. ghq는 선택 사항이며, 설치된 경우 해당 리포지토리가 디렉터리 선택기에 제공됩니다. | |
Apple silicon Mac에서는 Homebrew를 사용하여 최신 릴리스를 설치하세요:
brew install --cask adroit-app/tap/adroit
각 릴리스에는 캐스크가 설치하는 디스크 이미지가 포함되어 있습니다. Adroit.app은 Apple Developer ID가 아닌 자체 서명 인증서로 서명되었기 때문에, 다운로드한 사본은 격리 제거(xattr -dr com.apple.quarantine /Applications/Adroit.app)를 하거나 시스템 설정(System Settings) → 개인 정보 보호 및 보안(Privacy & Security)에서 열기를 허용해야 합니다. 캐스크가 이 작업을 자체적으로 수행합니다.
각 릴리스에는 x86_64용 Windows zip 파일과 x86_64 및 aarch64용 Linux tarball이 포함되어 있습니다. 원하는 위치 어디든 압축을 풀고 폴더에서 adroit를 실행하세요. 이 프로그램은 옆에 있는 neovim/에서 프롬프트와 콘솔 리더가 실행되는 Neovim과, licenses/에 라이선스를 담고 있습니다.
Windows에서는 바로 가기(shortcut)에서 adroitw.exe를 시작하여 콘솔이 표시되지 않는 창을 여세요. 이 zip 파일은 서명되어 있지 않으므로 SmartScreen이 다운로드된 사본 실행 전에 사용자에게 묻습니다. 이 창은 Windows 11에 포함된 Microsoft Edge WebView2 Runtime으로 그려집니다.
Linux에서는 tarball이 Ubuntu 24.04 또는 그 이상의 최신 glibc에서 실행되며, 시스템의 WebKitGTK 4.1, GTK 3 및 libxdo와 링크됩니다 (Debian 및 Ubuntu의 경우 libwebkit2gtk-4.1-0 및 libxdo3을 설치하세요).
Nix를 사용하는 경우 (adroit Cachix 캐시에 사전 빌드됨):
nix profile install github:adroit-app/Adroit
Nix 개발 셸에서 빌드하고 실행합니다:
nix develop -c cargo run --release -p adroit
macOS에서는 애플리케이션을 /Applications에 빌드하고 설치합니다:
nix develop -c just install-macos
설치된 명령어는 /Applications/Adroit.app/Contents/MacOS/adroit입니다. 이 디렉토리를 PATH에 추가하여 터미널에서 아래의 adroit 명령어를 사용할 수 있습니다.
이 앱은 로그인 키체인(login keychain)에 해당 식별자("Adroit Release")가 있는 경우 자체 서명(self-signed identity)됩니다. 따라서 로컬 빌드는 macOS가 릴리스 또는 그 이전 빌드에 부여한 권한을 유지합니다. 그렇지 않은 경우는 ad hoc으로 서명됩니다. 릴리스는 동일한 식별자로 서명되므로, 이를 가져오려면 MACOS_SIGNING_P12 (base64 형식의 identity.p12)와 MACOS_SIGNING_PASSWORD를 제공해야 합니다:
MACOS_SIGNING_P12=… MACOS_SIGNING_PASSWORD=… just macos-import-identity
릴리스는 v0.1.0과 같은 태그가 붙은 GitHub Release로 게시되며, 디스크 이미지, Windows zip, Linux tarballs, Nix 빌드 및 Homebrew cask가 뒤따릅니다 (ADR). 릴리스와 동일한 방식으로 사용 중인 시스템용 버전을 Nix shell 외부(Windows의 Git Bash에서)에서 just bundle로 빌드하세요.
Windows에서는 Rust, MSVC 빌드 도구 및 LLVM이 설치되어 있고 Neovim이 PATH에 설정된 상태에서 빌드합니다:
cargo run --release -p adroit
해당 셸은 PowerShell을 실행합니다. 하나의 adroit는 하나의 창을 열고, Claude Code의 외부 에디터가 여기에 연결되지 않습니다. 터미널이 아닌 탐색기(Explorer)나 바로 가기에서 시작하면, Windows가 잠시 보여준 후에도 그 자체 외에 콘솔 창은 열리지 않습니다. 대신 바로 가기에서 adroitw.exe를 실행하면 아무것도 표시되지 않으며, cargo build --release -p adroit -p adroit-launcher는 이를 adroit.exe 옆에 빌드합니다.
Linux 환경에서 Nix development shell은 window가 빌드된 것과 동일한 기능을 제공합니다. 외부에서는 WebKitGTK 4.1, GTK 3, libxdo 및 OpenSSL의 개발 패키지(Debian 및 Ubuntu의 경우, libwebkit2gtk-4.1-dev, libgtk-3-dev, libxdo-dev 및 libssl-dev)를 설치한 다음 위와 같이 빌드합니다. window는 Wayland에서는 wl-copy로 복사하고, 그렇지 않으면 xclip 또는 xsel을 사용하며, xdg-open으로 경로와 주소를 열고, notify-send로 세션 대기 상태를 알립니다. 각 기능은 해당 프로그램이 설치되지 않은 곳에서는 작동하지 않습니다.
Windows 환경에서는 Git Bash에서 just ci-windows를 실행하여 CI lints 및 테스트를 수행합니다. 소스가 다른 머신에서도 Windows에서 여전히 빌드되는지 확인하려면, vitro가 vitro.toml에 명시된 대로 임시 Windows VM에서 lints를 수행합니다:
세션 시작하기
- 디렉터리를 선택하려면
Mod+p (tree의 w)를 누릅니다. 피커는 이미 사용 중인 워크스페이스, Claude Code 프로젝트, ghq 리포지토리 및 파일 트리를 제공합니다. 스크래치 세션 행을 선택하거나, 디렉터리 선택 없이 시작하려면 Session → New Scratch Session을 선택합니다.
- 초안에서 프로필, 모델 및 권한을 선택합니다.
Ctrl+g p와 Ctrl+g P를 사용하여 프로필 간 이동할 수 있습니다.
- 첫 번째 프롬프트를 작성하고
Ctrl+Enter를 누릅니다. 세션이 시작되며, 이후의 프롬프트는 동일한 세션으로 전송됩니다.
name: review-api와 같은 첫 줄은 세션을 이름 짓고, 이 이름은 에이전트에게 전송되는 프롬프트에서 제거됩니다. 이름이 없으면 Adroit가 프롬프트를 기반으로 이름을 생성합니다.
터미널에서 Codex 세션을 시작하려면:
adroit session start --agent codex --dir ~/src/api -- "Review the API"
에이전트가 유지하고 있던 대화로 돌아가려면 Mod+o (tree의 O)를 누릅니다. 목록에는 프로필이 사용하는 로그인에서의 대화가 포함되어 있으며, 하나를 선택하면 해당 로그인에서 재개됩니다. sessions 및 the directory picker를 참조하십시오.
프로필 및 로그인
**설정(Settings) → 에이전트(Agents)**에는 이름 지정된 프로필이 있습니다. 각 프로필은 에이전트, 해당 로그인 정보, 실행 명령어, 환경 및 새 세션의 기본값을 선택합니다. 하나의 에이전트에 대해 여러 프로필을 유지할 수 있으며, 새 세션이 어떤 프로필에서 시작할지 선택할 수 있습니다.
프로필은 터미널의 로그인 정보를 사용하거나 자체적인 로그인을 유지할 수 있습니다. 후자는 고유한 자격 증명(credentials), 기록 및 설정을 가집니다. 설정(Settings) 내 프로필 페이지에서 로그인하십시오. 기존 세션은 설정이 변경되어도 시작했던 프로필과 로그인을 유지합니다.
초안(Drafts)은 프로필의 모델과 권한을 재정의할 수 있습니다. 읽기 전용 및 사용자 지정 권한은 선택된 에이전트 자체의 제어를 사용하며, 그 범위는 에이전트마다 다릅니다. profiles와 agent behavior를 참조하십시오.
이동하기 (Move around)
Mod는 macOS에서는 Cmd를, 다른 환경에서는 Ctrl+Shift를 의미합니다. Ctrl+q는 프롬프트가 삽입 모드(insert mode)에 있을 때도 창 이동 동작을 시작하며, Ctrl+w는 콘솔이나 프롬프트의 프로그램과 함께 머무릅니다.
| 키 | 동작 |
|---|
Ctrl+q h/j/k/l | 트리, 콘텐츠 창, 프롬프트 및 상세 패널 사이 이동 |
| ... | |
트리 및 파일(Tree and files)
이동에는 j/k와 gg/G를 사용합니다. Enter, o 또는 l은 행을 열어, 이미 해당 내용을 보여주는 창으로 돌아가거나 새 탭을 엽니다. s, v, t는 이를 아래쪽 분할 화면(split below), 옆쪽 분할 화면(split beside) 또는 새 탭에서 엽니다. 디렉터리 및 제목은 접히고 펼쳐지며, h를 누르면 다시 펼쳐집니다.
파일은 Neovim 또는 해당 종류의 뷰어에서 열립니다. x는 세션이나 셸을 종료하지 않으면서 행이 보여주는 내용을 닫습니다. n, $, 그리고 e는 선택된 디렉터리에서 세션, 셸 또는 Neovim을 시작합니다.
Adroit에서 트리(tree)를 통해 열거나 셸(shell)에서 시작된 Neovim은 자체 설정이 선택한 색상 테마(colorscheme)를 유지합니다. 콘솔의 테마로 표시하고, 테마가 변경될 때 따라가게 하려면 작업 기계의 Neovim 설정에 다음을 추가하십시오:
if exists('$ADROIT_THEME_FILE') | colorscheme adroit | endif
adroit 색상 테마는 Adroit에 포함되어 있어 별도로 설치할 필요가 없습니다. 테마의 색상에서 Neovim 사용하기를 참조하십시오.
콘솔 및 프롬프트(Console and prompt)
세션의 콘솔에서 i를 누르면 프롬프트(prompt)에 쓰기 모드가 시작됩니다. Vim 동작(motions), 검색 및 선택은 Neovim을 통해 콘솔을 읽으며, y는 복사하고 q는 라이브 콘솔로 돌아갑니다. Ctrl+g i는 Esc를 누르기 전까지 키를 에이전트(agent)에게 직접 전달합니다. 에이전트가 선택이나 권한을 기다릴 때, 해당 콘솔은 답변을 직접 받습니다. 셸(shell) 역시 입력을 직접 받습니다.
프롬프트는 Neovim을 사용합니다. Ctrl+Enter를 누르면 전송됩니다. 미전송 텍스트와 첨부 파일은 탭을 전환해도 세션 또는 초안에 남아 있습니다. 이미지를 붙여넣거나 드롭하여 첨부할 수 있습니다. @는 세션과 경로를 자동 완성(complete)하며, /는 지원되는 경우 선택된 에이전트의 명령어 및 스킬을 제공합니다. 프롬프트가 비어 있을 때 Tab은 에이전트의 제안을 수락할 수 있으며, 텍스트가 있는 경우 Neovim의 기능을 따릅니다.
제어 기능 및 에이전트별 동작에 대한 내용은 프롬프트, 키 설정, 그리고 완벽한 키 참조를 참조하십시오. 바인딩(Bindings)은 설정(Settings)에서도 변경할 수 있습니다.
세션 간의 작업 병행 (Sessions working alongside each other)
Adroit가 시작하는 모든 세션에는 adroit MCP 도구인 sessions, models, start_session, 그리고 send가 있습니다. 이 도구를 사용하면 리포지토리(repository)에서 이미 작업 중인 세션을 찾고, 해당 세션이 무엇을 알고 있는지 물어보거나, 선택적으로 새로운 워크트리(worktree)에서 다른 세션에 별도의 작업 라인을 열 수 있습니다.
각 세션은 사용자에게만 응답합니다. 해당 세션에 속하는 작업은 그곳에 머무르며, 에이전트와 자체 서브에이전트도 함께 합니다. 다른 Adroit 세션은 사용자가 직접 읽고 조종할 수 있는 독립적인 피어(peer)입니다. 세션 열기를 참조하십시오.
세션에서는 adroit terminal list --json 및 adroit terminal screen --terminal <resource-id> 명령어를 사용하여 이름이 지정된 터미널 리소스를 검사할 수 있습니다. 세션의 프로그램은 kitty graphics protocol을 통해 이미지를 표시할 수 있습니다. 터미널 및 콘솔 내용을 참조하십시오.
세션 그룹을 분리하여 유지하려면 adroit --instance <name>을 사용하십시오. 각 인스턴스는 자체 호스트와 세션을 가지며, 설정과 키는 공유됩니다. adroit --new-window는 현재 인스턴스의 다른 창을 엽니다.
개발(Development)
nix develop (또는 .envrc.sample을 .envrc로 복사하고 direnv allow를 실행)로 개발 셸에 진입한 후 다음 명령어를 사용합니다:
호스트 및 세션 명령어만 실행하는 머신을 위해서는 데스크톱 창 없이 빌드하십시오:
nix develop -c cargo build --release -p adroit --no-default-features
이 실행 파일은 adroit host와 adroit daemon 서비스를 제공하며 세션, 터미널 및 MCP 명령을 실행합니다. 이 명령어는 창 열기 요청이나 에디터 입력을 받는 것을 거부합니다. 작업 머신에서는 해당 머신의 네이티브 소켓에 접근합니다. just test-headless는 작업 호스트를 대체하는 과정을 포함하여 이 빌드를 확인합니다.