AIOS Windows 업데이트: 단순 “시작 문제”가 아니라, 크로스-CLI 신뢰성 체인 전체를 지키는 변화¶
이번 업데이트는 일반적인 Windows 팁이 아니라, AIOS 코어 아키텍처와 직접 연결되어 있습니다.
빠른 결론¶
AIOS는 서로 연결된 3개의 레이어로 구성됩니다.
- 브리지 레이어:
contextdb-shell-bridge.mjs가 wrap vs passthrough 를 결정 - 세션 레이어:
ctx-agent가 ContextDB 세션 컨텍스트를 주입/재사용 - 실행 레이어: 네이티브 CLI(
codex/claude/gemini)는 그대로 실행
Windows cmd 기반 런처 수정은 1번 레이어에 들어갔지만, 결과적으로 전체 체인을 보호합니다.
왜 AIOS 관점에서 중요한가¶
AIOS가 없다면 .cmd 시작 이슈는 대부분 “CLI가 안 켜진다” 수준의 문제입니다.
하지만 AIOS에서는 같은 이슈가 아래까지 깨뜨립니다.
- 컨텍스트 연속성(
session -> context:pack -> inject) - 래퍼 정책 동작(
repo-only/opt-in/all) - 안정적인 엔트리를 전제로 하는 orchestrate 플로우
즉, 단순한 셸 트윅이 아니라 “크로스-CLI 워크플로 계약”을 지키는 문제입니다.
무엇이 바뀌었나¶
공유 프로세스 런처 + contextdb-shell-bridge 경로에서, Windows cmd 기반 실행이 더 안전해졌습니다.
- npm/cmd 런처 해석이 더 견고
- 래퍼 엔트리포인트를 못 찾는 경우에도 안전하게 폴백
- 가능하면 네이티브 실행 파일을 계속 우선
Codex/Claude/Gemini 래퍼 시작 경로를 커버합니다.
60초 재현/검증¶
최신 main 을 받고 터미널을 재시작한 뒤:
codex
브리지 라우팅 진단:
export CTXDB_DEBUG=1
codex
기대 결과:
- cmd 래퍼 엣지 케이스에서도 시작이 실패하지 않음
- 브리지가 wrap/passthrough 를 계속 올바르게 판단
- 일상 커맨드를 바꾸지 않고 컨텍스트 기반 워크플로가 유지됨
엔드투엔드 가치(AIOS 관점)¶
이 수정이 지키는 체인:
shell wrapper -> contextdb-shell-bridge -> ctx-agent -> contextdb -> native CLI
Windows에서 한 링크라도 끊기면 “메모리 있는 크로스-CLI” 약속이 깨집니다. 이번 업데이트는 그 링크를 강화합니다.
FAQ¶
명령어를 바꿔야 하나요?¶
아니요. codex / claude / gemini 를 그대로 쓰면 됩니다.
시작 문제만 고친 건가요?¶
아니요. 시작 레이어의 수정이지만, AIOS에서는 wrap과 세션 컨텍스트 주입이 그 엔트리 경로에 의존하므로 워크플로 전체에 영향을 줍니다.
토큰 사용량이 바뀌나요?¶
모델 정책 자체는 바뀌지 않습니다. 프로세스 신뢰성과 래퍼 동작의 안정화입니다.