CLI 빠른 시작

onemind CLI를 macOS 또는 Linux에서 설치하고, 인증하고, 첫 번째 Project를 연결합니다.

CLI로 저장소를 감지해도 설정 흐름에서 정확한 대상을 일반 Project에 명시적으로 바인딩하기 전에는 활성화되지 않습니다. onemind sync 전에 활성화를 완료하세요. 감지만으로 쓰기나 업로드 권한은 생기지 않습니다. 네이티브 BETA는 Project와 폴더를 따라 호환되는 연결 대상을 준비하며 업로드를 끈 상태로 둡니다.

macOS 또는 Linux 터미널에서 onemind를 사용하는 경우 이 페이지를 위에서 아래로 따르세요.

CLI 전용 설치 프로그램을 실행합니다. CLI, 서명된 연동 번들, 설치 바인딩, 백그라운드 서비스를 설치하고 검증합니다. macOS에서는 OneMind.app이나 OneMind BETA.app을 다운로드, 교체, 설정 또는 실행하지 않으며 AI 호스트 플러그인도 변경하지 않습니다.
저장소에서 onemind을 실행하고 로그인을 선택합니다.
AI 도구 가이드를 열고 연결 단계를 따르세요.
onemind sync을 실행합니다.
onemind status을 실행한 다음 AI 도구에서 새 세션을 시작하세요.

지원되는 시스템

BETA 0.4.15 릴리스 계약에는 다음 네이티브 CLI 빌드가 포함됩니다.

운영 체제	아키텍처
macOS	arm64, amd64
리눅스	arm64, amd64

Windows 구현은 실험적 소스 전용 상태입니다. 수동 네이티브 AMD64 및 ARM64 테스트는 있지만 공개 서명 아카이브나 설치 프로그램이 없으며 이 BETA의 지원 대상이 아닙니다. 게시되지 않은 PowerShell 설치 프로그램을 BETA 배포 경로로 사용하지 마십시오.

CLI에는 터미널, onemind 서버에 대한 네트워크 액세스, 작동 중인 운영 체제 자격 증명 저장소가 필요합니다. Linux 백그라운드를 사용하려면 사용 가능한 Secret Service/keyring 및 systemd --user이 필요합니다.

설치

공식 설치 프로그램은 최신 릴리스를 다운로드하고, SHA-256 체크섬 및 버전을 확인하고, 바이너리를 설치하고, 백그라운드 서비스를 등록합니다. 다시 실행하면 현재 버전이 안전하게 복구되거나 최신 버전이 설치됩니다.

공개 CLI 빠른 시작 명령은 CLI 전용입니다. macOS에서는 OneMind.app이나 OneMind BETA.app을 다운로드, 교체, 설정 또는 실행하지 않고 아래에 설명된 CLI 릴리스 구성 요소만 설치합니다. Intel Mac도 CLI만 설치하며 Intel용 메뉴 막대 앱은 아직 배포되지 않았습니다.

macOS와 리눅스

실행:

curl -fsSL https://onemind.team/downloads/install-onemind.sh | ONEMIND_INSTALL_APP=0 sh

이 CLI 전용 명령은 공개 서명 연동 번들을 별도로 다운로드하여 저장하고 정확한 바이트와 태그된 GitHub 릴리스 워크플로를 확인합니다. 새 설치에서는 해당 컴퓨터용 공식 Cosign v2.6.2 바이너리를 임시로 다운로드하고, 검토된 GitHub 릴리스 호스트로 향하는 HTTPS 리디렉션만 허용하며, 실행 전에 내장된 크기와 SHA-256을 확인합니다. 임시 검증기는 설치 프로그램 종료 시 삭제되고 Unix 설치에는 Python이 필요하지 않습니다. 설치 프로그램은 후보에서 파생된 바이너리를 실행하거나 자산 목록을 신뢰하기 전에 정규 형식의 릴리스 후보를 인증합니다. CLI, 번들, 설치 바인딩, 백그라운드 서비스를 설치하지만 OneMind.app이나 OneMind BETA.app을 다운로드, 교체, 설정 또는 실행하지 않습니다. 또한 Codex나 다른 AI 호스트 플러그인을 설치, 업데이트, 복구 또는 제거하지 않습니다. 호스트 변경은 onemind integrations install, update, repair, uninstall 명령을 명시적으로 실행해야 합니다. Apple 실리콘 및 Intel macOS와 Linux는 동일한 실패 폐쇄 번들 경로를 사용하며 앱 내장 복사본을 신뢰하지 않고 별도의 Cosign 설치도 필요하지 않습니다. 업그레이드는 연동 번들 검증에 기존에 설치된 검증기를 우선 사용합니다.

macOS 앱

