Autonomous Intelligence

AI 에이전트를 위한 트랜잭션 안전 로컬 액션 레이어.

Autonomous Intelligence는 MCP를 통해 기능 범위가 지정된 컴퓨터 액션을 노출하는 동시에 실행, 승인 및 충돌 복구를 별도의 로컬 Broker 뒤에 유지합니다.

시작하기 · 클라이언트 호환성 · MCP 도구 · 안전 모델 · 아키텍처 · 기여하기

왜 이 프로젝트가 필요한가

대부분의 데스크톱 에이전트 프로토타입은 확률적 계획을 강력한 운영 체제 기본 요소에 직접 연결합니다. 편리하지만 재시도, 충돌, 프롬프트 인젝션 및 모호한 UI 상태를 위험하게 만듭니다.

Autonomous Intelligence는 명확한 경계를 설정합니다:

• MCP 어댑터와 플래너는 신뢰할 수 없습니다.

• Broker는 정책과 액션 클래스를 독립적으로 도출합니다.

• 모든 부작용은 지속성 있는 작업과 시도로 표현됩니다.

• 쓰기 작업에는 정확하고 일회용 승인이 필요합니다.

• 복구는 재시도 전에 사후 조건을 확인합니다.

• 조정할 수 없는 효과는 UNCERTAIN이 되고 중단됩니다.

현재 릴리스는 작업 공간 파일 작업을 위한 의도적으로 좁고 생산 지향적인 수직 슬라이스를 제공합니다. Windows UI 자동화 및 브라우저 제어는 동일한 계약을 충족할 때만 추가됩니다.

주요 보장 사항

MCP 인터페이스

Autonomous Intelligence는 MCP v2 stdio 서버로 5개의 초점을 맞춘 도구를 제공합니다:

autonomous-intelligence://capabilities 리소스는 활성 작업 공간과 안전 경계를 설명합니다.

도구 실패는 MCP를 통해 is_error=true로 반환되어 호스트 모델이 오류 문자열을 성공으로 오인하지 않고 잘못된 경로나 인수를 수정할 수 있습니다.

클라이언트 호환성

서버는 모델에 구애받지 않으며 호스트 중립적입니다. stdio를 통해 MCP를 사용하며 특정 공급업체 LLM API를 호출하지 않습니다.

전역 및 프로젝트 범위 설치, 확인 명령 및 클라이언트별 승인 동작에 대한 완전한 다중 클라이언트 설정 가이드를 사용하세요.

아키텍처

flowchart LR
    H["MCP host / AI client"] --> M["Untrusted stdio MCP adapter"]
    M --> E[("Engine journal")]
    E -->|"Authenticated JSON IPC"| B["Execution Broker"]
    B --> U["Human approval"]
    B --> L[("Authoritative Broker ledger")]
    B --> X["Semantic action executor"]
    X --> W["Capability-scoped workspace"]
    E -->|"Status + reconcile"| B

Broker는 MCP 프로세스에 내장되지 않습니다. Broker를 사용할 수 없으면 도구가 직접 호스트 액세스로 폴백하는 대신 명시적으로 실패합니다.

시작하기

요구 사항

• Windows 10/11

• Python 3.11 이상

• Codex, ChatGPT 데스크톱 또는 기타 호환 클라이언트와 같은 MCP 호스트

소스에서 설치

git clone https://github.com/coldrazer/autonomous-intelligence.git
cd autonomous-intelligence

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

1. Broker 시작

쓰기 승인을 검토할 수 있도록 Broker를 표시 가능한 터미널에서 실행하세요:

autonomous-intelligence --workspace C:\path\to\allowed-workspace broker

Broker는 정확한 작업이 승인되지 않으면 기본적으로 쓰기를 거부합니다. --approval-mode allow는 일회용 자동화 테스트만을 위한 것입니다.

2. LLM 클라이언트 연결

지원되는 모든 호스트에 대한 구성을 파일을 수정하지 않고 생성하세요:

