SyntheticAutonomicMind/CLIO

터미널 네이티브 AI 개발 에이전트 및 확장 가능한 에이전트 하네스. 모델이 추론을 수행하고, CLIO는 도구(tools), 컨텍스트(context), 세션 상태(session state), 그리고 복구 기능을 제공합니다. (recovery.)**

제가 CLIO를 직접 만들었습니다. 저는 GUI를 사용하는 시간보다 터미널 세션에서 보내는 시간이 더 많고, 제가 일하는 방식대로 작동하는 AI 코딩 도구를 원했습니다. 그런 것이 실제로 존재하지 않아 제가 구축하게 되었습니다. v20260119.1부터 CLIO는 스스로 발전해 왔습니다. SAM, CLIO, 그리고 ALICE의 모든 개발은 CLIO와의 페어 프로그래밍을 통해 이루어집니다.

CLIO에 작업을 맡기면 엔드투엔드로 작동합니다. 코드베이스를 조사하고, 계획을 제안하며, 승인 후 구현하고, 테스트를 실행하며, 커밋까지 합니다. 코드를 읽고, 여러 모듈에 걸쳐 파일을 편집하며, 이해도를 가지고 검색하고, 셸 명령(shell commands)을 실행합니다. 작업 도중에 아무 키나 누르면 중단할 수 있고, 다음 세션에서 중단했던 지점부터 이어서 진행됩니다.

CLIO는 Perl 기반의 에이전트 하네스로, Perl이 실행되는 모든 곳에서 작동합니다. CPAN도, pip도, npm도 필요 없습니다. 핵심 Perl과 표준 Unix 도구만 있으면 됩니다. GitHub Copilot, OpenAI, Anthropic, Google Gemini, DeepSeek, OpenRouter, MiniMax, Z.AI, NVIDIA NIM, Opper를 포함한 20개의 AI 제공업체를 지원하며, llama.cpp나 LM Studio를 통해 로컬 모델도 지원합니다. 또한 모든 OpenAI 호환 엔드포인트(endpoint)를 지정할 수 있습니다.

전체 아키텍처 개요—6계층 보안 모델(six-layer security model), 메모리 시스템(memory system), 다중 에이전트 조정(multi-agent coordination)—그리고 모든 조각들이 어떻게 결합되는지에 대해서는 웹사이트에 상세한 설명이 있습니다. 이 README를 통해 사용을 시작할 수 있습니다.

구체적인 목록은 다음과 같습니다—CLIO를 사용할 때 발생하는 일들:

수정 전에 조사합니다. CLIO는 변경 사항을 제안하기 전에 코드베이스를 검색하고, 파일을 읽고, 이해도를 구축합니다. 추측하지 않습니다.
Undo 기능으로 파일을 편집합니다. 모든 변경 사항은 file_operations를 통해 경로 권한(path authorization)과 함께 작성됩니다. 모든 편집 내용은 백업됩니다—/undo

임의의 턴을 되돌리고, 마지막 턴만 되돌리는 것이 아닙니다. 테스트를 실행하고 git 작업을 수행합니다. 커밋(commits), 브랜치(branches), 스태시(stashes) 및 푸시(pushes)를 합니다. 테스트 실패는 다음 반복을 위해 다시 피드백됩니다.세션 간에 기억합니다. CLIO는 발견 사항, 해결책, 코드 패턴을 장기 메모리에 저장합니다. 동일한 프로젝트의 다음 세션은 지난번에 학습된 내용부터 시작됩니다.병렬 작업을 조정합니다. 파일 및 git 잠금(locks)이 있는 서브 에이전트를 생성하여 여러 에이전트가 서로 방해받지 않고 같은 리포지토리에서 작업할 수 있게 합니다. 이들은 유닉스 소켓 메시지 버스를 통해 통신합니다.플릿 전체에서 실행됩니다. 모든 머신에 SSH로 접속하여 CLIO를 배포하고, 작업을 실행한 다음, 결과를 로컬 세션으로 받습니다. 또는 전체 플릿에 걸쳐 병렬로 배포할 수도 있습니다.터미널과 통합됩니다. tmux, GNU Screen 또는 Zelli 창에 실시간 에이전트 출력을 제공합니다. 자동 감지되어 - 없어도 작동합니다.설계상 개인 정보 보호를 유지합니다. 시크릿 제거(Secret redaction)는 API 키, 토큰 및 비밀번호를 AI 컨텍스트에서 모델에 도달하기 전에 제거합니다. 프로젝트 디렉토리 외부의 파일 접근은 승인이 필요합니다. 프롬프트 주입을 숨길 수 있는 보이지 않는 유니코드 문자는 자동으로 필터링됩니다.필요할 때 샌드박싱(Sandboxes)합니다. --sandbox는 웹, 원격 및 에이전트 액세스를 차단하고 파일 작업을 프로젝트 디렉토리로 제한합니다. 진정한 격리를 위해 clio-container는 Docker에서 CLIO를 --cap-drop ALL과 함께 실행합니다.자신을 구축합니다. CLIO는 v20260119.1 이후 AI 지원 개발을 통해 자체 코드베이스인 ALICE와 SAM을 유지해 왔습니다. CLIO는 모델에 9개의 도구를 노출합니다. 3개는 구성(config)에 따라 조건부로 로드됩니다. MCP 및 플러그인 도구는 동적으로 로드됩니다.

