AIOS
Release
AIOS documentation and guides on cli.rexai.top
RexAI content hub for AI agent essays on rexai.top
AIOS local-first agent control plane architecture on cli.rexai.top
License
Node
장기 코딩 에이전트를 위한 로컬 우선 제어 평면(The local-first control plane for long-horizon coding agents).
AIOS는 AI 코딩 에이전트가 부족한 부분을 채워줍니다 — 세션 간 프로젝트 메모리, 다중 에이전트 팀 구성, 재개 가능한 야간 실행, 그리고 모든 변경 사항에 대한 검증 가능한 증거입니다. 단 하나의 문장으로 어떤 복잡한 작업이든 완료합니다.
본 프로젝트의 공식 정보: 문서 사이트는 cli.rexai.top이며 (영어, 중국어, 일본어, 한국어), 버전별 릴리스 블로그는 cli.rexai.top/blog이고, 작성자의 장문 AI 에이전트 에세이는 rexai.top (RexAI 콘텐츠 허브)에서 확인할 수 있습니다. 이 GitHub 저장소는 두 곳의 출처가 됩니다.
이미 사용하고 있는 에이전트 위에서 작동합니다 — Codex CLI, Claude Code, Gemini CLI, OpenCode, Hermes, Grok, WorkBuddy, Pi, ZCode 등. AIOS는 또 다른 에이전트 프레임워크가 아닙니다: 사용자의 에이전트는 그대로 유지되며, AIOS가 그 주변에 메모리, 조정(coordination), 그리고 검증 계층을 추가합니다. 모든 것이 로컬에서 실행됩니다.
AIOS란? · 30초 만에 설치하기 · 증명 · AIOS 문서 · 릴리스 블로그 · RexAI 콘텐츠 허브 (중국어) · 중국어 README
AIOS architecture overview
AIOS란 무엇인가 (Why AIOS)
사용자의 AI 코딩 에이전트는 똑똑하지만 — 세션 간의 모든 것을 잊고, 스스로 다단계 작업을 조정할 수 없으며, 자신의 출력을 검증할 방법이 없습니다. 장기적인 작업(대규모 리팩토링, 릴리스 핸드오프, 야간 실행)은 단일 세션 에이전트가 끝나는 지점에서 무너집니다. AIOS는 이 문제를 해결합니다:
| 사용자 요청 | AIOS의 동작 |
|---|
| "인증 모듈을 리팩토링해 줘" | 지난주 결정 사항을 기억하고, 적절한 접근 방식을 선택하며, 변경사항을 적용하고, 작동 여부를 검증합니다. |
| ... | |
| 사용자 데이터는 로컬에 유지됩니다. 메모리, 로그, 검증 증거 등 모든 것이 사용자의 장치에서 실행됩니다. 외부로 나가는 것은 없습니다. | |
작업 방식은 변경되지 않습니다. 기존에 사용하던 코딩 클라이언트를 계속 사용하세요. AIOS가 부족한 제어 평면(control plane)을 추가해 줍니다.
30초 만에 설치하기
macOS / Linux:
curl -fsSL https://github.com/rexleimo/aios/releases/latest/download/aios-install.sh | bash
source ~/.zshrc
aios init --all
...
Windows PowerShell:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://github.com/rexleimo/aios/releases/latest/download/aios-install.ps1 | iex
. $PROFILE
...
프로젝트 수준의 가이던스와 메모리를 원할 때는 프로젝트 루트에서 이 명령들을 실행하세요.
자동 설치(Unattended install):
node scripts/aios.mjs init --all --yes-compression-tools --yes-headroom-mcp
토큰 인텔리전스(Token intelligence)는 동일한 명령으로 제공됩니다: AIOS가 RTK (https://github.com/rtk-ai/rtk — 명령어 출력을 60~90% 압축하는 Rust CLI 프록시)와 Caveman (https://github.com/JuliusBrussee/caveman — 에이전트 출력을 약 75% 압축하는 Claude Code 스킬)를 감지하고 설치한 다음, 명시적인 압축 및 검색 제어를 위해 Headroom MCP를 연결합니다. 이 세 가지 모두 로컬에서 실행되므로, AIOS는 자체 인터셉션 런타임을 더 이상 포함하지 않습니다.
준비가 완료된 시점:
aios doctor --native --verbose 명령을 실행했을 때 클라이언트가 감지 및 동기화되었다고 보고하는 경우- 프로젝트 루트에
.aios/context-db/index.json 파일이 존재하는 경우
aios memo search "anything" 명령이 오류 없이 응답하는 경우
다음 단계는 어디로 가야 할까요
방금 AIOS를 설치했으므로, 이 저장소(repo)를 떠나 가장 높은 가치를 얻을 수 있는 순간입니다. GitHub 외부의 세 가지 경로가 있습니다:
약속이 아닌 증명으로
에이전트의 주장은 저렴하기 때문에, AIOS는 사용자가 그 어떤 것도 신뢰할 필요가 없도록 구축되었습니다:
- 모든 실행은 증거를 남깁니다. Harness 실행은 명령, 종료 코드(exit codes), 해시(hashes), 테스트 출력 등 '확실한 보장'이 아닌
.aios/ 아래에 기록된 증거 봉투(evidence envelopes)를 생성합니다. Solo Harness를 확인해 보세요.
- 프로젝트가 스스로 검증합니다. 모든 릴리스는 스크립트 테스트 스위트와 엄격한
typecheck && test && build 게이트를 통과하며, changelog에는 무엇이 왜 변경되었는지 기록됩니다.
- 설치 환경은 검사 가능합니다.
aios doctor --native --verbose는 감지되거나 동기화되거나 건너뛴 내용이 정확히 무엇인지 보고합니다. 은밀한 부작용(silent side effects)은 없습니다.
- 메모리는 검사 가능합니다. ContextDB는 풀 기반(pull-based)이며 로컬입니다:
aios memo search로 에이전트가 기억하는 내용을 검색할 수 있으며, 아무것도 사용자의 기기를 벗어나지 않습니다.
AIOS는 Rex에 의해 공개적으로 유지 관리되고 있습니다—릴리스 기록을 통해 꾸준히 배포되고 검증된 변경 사항의 주기를 확인할 수 있습니다.
전체 구조
당신의 코딩 클라이언트 (codex / claude / gemini / opencode / hermes / grok)
│
▼
...
Workflow policy routes
rex-harness는 AIOS에 필수적인 플래닝 런타임(planning runtime)입니다. 릴리스 설치 프로그램에는 이미 고정된 서브모듈이 번들되어 있으므로, 일반적인 릴리스 설치 시 두 번째 npm 패키지나 MCP 서비스가 필요하지 않습니다. 소스에서 작업하는 경우:
git clone --recurse-submodules https://github.com/rexleimo/aios.git
만약 클론 과정에서 서브모듈이 건너뛰어졌다면, aios init / aios setup은 git submodule update --init --recursive -- rex-harness를 시도하고 복구에 실패할 경우 명확한 수정 사항과 함께 중단됩니다.
Rex는 새 설치의 기본 워크플로우입니다. Superpowers는 AIOS 워크플로우 구성 요소에서 단종되었습니다. Rex Workflow Migration 가이드를 참조하세요.
Quick tour
프로젝트 마커는 클라이언트를 .aios/context-db/index.json으로 지정합니다. ContextDB는 **풀 기반(pull-based)**입니다: 에이전트가 매 프롬프트마다 전체 기록을 받는 대신, 관련 자료를 검색하거나 회상합니다.
ContextDB memory loop
Supported clients
지원되는 코딩 클라이언트를 위한 네이티브 또는 호환성 통합 기능입니다—어디서든 동일한 프로젝트 메모리, 동일한 워크플로우 정책, 동일한 검증 증거를 제공합니다:
codex · claude · gemini · opencode · hermes · grok (Grok Build) · workbuddy (CodeBuddy CLI) · pi (Pi coding agent) · zcode (ZCode desktop + bundled CLI) · qoder (Qoder IDE + CLI)
기능 깊이는 클라이언트마다 다릅니다. 모든 경로가 어디에나 존재한다고 가정하는 대신 aios doctor --native --verbose를 실행하세요.
Documentation map
Author & ecosystem
AIOS는 Rex ([@rexleimo])에 의해 구축 및 유지 관리되고 있으며, 이 개발자는 RexAI Content Hub에서 AI 에이전트, Rust, 시스템 엔지니어링에 대해 글을 쓰고 있습니다 (중국어: 梦兽编程).
| 사이트 | 내용 |
|---|
| cli.rexai.top | AIOS 문서, 가이드 및 블로그 |
| ... | |
| 질문이나 피드백이 있나요? Open an issue를 여세요. 만약 AIOS가 하룻밤 작업을 절약해 주었다면, ⭐ 별표는 다른 빌더들이 이 도구를 찾도록 돕습니다. | |
Requirements
- Git
- Node.js 24 LTS 및 npm
- Windows: PowerShell 5.x 또는 7
- 최소 하나 이상의 지원되는 코딩 클라이언트
Development
git clone --recurse-submodules https://github.com/rexleimo/aios.git
cd aios
npm run test:scripts
...
Canonical Skill이 변경될 때, 커밋하기 전에 훈련 증거를 인증하고 검증하십시오:
node scripts/aios.mjs skill certify --changed --base HEAD --json
node scripts/aios.mjs skill verify-training --changed --base HEAD --json
하위 프로젝트 (Subprojects)
| 경로 (Path) | 역할 (Role) |
|---|
rex-harness/ | 독립형 소프트웨어 엔지니어링 제어 평면 (사실(Fact) / 역량(Capability) / 증거(Evidence)) |
mcp-server/ | 레거시 Playwright MCP 호환성 경로; 기본 브라우저 경로는 browser-use CDP를 사용합니다. |
라이선스 (License)
MIT License에 따라 라이선스가 부여됩니다.
Copyright (c) 2026 Rex.
본 소프트웨어는 원본 저작권 고지 및 허가 고지가 모든 복사본 또는 실질적인 부분에 유지되는 것을 조건으로, 파생 저작물을 포함하여 사용, 수정 및 배포할 수 있습니다.
