CLI 서비스 및 파일

onemind CLI가 사용하는 백그라운드 서비스, 로컬 상태 파일, 환경 변수를 설명합니다.

백그라운드 서비스

설치 프로그램은 사용자별 서비스를 등록합니다.

• macOS: ~/Library/LaunchAgents/com.onemind.cli.daemon.plist의 LaunchAgent
• 리눅스: ~/.config/systemd/user/onemind.service의 systemd 사용자 서비스

다음을 통해 확인하세요:

onemind service status

다음을 사용하여 다시 시작하세요.

onemind service stop
onemind service start

바이너리를 이동하거나 설치를 복구한 후 해당 정의를 다시 만듭니다.

onemind service install

macOS에서는 데몬 출력이 ~/Library/Logs/OneMind/daemon.log(표준 출력) 및 ~/Library/Logs/OneMind/daemon-error.log(오류 출력)에 기록됩니다.

Mind 라이브러리

Mind 라이브러리는 팀의 공유 저장 할당량 아래에 있는 Project 범위의 비공개 파일 공간입니다. 기본적으로 모든 onemind files 작업은 현재 작업 디렉터리를 포함하는 가장 구체적인 활성 일반 Project binding을 선택합니다. Team Project로 자동 전환하는 대신 실패 폐쇄 방식으로 작동합니다. Team Project가 의도된 경우에만 --team을 사용합니다. 동일한 파일은 onemind BETA 앱의 Mind 라이브러리 페이지에서도 확인할 수 있습니다.

전체 라이브러리와 해당 할당량 요약을 나열하려면 onemind files을 사용하세요. 하나의 디렉터리형 경로를 검사하려면 --prefix를 추가하고, 컴퓨터에서 읽을 수 있는 출력을 위해서는 --json를 추가하세요:

onemind files
onemind files list --prefix skills/writing
onemind files list --prefix assets --json
onemind files list --team

관리형 AI 지침에서 사용하는 최소 작업별 최신성 확인을 위해 다음을 실행하세요:

onemind files check --quiet --wait --ai codex

백그라운드 서비스는 시작, 관련 서버 이벤트, 인증 또는 네트워크 재연결, 그리고 백오프를 적용한 15분 저빈도 폴백에서 할당된 파일을 확인합니다. AI 개입 없이 승인 요청을 생성하거나 재사용합니다. 관리되는 지침은 할당된 상대 경로를 나열하며, 다중 도구 Project 디렉터리의 모호성을 해소하기 위해 항상 --ai로 정확한 호출 대상을 지정합니다. 명령은 해당 binding과 정확히 일치하는 projectIDs와 aiTargets 할당이 있는 파일만 검색합니다. 로컬 일반 파일을 해시하고 심볼릭 링크와 특수 파일을 거부하며 메타데이터만 서버로 전송합니다. 진행 중인 대기는 완전히 조용합니다. 승인 시 Updated <path>.만 출력하며, 거절은 project_file_refused를 출력하고 종료 코드 3으로 종료하여 해당 파일에 의존하는 작업을 중단합니다. 자동 재시도하지 않아야 합니다. 요청에서 파생된 네트워크/서버 재시도 예산 소진 시 project_file_wait_exhausted를 출력하고 종료 코드 4로 종료하며 자동 재시도도 금지됩니다. 보류는 영구 요청이 대기 중인 동안 0이 아닌 상태로 종료합니다. 종료 코드 0 후 호출자는 내용을 사용하기 전에 새로 고친 로컬 파일을 읽어야 합니다.

관리형 확인 대상 키: codex, cursor, qoder, claude_code, antigravity, openclaw, opencode, hermes, pi, grok_build, deepseek_harness, trae, workbuddy. Mind 할당 업로드 대상 키: codex, cursor, qoder, claude_code, antigravity, openclaw, opencode, hermes, pi, grok_build, deepseek_harness, trae, workbuddy.

오래된 파일은 하나의 장치 범위 요청을 생성하거나 재사용합니다. onemind BETA 앱의 Project 파일 업데이트 페이지에서 승인, 거절, 보류 또는 취소를 선택할 수 있습니다. 공개 상태는 pending, refused, approved_awaiting_apply, applied, expired, conflict, failed만 사용하며 보류는 상태를 pending으로 유지합니다. 상태 대기는 빈번한 폴링이 아닌 인증된 제한형 롱 폴링과 재연결 백오프를 사용합니다. 단일 승인 후 단일 쓰기 실행기는 두 해시와 선택된 Project 헤드를 재검증하고 다운로드한 콘텐츠를 확인하며, checkout 외부의 onemind 소유 애플리케이션 상태에 정확한 복구 사본을 보존하고, 플러시된 형제 임시 파일로 교체한 뒤 결과를 확인합니다. 로컬, 원격, binding, 심볼릭 링크, 특수 파일 또는 만료 변경 시 실패 폐쇄 방식으로 작동합니다. 대기 명령을 종료해도 요청이 취소되지 않으므로 서비스는 나중에 승인을 적용할 수 있습니다.