조건부: remote_execution, agent_operations, skill_operations.

lib/CLIO/Providers.pm에서 20개의 프로바이더가 구성되어 있습니다. Anthropic, Google, 그리고 NVIDIA는 네이티브 프로토콜 어댑터를 사용하며, 나머지 모든 것은 OpenAI와 호환되거나 Copilot 형식을 따릅니다.

| 프로바이더 (Provider) | 인증 방식 (Auth) | 참고 사항 (Notes) |
|---|---|
| GitHub Copilot | OAuth | GPT-4, Claude, o1/o3, MiniMax 접근 가능 |
| ... | |
실행: /api models
설정 후 현재 사용 가능한 모델을 확인하려면 실행하세요. 전체 설정 지침은 docs/PROVIDERS.md에 있습니다.

# 필수 항목 확인
./check-deps
# 설치 (macOS)
...

그런 다음 프로바이더를 구성합니다. GitHub Copilot이 가장 빠른 방법입니다:

clio --new
: /api login
# 브라우저가 열리고, 사용자가 인증하면 완료됩니다.

또는 API 키를 설정합니다:

clio --new
: /api set provider openai
: /api set key YOUR_API_KEY
...

그런 다음 실제 작업을 부여합니다:

인증 실패의 원인이 되는 버그를 찾아 수정하고, 회귀 테스트(regression test)를 추가하며, 관련 테스트를 실행한 후 결과 diff를 보여줘.

또는 대화를 시작하기만 합니다:

clio --new

clio --new # 새 세션 시작
clio --resume # 마지막 세션 재개
clio --debug # 디버그 모드
...

CLIO는 Perl 5.32 이상 버전과 표준 Unix 도구(git, curl, stty, tput, tar)를 필요로 합니다. 모든 Perl 모듈은 핵심 기능이며 외부 종속성은 없습니다. 자세한 내용은 docs/DEPENDENCIES.md와 docs/INSTALLATION.md를 참조하십시오.

CLIO는 로컬 우선(local-first) 방식이며 제공업체에 독립적입니다. 로컬 모델 백엔드를 사용하면 모델 상호 작용을 사용자 하드웨어에서 유지할 수 있습니다. 호스팅되는 제공업체를 선택하는 경우, 해당 제공업체에 필요한 컨텍스트가 그 제공업체로 전송됩니다.

심층 방어(Defense in depth) - 이 계층들은 제공업체와 관계없이 적용됩니다:

비밀도 마스킹 (Secret redaction) - API 키, 토큰, 비밀번호 및 PII는 AI 컨텍스트가 모델에 도달하기 전에 제거됩니다.
명령어 분석 (Command analysis) - 셸 명령어는 위험 수준(네트워크, 자격 증명 접근, 파괴적)으로 분류되며 고위험 작업의 경우 승인이 필요합니다.
경로 권한 부여 (Path authorization) - 프로젝트 디렉터리 외부 파일 접근은 사용자 허가가 필요합니다.
보이지 않는 문자 필터링 (Invisible character filtering) - 유니코드 프롬프트 주입(Unicode prompt injection)이 자동으로 차단됩니다.
샌드박스 모드 (Sandbox mode) - --sandbox는 웹, 원격 및 에이전트 접근을 차단하고 파일을 프로젝트 디렉터리로 제한합니다.
컨테이너 격리 (Container isolation) - clio-container는 CLIO를 드롭된 기능(dropped capabilities)을 가진 Docker 내부에서 실행합니다.

자세한 내용은 docs/SECURITY.md와 docs/SANDBOX.md를 참조하십시오.

|
|

웹사이트 문서는 사용자 가이드, 아키텍처, 보안 모델 및 방법론을 다룹니다. 저장소 내 문서:

• User Guide - 전체 사용법 및 슬래시 명령어
• Architecture - 시스템 설계 및 내부 구조
• Memory - 세션, LTM(장기 기억), 복구 방식
• Providers - AI 제공업체 설정
• Sandbox Mode - 격리 옵션
• Security - 전체 보안 모델
• Remote Execution - 플릿 배포
• Multi-Agent - 병렬 에이전트 조정
• MCP Integration - Model Context Protocol 지원
• Skills - 사용자 지정 스킬 관리
• OpenSpec - 사양 기반 개발
• Developer Guide - 기여 방법

CLIO는 Synthetic Autonomic Mind의 일부입니다. 코드는 GPL-3.0만, 문서는 CC-BY-NC-SA-4.0을 따릅니다. Andrew Wyatt (fewtarius)가 제작했습니다.

웹사이트 | GitHub | Discussions