BETA 0.4.15은 Apple Silicon Mac용 bundle ID com.onemind.beta의 OneMind BETA.app을 게시합니다. DMG와 업데이트 ZIP은 서명된 싱가포르 프로덕션 receipt로 인증되지만, 이번 릴리스는 Apple 계정을 사용하지 않으므로 앱 자체는 ad-hoc 서명이고 공증되지 않았습니다. 처음 열 때 Control-클릭 후 열기를 선택하고 macOS 경고를 확인해야 할 수 있습니다. BETA 앱은 별도의 Keychain 세션을 사용하며 설치된 Alpha OneMind.app을 교체하지 않습니다. ONEMIND_INSTALL_APP=0은 계속 CLI 전용 설치 경로입니다. 기존 ONEMIND_INSTALL_CODEX_PLUGIN 변수는 계속 거부되며 명시적인 연동 작업 없이는 설치 프로그램이 호스트 플러그인을 변경하지 않습니다.

Apple Silicon Mac에 CLI와 별도의 BETA 앱을 함께 설치하려면 다음을 실행하세요.

curl -fsSL https://onemind.team/downloads/install-onemind.sh | ONEMIND_INSTALL_APP=1 sh

기본 설치 위치는 ~/.local/bin/onemind입니다. 설치 프로그램에서 디렉터리가 PATH에 없다고 말하면 해당 디렉터리를 셸 구성에 추가하고 새 터미널을 엽니다. zsh의 경우:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

설치 확인

onemind version

예상 출력:

onemind 0.4.15

정확한 버전 번호는 설치된 릴리스에 따라 다릅니다.

Codex Plugin

onemind 설치 프로그램은 Codex 플러그인을 설치하거나 업데이트하지 않습니다. onemind 설치 후 수동 변경이 없는 onemind integrations list --json을 실행하여 Codex 상태를 확인하고, 필요한 경우에만 onemind integrations install codex, update codex, repair codex를 명시적으로 실행하세요. 설치만으로 Codex가 onemind 계정에 인증 연결되지는 않습니다.

onemind integrations install codex는 번들 onemind-app marketplace와 Codex 플러그인만 설치합니다. 이 제한된 작업은 CLI 설치 또는 복구, macOS 앱 교체, 서비스 재시작 또는 앱 열기를 하지 않습니다. CLI 구성 요소에는 CLI 빠른 시작을 사용하고 macOS 앱을 명시적으로 원하는 경우에만 별도로 표시된 전체 앱 옵트인을 사용하세요.

새 Codex 작업을 시작하고 @OneMind를 멘션합니다. 처음 사용할 때 onemind 연결을 선택하고 onemind 웹사이트에 로그인한 다음 요청된 OAuth 권한을 검토하고 연결을 승인합니다. 이 단계를 마쳐야 Codex가 실제로 연결되어 클라우드 상태, 승인된 메모리 및 동기화 요청을 사용할 수 있습니다. 로컬 CLI 업데이트와 서비스 제어에는 해당 장치에 설치된 CLI가 계속 필요합니다.

첫 번째 실행 및 로그인

연결하려는 저장소에서 onemind를 시작합니다.

cd /path/to/your/repository
onemind

로그아웃하면 팔레트에 로그인 및 업데이트 확인이 표시됩니다.

로그인을 선택하고 Enter 키를 누릅니다.
onemind는 브라우저에서 인증 페이지를 엽니다.
웹사이트에 로그인한 후 요청 단말기를 승인하세요.
터미널로 돌아갑니다. onemind는 운영 체제의 자격 증명 저장소에 세션을 저장하고 승인된 계정 및 장치를 보고합니다.
명령 팔레트로 돌아가려면 Esc 키를 누르세요.

브라우저 요청이 시간 내에 완료되지 않으면 만료됩니다. 새로운 요청을 생성하려면 로그인을 다시 선택하세요. 귀하의 비밀번호는 CLI에 입력되지 않습니다.

로그인 후, 현재 디렉터리를 AI 도구의 Project 대상으로 감지합니다. Codex의 경우:

onemind project codex /path/to/your/repository

onemind는 확인 메시지를 출력하고 대상을 비활성 상태로 표시합니다. onemind BETA 앱이나 웹의 동기화 설정을 완료하여 감지된 디렉터리를 일반 Project에 바인딩하세요. 바인딩 후 onemind sync를 실행하세요. 감지만으로 쓰기나 업로드 권한은 생기지 않습니다. 동기화 설정이 완료될 때까지 onemind sync는 오류를 출력합니다. 도구별 감지 명령은 AI 도구 가이드에서 해당 AI 도구의 가이드를 참고하세요.

macOS 메뉴 막대에 대해서는 macOS 앱을 참고하세요.

macOS에서 onemind를 실행할 때 "OneMind is running in Terminal, but the menu-bar app is not installed. Re-run the official installer to add it."라는 메시지가 표시되면, 설치 프로그램이 CLI와 함께 macOS 앱을 설치하지 않은 것입니다. 위의 ONEMIND_INSTALL_APP=1 설치 명령을 사용하거나 메시지를 무시하세요. CLI 동기화에는 영향을 미치지 않습니다.