적용된 ID는 운영 체제의 onemind 애플리케이션 상태 디렉터리 아래의 버전화된 체크포인트 매니페스트에 기록됩니다. 로컬 요청/교체 증거와 복구 사본은 Project checkout이 아닌 해당 디렉터리 옆에 저장됩니다. 진행 중인 적용은 충돌 시 동일한 일회성 승인을 재청구하거나 재개할 수 있도록 장치 바인딩 시도 ID, 확인 멱등 키, 협상된 프로토콜, 단계, 순환 단기 임대를 mode 0600 매니페스트에 영구 저장합니다. 레거시 서버 grant는 두 번째 청구 없이 영구적으로 재개됩니다. terminal 체크포인트는 비밀을 제거하며 복구 저장소는 100 MiB로 제한되고 보호되지 않은 사본은 7일 후 삭제됩니다.

Mind 경로는 슬래시로 구분된 상대 경로입니다. 업로드마다 --ai가 필요하며 파일을 사용할 AI 대상을 명시합니다. 위의 Mind 할당 업로드 대상 키를 사용하고 여러 대상은 --ai codex,cursor처럼 쉼표로 구분합니다. --to 없이 단일 파일을 제출하면 로컬 파일 이름이 사용됩니다. 예를 들어, 다음은 ChatGPT(codex)와 Cursor용 release-review.md을(를) 제안합니다.

onemind files upload --ai codex ./release-review.md

명시적인 Mind 경로를 선택하려면 --to을 사용하세요. 프롬프트 파일은 일반적으로 prompts/ 아래에 보관됩니다.

onemind files upload --ai codex,cursor --to prompts/release-review.md ./release-review.md

디렉터리는 재귀적으로 업로드됩니다. --to은(는) Mind 대상 루트이며 모든 하위 항목은 상대 경로를 유지합니다. 다음과 같은 로컬 기술 디렉터리가 제공됩니다.

writing/
├── SKILL.md
├── examples/
│   └── example.json
└── references/
    └── style.md

다음을 사용하여 업로드하세요.

onemind files upload --ai codex,claude_code --to skills/writing ./writing

검토 대기열에는 skills/writing/SKILL.md, skills/writing/examples/example.json 및 skills/writing/references/style.md의 변경 제안이 들어갑니다. 디렉터리 사전 검사에서 지원되지 않는 형식을 찾으면 파일을 제출하기 전에 업로드가 중지됩니다.

--to이 없으면 디렉터리는 로컬 디렉터리 이름을 Mind 루트로 사용합니다. 서버는 제출된 각 파일을 승인된 Mind main과 비교합니다. 존재하지 않는 경로는 "새 파일", 기존 경로의 변경은 "새 버전"으로 분류하며, 내용이 같으면 변경 없음으로 보고하고 제안을 만들지 않습니다. 새 파일과 새 버전 제안은 관리자가 선택한 프로젝트의 Mind 라이브러리 페이지에서 명시적으로 승인하거나 거부할 때까지 대기합니다.

여러 파일 제안은 순차적으로 제출됩니다. 이후 파일이 실패하면 이전 제안은 대기 상태로 남지만 승인된 Mind main은 변경되지 않습니다. 오류를 해결하고 라이브러리 페이지의 대기열을 확인한 후 명령을 다시 실행하십시오. 완전히 동일한 재시도는 기존 대기 제안을 재사용하며 중복을 만들지 않습니다. 승인할 때만 변경 불가능한 Mind 커밋이 추가되고, 이전 버전이 프로젝트 기록에 보관되며, 할당량 사용이 업데이트됩니다.

다운로드는 하나의 정확한 Mind 파일을 처리합니다. --output이 없으면 CLI는 현재 디렉터리에 Mind 파일의 기본 이름을 씁니다. --force이 없으면 기존 로컬 파일 덮어쓰기를 거부합니다.