autonomous-intelligence --workspace C:\path\to\allowed-workspace `
  client-config claude

유효한 클라이언트 이름은 codex, claude, kimi, antigravity, gemini, cursor, vscode, generic입니다.

Codex의 경우 직접 등록 명령은 다음과 같습니다:

가상 환경이 활성화된 상태에서:

codex mcp add autonomous-intelligence -- `
  autonomous-intelligence-mcp `
  --workspace C:\path\to\allowed-workspace

등록을 확인하세요:

codex mcp get autonomous-intelligence
codex mcp list

MCP 구성을 변경한 후 로컬 Codex 클라이언트를 다시 시작하세요. ChatGPT 데스크톱 앱, Codex CLI 및 IDE 확장은 동일한 Codex MCP 구성을 공유합니다.

수동 구성의 경우 ~/.codex/config.toml에 다음을 추가하세요:

[mcp_servers.autonomous-intelligence]
command = "C:\\path\\to\\autonomous-intelligence\\.venv\\Scripts\\autonomous-intelligence-mcp.exe"
args = ["--workspace", "C:\\path\\to\\allowed-workspace"]
startup_timeout_sec = 20
tool_timeout_sec = 120
default_tools_approval_mode = "auto"

[mcp_servers.autonomous-intelligence.tools.autonomous_write_file]
approval_mode = "prompt"

일반 호스트 구성은 mcp-config.example.json에서도 사용할 수 있습니다. Claude Code, Kimi, Antigravity, Gemini CLI, Cursor, VS Code 및 일반 stdio 클라이언트에 대한 자세한 내용은 docs/CLIENT_SETUP.md를 참조하세요.

GitHub Container 패키지

컨테이너 기반 MCP 호스트는 서명된 다중 플랫폼 OCI 이미지를 가져올 수 있습니다:

docker pull ghcr.io/coldrazer/autonomous-intelligence:0.3.1

Windows 데스크톱 사용에는 기본 휠이 권장됩니다. 컨테이너 배포는 Broker와 MCP 어댑터를 공유 상태 볼륨으로 분리하여 실행합니다. 정확한 명령과 보안 경계는 컨테이너 가이드를 참조하세요.

직접 CLI

진단 CLI는 동일한 Engine, Broker, 정책 및 저널을 사용합니다:

# Read a workspace file
autonomous-intelligence --workspace C:\workspace read notes.txt

# Create a file; approval occurs in the Broker terminal
autonomous-intelligence --workspace C:\workspace write output.txt `
  --content "verified output"

# Recover attempts after a process restart
autonomous-intelligence --workspace C:\workspace recover

# Stop the Broker
autonomous-intelligence --workspace C:\workspace shutdown

안전 모델

디스패치 생명주기

Engine PREPARED
  → Broker ACCEPTED
  → approval issued and consumed when required
  → Broker IN_FLIGHT
  → semantic effect attempted
  → Broker DELIVERY_ATTEMPTED
  → typed postcondition evaluated
  → Engine VERIFIED

IN_FLIGHT는 의도적으로 보수적입니다: 전달 직전 충돌과 전달 직후 충돌은 조정 전까지 구분할 수 없습니다.

복구 동작

Autonomous Intelligence는 멱등성 키나 신뢰할 수 있는 조정을 제공하지 않는 임의 GUI 액션 또는 외부 시스템에 대해 정확히 한 번 실행을 보장하지 않습니다.

개발

개발 종속성을 설치하고 전체 테스트 스위트를 실행하세요:

python -m pip install -e ".[dev]"
python -m pytest

테스트는 다음을 포함합니다:

• 저널 상태 전환 및 재생 충돌

• 승인 거부, 만료, 바인딩 및 일회용

• 작업 공간 이스케이프 및 보호된 상태 경로

• 부작용 전후 충돌 복구

• MCP 스키마, 주석, 리소스 및 도구 오류 의미론

• 8가지 MCP 클라이언트 형식에 대한 호스트별 구성 렌더링

• 완전한 Windows 하위 프로세스 체인: MCP 클라이언트 → stdio 서버 → 명명된 파이프 → Broker → 작업 공간

와이어 및 복구 계약에 대한 자세한 내용은 docs/PROTOCOL.md를 참조하고, 현재 범위와 로드맵은 docs/IMPLEMENTATION_STATUS.md를 참조하세요.

로드맵

• 트랜잭션 Engine 및 권위 있는 Broker 원장

• 기능 범위가 지정된 의미론적 파일 액션

• MCP v2 stdio 어댑터

• Codex, Claude, Kimi, Antigravity, Gemini, Cursor 및 VS Code 설정 자산

• SBOM 및 출처 증명이 포함된 다중 플랫폼 GitHub Container 패키지

• Windows 명명된 파이프 통합 테스트

• 읽기 전용 Windows UI 자동화 관찰 어댑터

• 구조적 UI 지문 및 모호성 거부

• 인간 입력 경합 감지

• 출처 및 프레임 바인딩이 있는 브라우저 CDP 어댑터

• 강화된 Windows 서비스 ID, ACL 및 서명된 설치 프로그램

보안

배포하거나 취약점을 보고하기 전에 SECURITY.md를 읽어주세요. 현재 릴리스는 평가된 로컬 수직 슬라이스일 뿐, 무제한 자율 데스크톱 제어가 안전하다는 주장이 아닙니다.

기여

트랜잭션 및 정책 경계를 유지하는 기여를 환영합니다. CONTRIBUTING.md부터 시작하세요.

라이선스

MIT 라이선스 하에 배포됩니다.