xout
GitHub - 저장소 npm PyPI

내 AI, 내 규칙.

AI에게 같은 지적을 반복하고 있나요? 싫은 행동에 X를 치면 xout이 Claude Code, Codex 등에서 쓸 수 있는 읽기 쉬운 규칙으로 바꿔 줍니다.

선택 15번 · 행동 기준 8개 · 내 규칙 파일 하나

로컬 실행. API 키 없이. 적용 전에 직접 확인.

uvx xout open --lang ko

시작 전후 예시 보기
선택할 때마다 카탈로그가 좁혀지고 결과 프로필이 규칙 8줄로 표현됩니다. 대상을 켜기 전에 검토하세요.
실제 터미널 세션 보기: 선택 15번, 규칙 8줄 (0.6 MB GIF) 실제 xout 터미널 세션. 선택 15번으로 검토할 규칙 8줄을 만드는 모습.

반복해서 거슬리던 행동을 검토할 수 있는 규칙으로 바꾸세요.

규칙을 고르고 켜기 전후에 같은 요청을 비교해 보세요. 이후 응답은 예시이며 에이전트가 다르게 행동할 수 있습니다.

이전

예시: 에이전트: “시작해도 될까요?”

이후

예시: “수정했습니다. 테스트 통과. 변경 사항은 다음과 같습니다.”

XOUT.md

선택한 대상의 지시 파일에 xout 소유 한 줄 또는 블록으로 연결하는 이식 가능한 Markdown 규칙.

manifest.json

각 규칙의 근거와 출처.

settings.xout.json

검토할 제안입니다. 대상을 명시적으로 허가하기 전에는 외부 지시 파일을 건드리지 않습니다.

검토한 뒤 --grant로 대상 하나를 허가하세요. xout은 동의를 기록하고 소유한 한 줄 또는 블록만 추가합니다. undo는 xout이 추가한 것만 제거합니다.

행동 기준은 8개입니다: 자율성, 작업 범위, 테스트, 주석과 문서, 오류 대응, 커밋, 검증, 의존성. 일상 작업과 되돌리기 어려운 작업에서 다르게 선택하면 규칙에 조건이 붙을 수 있습니다.

응답 하나에 X를 치고, 읽을 수 있는 규칙 초안을 남깁니다.

이 페어는 예시이며 모든 에이전트 응답을 약속하지 않습니다.

예시: 입력은 “버그를 고쳐.”입니다. 가능한 응답 하나는 “시작해도 될까요?”이고 다른 하나는 “수정했습니다. 테스트 통과.”입니다. 고른 결과는 “되돌릴 수 있는 변경은 먼저 실행하고, 되돌리기 어려운 작업은 먼저 확인받는다.” 같은 초안으로 기록됩니다. 다음 세션의 응답은 달라질 수 있으며, “수정했습니다. 테스트 통과. 변경 사항은 다음과 같습니다.”는 가능한 예일 뿐입니다.

위 분기는 예시입니다. 애니메이션은 장식이며 행동 준수를 보장하지 않습니다.

X 친 쪽

예시 전: 테스트와 정리까지 범위에 드는지 묻는다.

남긴 쪽

예시 후: 페이지네이션을 고치고 관련 테스트를 실행한 뒤 근거와 함께 보고한다.

6,561 (3⁸; 8축, 축당 3값)첫 선택 뒤의 예시: 4,374규칙 8줄

카운터는 가능한 조합 수이지 준수율이 아닙니다. XOUT.md에는 규칙, manifest.json에는 근거가 남습니다. xout why로 어떤 선택에서 나온 규칙인지 확인하세요.

자율성 규칙 초안

초안: 짧은 계획을 먼저 적고 이어서 실행한다. 삭제, push, 배포, 마이그레이션처럼 되돌리기 어려운 작업은 실행 전에 승인을 요청한다.

첫 규칙 만들기

uvx로 시작

uv가 있다면 터미널에서 바로 실행하세요. xout을 별도로 설치할 필요가 없습니다.