onemind files download skills/writing/SKILL.md
onemind files download --output ./writing-SKILL.md skills/writing/SKILL.md
onemind files download --force --output ./writing-SKILL.md skills/writing/SKILL.md

삭제에는 항상 --yes이 필요합니다. --recursive이 없으면 경로는 하나의 파일과 정확히 일치해야 합니다. --recursive를 사용하면 삭제에는 / 경로 세그먼트 경계 뒤의 정확한 경로와 하위 항목이 포함됩니다. 비슷한 이름의 형제 접두사가 선택되지 않았습니다.

onemind files delete --yes prompts/release-review.md
onemind files delete --recursive --yes skills/writing

재귀 삭제도 순차적으로 실행되며 원자적이지 않습니다. 나중에 삭제가 실패하면 작업에서 이전에 삭제된 파일은 삭제된 상태로 유지됩니다. 나머지 접두사를 검사하고 오류를 해결한 후 확인된 동일한 명령을 다시 실행하여 정리를 완료합니다.

라이브러리 파일은 비활성 저장소입니다. 프롬프트 파일을 업로드해도 활성 프로젝트 Mind 변경, 팀 메모리 게시, 제안과 관리자 검토 우회가 발생하지 않습니다. 스킬, 스크립트, 후크, 자산도 업로드만으로 설치되거나 실행되지 않습니다. onemind sync는 스킬을 변경하지 않습니다. onemind skills status 후 읽기 전용 onemind skills resolve NAME으로 최신 스킬의 검증된 SKILL.md 경로를 얻을 수 있지만 호스트의 작업 시작 시 스킬 목록이 갱신되었다고 주장하지 않습니다. install, update, uninstall은 정확한 이름을 명시적으로 선택하세요. onemind는 다운로드, 로컬 변경, Project 경계를 검증하고 복구 가능한 격리와 감사 기록을 유지합니다.

onemind 업데이트

릴리스를 읽기 전용으로 확인하려면 onemind update --check를 실행하십시오. 업데이트 확인 팔레트 액션은 동일한 읽기 전용 확인을 실행합니다. 인수 없는 onemind update는 공식 서명 설치 프로그램 안내를 표시하고, 아무것도 변경하지 않은 채 안정적인 작업 필요 상태 3으로 종료하여 자동화가 업데이트 완료로 잘못 판단하지 않게 합니다. 두 경로 모두 서비스를 중지하거나 시작하지 않고, 아티팩트를 다운로드하거나 CLI 바이너리를 교체하지 않으며, 로컬 상태도 변경하지 않습니다.

백그라운드 서비스는 시작 시 및 6시간마다 새 릴리스를 확인하고, 더 새로운 버전이 발견되면 표준 오류에 한 줄의 알림을 출력하며 macOS 및 Linux에서는 데스크톱 알림을 전달합니다. 동일한 버전에 대한 알림은 반복되지 않습니다.

릴리스를 설치하려면 CLI 빠른 시작의 운영 체제용 공식 설치 명령을 다시 실행하십시오. 공개 macOS/Linux 업데이트 명령은 CLI 전용이며 ONEMIND_INSTALL_APP=0을 사용합니다. macOS에서는 OneMind.app이나 OneMind BETA.app을 다운로드, 교체, 설정 또는 실행하지 않습니다. 공식 설치 프로그램은 CLI, 서명된 AI 도구 연동 번들, 설치 바인딩을 함께 업데이트하지만 AI 호스트 플러그인은 변경하지 않습니다. CLI 바이너리만 교체하면 완전한 서명 릴리스가 설치될 때까지 연동 상태가 repair_required가 될 수 있으므로 단독으로 교체하지 마십시오. 이후 수동 변경이 없는 onemind integrations list --json을 실행하고 필요한 작업을 보고하는 대상만 명시적으로 설치, 업데이트 또는 복구하세요.

파일 및 로컬 상태

동일한 Project와 루트의 모든 활성 도구 binding은 이 대기열을 공유합니다. 데몬의 결정적 binding 선택은 업로드 인증 경로에만 사용됩니다. schema v11 LearningEvent에는 생성 도구 신원이 없으며 제안 응답도 생성 도구 신원을 완전히 생략합니다. 이 부재는 생성자를 귀속할 수 없다는 뜻이지 선택된 업로드 도구가 이벤트를 생성했다는 뜻이 아닙니다. 보존되는 기기와 계정은 인증된 제출 경로와 제출자만 식별하며 생성 프로세스를 식별하지 않습니다.

관리되는 마커를 직접 편집하지 마십시오.