CtrlAI

CtrlAI는 에이전트를 건드리지 않고 에이전트 SDK와 LLM 제공자 사이에 자리한다. base URL 하나를 바꾸면, 프록시가 요청을 상류로 전달하고, 응답을 검사하고, 아무 일도 없었던 것처럼 돌려준다. SDK는 그 사실을 전혀 모른다. 재작성도, 래퍼도, 새로 배울 API도 없다.

규칙은 YAML 파일에 있고 도구 이름, 에이전트 ID, 파일 경로 glob, 명령 regex, URL regex, 또는 인자 안의 임의 부분 문자열에 매칭된다. 특정 도구를 아예 차단하거나, 한 에이전트에만 차단하거나, 루트에서의 rm -rf 같은 위험한 셸 패턴을 차단할 수 있다. 한 규칙 안의 여러 조건은 AND로 결합된다. 필드 안의 목록은 OR로 결합된다. 첫 번째 매칭이 이긴다.

기본 제공으로 CtrlAI는 SSH 개인 키, env 파일, 자격 증명 파일, 셸 설정 쓰기, 파괴적 명령, 데이터 유출, 카메라 접근, 화면 녹화, 위치, 원격 코드 실행을 다루는 내장 규칙을 함께 제공한다. 기본으로 켜져 있다. 끌 수도 있다. 맞춤 규칙을 하나라도 쓰기 전에 기초 보호를 얻는다.

ctrlai kill main --reason "suspicious activity"로 아무 에이전트나 즉시 종료하거나, ctrlai kill --all로 전부 멈출 수 있다. 프록시는 가짜 턴 종료 응답을 돌려주므로 에이전트의 루프가 깔끔하게 멈춘다. 킬 상태는 파일에 기록되고 핫 리로드를 위해 감시된다. 프록시가 돌아가는 중에도 몇 초 안에 적용된다.

모든 도구 호출은 시퀀스 번호, 타임스탬프, 에이전트 ID, 도구 이름, 인자, 결정, 매칭된 규칙과 함께 기록된다. 각 항목은 이전 항목에 연결된 SHA-256 해시를 지닌다. 어느 항목을 바꾸든 그 지점부터 체인이 끊어진다. 실시간으로 따라가고, 에이전트나 결정으로 조회하고, 무결성을 검증하고, CSV나 JSON으로 내보낼 수 있다.

같은 포트의 웹 대시보드는 에이전트, 요청 및 차단 수, 전체 규칙 목록, 그리고 WebSocket을 통한 도구 호출 결정의 실시간 피드를 보여준다. 대시보드가 보여주는 모든 것은 REST API로도 접근할 수 있어, 자체 도구에서 규칙 변경, 킬, 감사 추출을 스크립트로 처리할 수 있다.

하나의 응답에 여러 도구 호출이 들어 있으면, CtrlAI는 각각을 평가하지만 어느 하나라도 차단되면 응답 전체를 제거한다. 모델이 호출을 그룹으로 계획하므로 "안전한" 절반을 실행하면 예측 불가능한 동작을 부를 수 있다는 논리다. 이것이 신중한 기본값이며, 부분 차단 모드는 향후 옵션으로 적혀 있다.

에이전트 정체성은 URL 경로에서 나오므로 /provider/anthropic/agent/work/...와 /provider/anthropic/agent/main/...는 각자의 규칙, 감사 이력, 킬 상태를 가진 별개 에이전트로 취급된다. 다른 에이전트의 허용 범위를 바꾸지 않고 한 에이전트의 권한을 잠글 수 있다.