uvx xout open --lang ko

--lang ko는 한국어를 선택합니다. 생략해도 기본은 한국어입니다. 끝나면 ~/.claude/xout/에 저장된 규칙을 확인하세요. Claude Code에 적용하려면 동의하고, 다른 도구를 쓰면 거절한 뒤 아래에서 선택하세요.

pip로 설치하는 대안

uvx가 없다면 pip로 한 번 설치한 뒤 실행하세요. 두 방법 중 하나만 사용하면 됩니다.

pip install xoutxout open --lang ko

규칙을 사용할 에이전트 선택

XOUT.md와 근거 파일 manifest.json을 확인한 뒤 사용하는 도구의 명령 하나만 실행하세요. 아래는 pip install xout으로 설치한 경우입니다. uvx 사용자는 명령의 xout을 uvx xout으로 바꾸세요. --grant는 선택한 대상의 xout 소유 한 줄 또는 블록 추가를 허가합니다.

Codex

xout enable --grant --target codex --lang ko

Claude Code

xout enable --grant --target claude --lang ko

등록된 다른 대상

xout targets --lang ko

새 에이전트 세션에서 확인

status는 설치 상태를 확인하지, 준수를 보장하지 않습니다. 새 에이전트 세션에서 간단한 요청을 반복해 규칙이 반영되는지 확인하세요. 선택 사항인 xout probe는 외부 러너를 사용하며 사용 요금이 발생할 수 있습니다.

xout status --lang ko

xout 추가분 제거

xout undo --lang ko

릴리스 받기

체크섬 확인한 Claude Code 플러그인으로 설치

  1. 다운로드하고 압축 풀기

    플러그인 ZIP, SHA256SUMS, 검증 스크립트를 함께 받으세요. 먼저 체크섬을 확인한 뒤 새 버전 디렉터리에 압축을 풉니다. PowerShell 절차는 README에 있습니다.

    python3 verify_checksums.py SHA256SUMS --only xout-plugin-1.1.0.zip verify_checksums.pytest ! -e "$HOME/.local/share/xout-plugin-1.1.0"python3 -m zipfile -e xout-plugin-1.1.0.zip "$HOME/.local/share/xout-plugin-1.1.0"

  2. 로컬 설치

    압축을 푼 패키지를 로컬 마켓플레이스에서 설치합니다.

    claude plugin marketplace add "$HOME/.local/share/xout-plugin-1.1.0"claude plugin install xout@xout-marketplace

  3. 직접 켜기

    세션은 대화로 진행합니다. 에이전트가 페어를 채팅으로 보여 주고 X 칠 쪽을 고른 것만 기록합니다. 생성된 파일을 검토한 뒤 import를 명시적으로 허가하고 status를 확인하세요.

    /xout:xout open/xout:xout enable/xout:xout status

어디서 멈추는지 직접 볼 수 있어 유용합니다.

소유권은 당신에게

파일과 설치, 대상을 켤지 말지는 모두 당신이 결정합니다.

런타임 LLM·외부 네트워크·텔레메트리 없음

세션 전체가 터미널 안에서 실행됩니다. 모델 호출이나 원격 요청을 하지 않고 사용 분석 흔적도 남기지 않습니다.

추가만 하는 결정적 원장

선택은 순서대로 기록되고 같은 원장을 재생하면 같은 산출물을 다시 만듭니다.

켜고 끄는 과정도 명시적으로

검토하고 명시적으로 허가한 뒤에만 켜세요. undo는 관련 없는 내용이 아니라 xout 소유 한 줄 또는 블록만 제거합니다.

일주일 뒤 다시 확인

일주일 뒤 규칙이 여전히 맞는지 검토하세요. 남은 선택이 규칙이 옳거나 지켜진다는 증거는 아닙니다.

한 문장으로, 근거는 README에.

원치 않는 행동에 X를 치면 xout이 읽고 검토할 수 있는 규칙 프로필을 내 컴퓨터에 남깁니다.