AI 도구 가이드
사용하는 AI 도구의 이름을 딴 페이지를 선택하세요. 각 가이드에서는 지원하는 onemind 클라이언트, 연결 방법, 지침 파일 위치, 결과 확인 방법을 설명합니다.
CLI로 저장소를 감지해도 설정 흐름에서 정확한 대상을 일반 Project에 명시적으로 바인딩하기 전에는 활성화되지 않습니다. onemind sync 전에 활성화를 완료하세요. 감지만으로 쓰기나 업로드 권한은 생기지 않습니다. 네이티브 BETA는 Project와 폴더를 따라 호환되는 연결 대상을 준비하며 업로드를 끈 상태로 둡니다.
새 지침 동기화 대상은 Project 범위입니다. Codex, Antigravity, Claude Code, OpenClaw, OpenCode, Hermes Agent, Pi, Grok Build, DeepSeek Harness, Cursor, Qoder, TRAE 및 CodeBuddy는 명시적인 로컬 Project 디렉터리에 연결됩니다. 현재 서버는 team 역할의 Project Mind 다음에 선택한 일반 Project의 project 역할 Mind를 한 번 합성하고, CLI는 그 원자적 패키지를 Project 안의 도구 고유 지침 파일에 기록합니다. 둘 다 동일한 project Mind 유형이며 저장된 AI 대상 Mind 해석은 아직 이 런타임에 포함되지 않습니다. 기존 전역 대상은 명시적인 마이그레이션 상태로만 표시되며 새 설정에서는 제공되지 않습니다. Cursor는 CLI로 선택된 Team Project 대상과 독립적으로 활성화된 일반 Project 저장소 대상을 지원합니다. Qoder와 TRAE는 추가 CLI 저장소 대상입니다. CodeBuddy는 호환 대상 키 workbuddy를 사용하며, 검색은 후보 경로만 제안하고 사용자가 명시적으로 활성화한 정확한 Project binding만 동기화할 수 있습니다.
네이티브 BETA Project 동기화는 Mind 동기화의 도구별 안정적인 사용자 전역 부트스트랩도 유지합니다. 이 어댑터 설정은 기존 전역 Team 내용 바인딩과 별도이며 Project 내용을 포함하지 않습니다. CLI 대상 등록과 네이티브 폴더 연결은 다른 설정 경로입니다.
Codex, Claude Code 또는 Grok Build 작업이 실행 중에 도구 권한을 요청하면 기기 소유자는 작업을 중단하지 않고 Matrix 또는 macOS 앱에서 답변할 수 있습니다. Matrix 작성기는 활성화된 Codex, Claude Code 및 Grok Build 세션에 대해 / 슬래시 명령도 허용합니다. Claude Code 세션에서 @는 Claude Code 하위 에이전트를 목록에 표시하며, Codex와 Grok Build는 하위 에이전트가 없습니다.
기능 연동
지침 동기화와 AI 도구 연동은 별개의 기능입니다. 동기화는 검토된 Mind를 대상 도구의 지침 파일에 기록하고, 연동 번들은 onemind skill, 인증된 MCP 연결 및 호스트가 지원하는 네이티브 도구를 추가합니다.
명시적 onemind integrations 명령(install, update, repair, uninstall)을 사용하여 각 연동을 변경합니다. 공식 설치 프로그램은 서명된 번들만 저장하며, 호스트 연동을 변경하는 것은 이러한 명시적 명령뿐입니다. 연동 작업은 Project skills를 설치, 업데이트 또는 제거하지 않습니다. Codex 연동 작업은 번들 Codex marketplace/플러그인만 변경하며 전체 onemind 설치 프로그램 실행, CLI 또는 앱 교체, 서비스 재시작 또는 앱 열기를 하지 않습니다.
다른 운영 체제에서는 https://onemind.team/downloads/integrations/vVERSION/OneMindIntegrations-VERSION.zip과 해당 .sha256, .sigstore.json 파일을 다운로드하세요. onemind verify-release-integration VERSION OneMindIntegrations-VERSION.zip OneMindIntegrations-VERSION.zip.sigstore.json은 게시자를 읽기 전용으로 검증합니다. onemind import-signed-integration-release VERSION OneMindIntegrations-VERSION.zip OneMindIntegrations-VERSION.zip.sigstore.json ABSOLUTE_STORE는 정확한 바이트를 인증하고 증거를 보존한 불변 세대를 게시합니다. 이후 호스트 변경은 onemind integrations install TARGET만 수행하며 설치 프로그램과 셸은 호스트 플러그인을 직접 변경하지 않습니다. .sha256은 손상을 감지하지만 게시자를 인증하지 않습니다.
| AI 도구 | onemind 연동 |
|---|---|
| Codex | 네이티브 플러그인 |
| Antigravity | ~/.gemini/config/plugins/onemind의 문서화된 앱/CLI agy 플러그인, ~/.gemini/config/skills의 전역 스킬, 별도의 Project 루트 GEMINI.md 지침 동기화. 네이티브 증명, 앱 준비 및 지침 동기화는 별도 상태이며 기존 Gemini 확장이 아님 |
| Claude Code | 네이티브 플러그인 |
| OpenClaw | 네이티브 플러그인 번들 |
| OpenCode | ~/.config/opencode/skills/onemind의 공유 skill 패키지. onemind는 네이티브 OpenCode 플러그인 또는 MCP 수명 주기를 검증할 수 없으므로 패키지 준비됨으로 표시 |
| Hermes Agent | 네이티브 Python 플러그인 |
| Pi | 네이티브 Pi 패키지 및 TypeScript 확장 |
| Grok Build | ~/.grok/skills/onemind의 공유 스킬 패키지이며 플러그인은 준비됨/수동입니다. 네이티브 MCP 연결과 Project 지침 동기화는 별도 기능입니다. |
DeepSeek Harness (dsh) | ~/.dsh/skills/onemind의 공유 skill 패키지. dsh 개발자 프리뷰에는 검증 가능한 로컬 플러그인 목록이 없으므로 패키지 준비됨으로 표시 |
| Cursor | Team 및 일반 Project 지침 동기화. 네이티브 로컬 skill/MCP 패키지를 관리하고 연결 증거에는 명시적 cursor-agent JSON 마커 검사를 사용 |
| Qoder | 네이티브 로컬 플러그인 명령 계약과 skill/MCP 대체 경로 |
| TRAE | 공유 ~/.agents/skills/onemind skill + Project MCP 수동 가져오기. UI 관리 연결을 검증할 수 없으므로 패키지 준비됨으로 표시 |
| CodeBuddy | codebuddy, codebuddy-code, cbc를 통한 네이티브 플러그인. workbuddy는 호환 레지스트리 키일 뿐임 |
| ChatGPT | Mind 파일 할당만 지원. 로컬 어댑터 또는 호스트 수명 주기 없음 |
| Browser agent | Mind 파일 할당만 지원. 로컬 어댑터 또는 호스트 수명 주기 없음 |
공식 설치 프로그램은 호스트 수명 주기 작업보다 먼저 정확히 검증된 번들을 저장합니다. 상태를 확인한 뒤 한 번에 하나의 대상을 명시적으로 선택하세요.
onemind integrations list
onemind integrations status codex
onemind integrations install codex
onemind integrations update codex
onemind integrations uninstall codex
list --json과 status TARGET --json은 패키지와 호스트 상태를 분리합니다. onemind는 현재 Project의 PATH를 검색하지 않습니다. 표준이 아닌 호스트 위치는 --host-executable로 신뢰할 수 있는 절대 경로 하나를 지정해야 합니다. 공식 CodeBuddy 2.131.0의 새 프로필에서 plugin list, plugin validate, 모델 실행은 모두 60초 안에 사용 가능한 출력을 내지 못했으며, 로그는 사용자 설정 누락을 반복한 뒤 파일 watcher를 고갈시키고 핫 리로드를 비활성화했습니다. 수동 상태는 소유되지 않은 프로필을 실행하지 않습니다. 고정된 ~/.codebuddy 프로필이 없으면 명시적 설치는 CodeBuddy를 실행하지 않고 requires_host_initialization을 반환합니다. 기존 프로필은 15초로 제한된 인벤토리 사전 검사를 유지합니다. Cursor는 네이티브 영수증 바인딩 로컬 패키지를 사용하며, 새 cursor-agent JSON 마커 검사가 성공한 경우에만 연결됨으로 보고합니다. 인증되지 않은 호스트는 오프라인/미검증 상태로 남습니다. TRAE는 패키지 준비됨/수동 상태로 유지되며 Mind 전용 대상은 로컬 변경을 거부하고, 각 변경은 하나의 대상만 허용하며 Project skill을 바꾸지 않습니다. 실험적 Windows 래퍼 코드는 아래에 설명된 허용 네이티브 실행 파일과 npm cmd-shim 템플릿으로 제한됩니다.
증거 범위: Codex 0.146.0-alpha.3.1, Claude Code 2.1.220, OpenClaw 2026.7.1-2, Pi 0.82.0, AGY 1.1.9는 격리된 홈에서 이 번들의 정확한 설치, 목록, 업데이트 또는 재설치, 제거 수명 주기를 완료했습니다. OpenClaw와 Pi의 공유 패키지 ID는 @onemind/onemind이며, OpenClaw는 패키지 이름 불일치 경고 없이 정확한 manifest ID onemind를 로드합니다. Qoder 1.1.5도 정확한 네이티브 수명 주기를 완료했지만 인증된 공급업체 아티팩트 CI는 주장하지 않습니다. 보관 Hermes 0.19 런타임은 감사 전용 PYTHONPATH로 검색, 활성화, 비활성화, 제거, 깨끗한 재설치를 완료했지만 깨끗하게 설치된 호스트의 증거는 아닙니다. 공급업체 제거는 disabled/override 구성을 유지했고 재설치 후 활성화는 disabled 집합을 비웠습니다. Claude 최초 목록은 ~/.claude.json과 백업을 기록하고, OpenClaw 부재 검사는 SQLite 상태를 기록하므로 패시브 상태는 소유되지 않은 호스트를 실행하지 않습니다. Claude 래퍼와 네이티브 바이트는 공식 npm integrity와 일치했고 격리 수명 주기도 통과했습니다. 네이티브 바이너리는 Team ID Q6L2SF6YDW를 보고했지만 엄격한 codesign/spctl 검증은 실패했습니다. 이는 onemind 수명 주기 실패가 아닌 공급업체 서명 조사이며, onemind는 Apple 서명 신뢰를 주장하지 않습니다. 공식 AGY 1.1.9 설치 프로그램은 게시된 매니페스트를 기준으로 완료됐지만, 이번 실행에서는 압축 아카이브 해시를 독립적으로 다시 계산하지 않았습니다. 압축 해제된 바이너리는 Team ID EQHXZ8M8AV를 보고했고 엄격한 Apple 인증 기관/공증 검증은 사용할 수 없었으므로 onemind는 Apple 신뢰를 주장하지 않습니다. CodeBuddy 명령은 최초 목록이 온보딩 시간 예산을 초과했기 때문에 계속 소스 확인만 된 상태입니다. 이 정확한 증거 범주를 더 넓은 버전 지원으로 일반화하지 않습니다.
연동을 설치하거나 업데이트한 후에는 새 도구 세션을 시작하세요. 인증은 별도의 사용 시점 단계이며 MCP 인증을 제공하는 호스트에서는 onemind OAuth 연결을 승인해야 합니다.
AI 도구가 onemind MCP 서버에 연결되면 부여할 권한을 선택합니다. 각 권한은 특정 작업 집합에 해당합니다. 워크플로에 필요한 권한만 부여하세요. 인증 단계는 로그인 및 계정 > CLI 또는 AI 도구 인증을 참고하세요.
| 권한 | 허용 작업 |
|---|---|
| 기기 및 AI 도구 동기화 상태 읽기 | 현재 동기화 및 기기 상태 확인 |
| Matrix에서 승인한 AI 메모리 읽기 | 승인된 공유 팀 메모리 읽기 |
| 연결된 기기에 동기화 요청 | 연결된 기기에 동기화 요청 |
| Matrix 프로젝트 및 대기 중인 편집 읽기 | 프로젝트 세부 정보 목록 조회 및 읽기 |
| 프로젝트 생성 및 프로젝트 편집 제출 | 프로젝트 생성 및 프로젝트 업데이트 제출 |
| 대기 중인 프로젝트 편집 승인 또는 거부 | 대기 중인 프로젝트 업데이트 제안 처리 |
| BETA Mind, 승인된 콘텐츠 및 대기 중인 업데이트 읽기 | Mind 세부 정보 및 버전 읽기 |
| 활성 BETA Mind를 즉시 생성하고 콘텐츠 업데이트를 검토에 제출 | Mind 생성 및 Mind 업데이트 제안 제출 |
| 할당된 프로젝트 파일의 최신 상태 및 새로 고침 상태 확인 | 로컬 파일의 해시를 원격 할당과 비교 |
| 할당된 프로젝트 파일 새로 고침 승인 요청 | 오래된 로컬 프로젝트 파일을 교체하기 위한 승인 요청 생성 |
이러한 작업 중 어느 것도 로컬 파일을 직접 기록하지 않습니다. 파일 기록은 대상 기기의 별도 승인된 워크플로를 통해 이루어집니다.
압축을 푼 marketplace 루트에서 Codex 호스트 관리자로 직접 설치할 때 검증된 구문은 다음과 같습니다.
codex plugin marketplace add "$ROOT" --json
codex plugin add onemind --marketplace onemind-app --json
플러그인 지정자는 onemind이고 marketplace는 별도 --marketplace onemind-app 옵션입니다. 검증되지 않은 onemind@onemind-app 형식을 사용하지 마세요.