평소처럼 요청하기
연동을 설정하고 신뢰하면, 연결된 에이전트가 일반 요청에도 같은 파일 작업 절차를 적용할 수 있습니다. 질문과 계획만으로는 작업공간을 만들지 않습니다.
0.4.0rc2공개 준비 버전
macOS로컬 파일 시스템
3.11+필요한 Python 버전
MIT오픈소스 라이선스
01 / 기본 작업 관리
작업에 필요한 것을 한곳에.
작업은 마지막 결과물 파일 하나로 끝나지 않습니다. Retulo는 연결된 에이전트가 참조할 수 있도록 원본 자료, 버전 내역, 결정 사항과 검증 기록을 체계적으로 보관합니다.
같은 작업 이어가기
고정된 작업 ID와 작업공간으로 대화가 바뀌어도 작업을 연결합니다. 이어갈 때 작업 ID, 작업공간 경로 또는 실제 결과물 참조를 제공합니다.
원본과 이전 결과 관리
저장할 경로를 정하고 실제 파일을 등록하며 관리 대상의 이전 결과를 보존합니다. 기존 코드 저장소는 원래 위치에서 작업합니다.
현재 상태 파악하기
짧은 현재 안내에 결정 사항, 남은 일, 검증과 승인 기록을 남깁니다. 파일 저장, 내용 확인, 사용자 승인을 구분합니다.
파일 작업 이어 하기 예제 실행
.venv/bin/python scripts/demo_continuity.py --output-dir /tmp/retulo-continuity-demo새로 만든 빈 출력 폴더를 사용하세요. 별도 CLI 프로세스가 안내문을 만들고 같은 작업을 다시 확인한 뒤 두 번째 버전을 저장합니다. 원본과 첫 결과는 보존합니다. 작업 이어 하기를 검사하며 실제 새 Codex 대화의 연동 동작을 확인하는 예제는 아닙니다.
02 / 작동 방식
에이전트가 도구를 실행하고,
Retulo가 작업을 관리합니다.
할 일 설명
현재 에이전트가 요청을 해석하고 목표와 완료 기준을 구체화합니다.
작업 연결
파일을 만들기 전에 에이전트가 작업공간을 시작하거나 기존 작업을 식별합니다.
저장하고 확인
Retulo가 버전과 파일 무결성을 기록합니다. 에이전트나 사용자가 내용을 평가하고 결과를 남깁니다.
현재 상태로 이어가기
짧은 현재 안내를 읽고, 다음 단계에 필요하면 상세 기록을 확인합니다.
코어는 로컬에서 동작합니다. 모델이나 에이전트를 시작하거나 레시피 명령을 실행하지 않으며 폴더 감시와 결과 공개도 하지 않습니다.
03 / 빠른 시작
소스 폴더에서 시작하세요.
소스 압축 파일을 풀고 프로젝트 폴더에서 터미널을 엽니다. 현재 공개 준비본은 소스 설치를 사용합니다.
CLI와 MCP 코어 설치
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.lock
.venv/bin/python -m pip install --no-deps -e .
.venv/bin/retulo --help마지막 명령을 실행하면 Retulo에서 사용할 수 있는 명령이 표시됩니다.
Codex 연동 변경 미리 보기
.venv/bin/python scripts/install_codex.py
.venv/bin/python scripts/install_codex.py --apply첫 명령은 변경 사항을 미리 보여줍니다. 준비되면 적용한 뒤 Codex에서 실제 훅 정의를 확인하고 신뢰하도록 설정합니다. 소스 폴더는 그대로 보관하세요. 기존 MCP 연결은 자동으로 다시 시작되지 않습니다.
그다음 평소처럼 작업 요청
방문객 안내문을 Markdown 파일로 만들어줘. 원본 자료는 보존해줘.
새 대화에서는 기존 작업공간이나 파일 참조를 함께 제공
같은 작업공간에서 이 안내문을 이어서 수정해줘. 연락처를 추가하고 이전 버전도 남겨줘.
04 / 갱신과 반복
자료가 바뀌어도,
쓸 수 있는 작업은 그대로.
단계가 명시된 작업에서는 Retulo가 입력 자료, 제작 단계, 정확한 결과물을 연결합니다. 입력이 바뀌면 에이전트가 어느 단계에 작업이 필요한지 확인합니다.
영향받은 단계 갱신
현재 에이전트가 필요한 도구를 다시 실행하고 이전 최종본은 보존합니다. 명시되지 않은 의존 관계까지 자동으로 알아내지는 않습니다.
작업 레시피 재사용
버전이 정해진 입력과 매개변수로 새 작업을 만듭니다. 검증은 새로 진행하며 기존 승인이나 통과 판정을 복사하지 않습니다.
완전한 로컬 예제 실행
.venv/bin/python scripts/demo_incremental.py --output-dir /tmp/retulo-report-demo새로 만든 빈 출력 폴더를 사용하세요. 현재 소스 폴더의 실제 파일 목록으로 HTML 보고서를 만들고, 관련 단계 갱신, 이전 보고서 보존, 레시피 저장과 다른 자료로 새 보고서 생성을 확인합니다. 모델을 호출하거나 전역 설치 설정을 변경하지 않습니다.
05 / 문서
첫 작업부터
상세 사용 규칙까지.
- README소개, 소스 설치와 일반적인 사용 방법.
- 작업 흐름과 레시피명시된 단계, 입력과 출력, 새 작업 재사용.
- 연동 안내현재 에이전트, 문맥 훅과 작업 조정.
- 검증 범위확인한 환경, 실제 검증 방법과 현재 한계.
- 설치 복구설치 스냅샷과 변경을 확인하는 복구 절차.
- 자주 묻는 질문설정, 이어 하기와 검증에 관한 질문.
이 차이를 알아두세요.
모든 대화를 자동으로 기억하나요?
Retulo는 관리하는 작업, 파일과 진행 상황을 기록합니다. 다른 대화에서 이어갈 때 같은 작업이나 작업공간을 지정합니다. 코어가 전달받지 않은 대화를 복원하지는 않습니다.
내용을 쓰거나 평가하는 것도 Retulo인가요?
현재 에이전트가 요청을 해석하고 도구를 실행합니다. Retulo는 작업공간을 관리하고 파일 무결성, 검증과 승인을 기록합니다. 검증 기록만으로 내용의 품질이 보장되는 것은 아닙니다.
현재 확인된 환경은 무엇인가요?
macOS의 로컬 파일 시스템과 Python 3.11 이상이 검증 대상입니다. 다른 운영체제, 네트워크 저장소, 여러 호스트와 다른 클라이언트는 별도 검증이 필요합니다.
무엇을 설치하고 연결해야 하나요?
Python 3.11 이상과 패키지 의존성을 설치하고 로컬 작업공간과 자료 루트를 설정합니다. CLI로 사용하거나 기존 에이전트에 MCP 서버를 연결합니다. Codex 지침과 훅은 별도 설치기로 설정하며, Retulo가 AI 실행 환경이나 백그라운드 서비스를 추가하지는 않습니다.
06 / 도움과 기여
다음 작업이 더 쉬워지도록.
먼저 안내를 확인하고, 버그는 작은 재현 예제로, 새 기능은 그 기능으로 끝내고 싶은 작업과 함께 설명해 주세요.
프리뷰 버전입니다. GitHub 저장소의 소스 설치 안내를 따라 시작하세요. 확인한 환경과 현재 한계는 검증 기록에서 볼 수 있습니다.