CALF Manual
Workbench 1.9.16 · Start with one task
Choose a workspace, connect your existing AI account, describe the result and what to preserve, inspect supported checks, then submit. The first-task guide shows readiness and the next action. Changes, checks and unfinished attempts stay with the task.
Read Current separately from Recorded. A historical success does not confirm changed files. Open Attention only when a human decision is needed.
Actual screens · First task · Current downloads · Legacy releases
Workbench 1.9.16 · 작업 하나로 시작하기
작업 폴더와 기존 AI 계정을 선택하고, 원하는 결과·유지할 내용·확인 방법을 적으세요. 기존 검사를 확인한 뒤 제출합니다. 첫 작업 안내가 준비 상태와 다음 행동을 보여주며, 변경·검사·중단된 시도는 작업과 함께 보존됩니다.
Current와 Recorded를 구분하세요. 과거의 성공이 변경된 파일의 현재 완료를 뜻하지는 않습니다. 사람의 판단이 필요한 작업은 Attention에서 확인합니다.
Engineering references · current release
Harness 1.8.19, Workbench 1.9.16 and SDK 0.2.11 use one Rust reader. Open Engineering knowledge in Workbench when needed, or use the read-only Repository MCP and SDK examples. The 367-entry starter includes entries explicitly marked as names rather than full definitions.
Import a collection only when you choose to. Its index stays local, retains source hashes and status, and loads bounded excerpts. The private 4,334-document qualification dataset is not included. New tasks retain selected references through resume; references never replace file-bound checks or grant permission.
Engineering guide · Optional Ollama/MLX preview and qualification limits · Current release
Earlier screenshots below illustrate existing controls; they are not captures of the new knowledge panel. Local Qwen7B trials stopped under unchanged resource guards and did not complete a task.
공학 지식 참조 · 최신 배포
하네스 1.8.19·워크벤치 1.9.16·SDK 0.2.11이 하나의 Rust 조회기를 사용합니다. Workbench에서 필요할 때 Engineering knowledge를 열거나 읽기 전용 Repository MCP·SDK 예제를 사용하세요. 기본 참조 367개 중 이름만 있는 항목은 전체 정의와 구분합니다.
선택한 자료만 로컬 인덱스로 가져옵니다. 출처 해시와 자료 상태를 보존하고 필요한 본문만 제한해서 읽습니다. 비공개 검증 문서 4,334건은 배포하지 않습니다. 새 작업은 재개할 때도 선택한 참조를 유지하며, 참조가 파일에 결속된 검사나 실행 승인을 대신하지는 않습니다.
공학 지식 안내 · 선택형 Ollama·MLX 미리보기와 검증 한계 · 최신 배포 안내
아래의 이전 스크린샷은 기존 조작 예시이며 새 지식 패널 화면은 아닙니다. 로컬 Qwen7B 시험은 기존 자원 가드가 중단해 작업 완료까지 통과하지 못했습니다.
Read the context you need. Keep the original evidence.
Harness 1.8.19 and Workbench 1.9.16 include Repository Intelligence in Rust. In Workbench, open Repository context, connect a CALF history folder and choose one module. Search older decisions or inspect an exact record without loading the whole journal.
Capture local Git saves bounded HEAD/index/working versions and file-relationship candidates. Select a file and its saved version. This does not run project checks or send source to an AI. Historical PASS and static candidates are not current completion evidence.
Repository is no longer an extension. FFmpeg is the only current optional pack. Earlier packages, records, contracts and settings remain available. Full guide and limits · Native Claude connection.
Earlier screenshots elsewhere in this manual illustrate retained workflows. New native Repository controls received separate runtime and screen checks; see the release verification report.
필요한 문맥만 읽고, 원본 근거는 보존합니다.
하네스 1.8.19와 워크벤치 1.9.16은 Repository Intelligence를 Rust 기본 기능으로 제공합니다. 워크벤치에서 Repository context를 열고 CALF 기록 폴더를 연결한 뒤 모듈 하나를 선택하세요. 전체 기록을 읽지 않고 오래된 결정이나 정확한 원문을 조회할 수 있습니다.
Capture local Git은 제한된 범위의 HEAD·인덱스·작업 파일 버전과 파일 관계 후보를 저장합니다. 파일과 저장된 버전을 선택해 읽으세요. 프로젝트 검사를 실행하거나 소스를 AI에게 보내지 않습니다. 과거 PASS나 정적 분석 후보는 현재 완료의 근거가 아닙니다.
Repository 확장은 따로 설치하지 않습니다. 현재 선택 확장은 FFmpeg 하나이며 이전 패키지·기록·계약·설정도 보존합니다. 전체 사용법과 범위 · Rust Claude 연결.
이 매뉴얼의 이전 스크린샷은 보존된 작업 흐름을 설명합니다. 새 Repository 조작은 실행·화면 검증을 별도로 진행했으며 범위는 릴리즈 검증 보고서에서 확인할 수 있습니다.
Choose the interface you need.
Harness · 1.8.19
A native command-line runtime. Use it with existing Codex / Antigravity hooks, or start independent headless tasks. No Tauri window or WebView is loaded.
Workbench · 1.9.16
The same execution core with a Rust + Tauri desktop interface: Task Flow, Git Graph, Diff, Evidence, worker activity, local sources and small checked edits.
New tasks created through calf task and Workbench use the same job format. Point both to the same CALF_WORK_HOME to see the same jobs. Do not run both workers on separate copies of a live records folder.
history.html and installation state. They are preserved; they are not automatically imported into Workbench's task list.필요한 작업 방식에 맞춰 선택하세요.
Harness · 1.8.19
창 없이 사용하는 네이티브 명령줄 런타임입니다. 기존 Codex·Antigravity 훅에 연결하거나 독립적인 headless 작업을 실행합니다. Tauri 창이나 WebView를 로드하지 않습니다.
Workbench · 1.9.16
같은 실행 코어에 Rust + Tauri 데스크톱 화면을 더합니다. Task Flow, Git Graph, Diff, Evidence, 워커 활동, 로컬 자료, 검수와 연결된 작은 수정을 지원합니다.
calf task와 Workbench에서 만든 새 작업은 같은 기록 형식을 사용합니다. 양쪽의 CALF_WORK_HOME을 동일하게 지정하면 같은 작업을 볼 수 있습니다. 실행 중인 기록 폴더를 복사해 두 곳에서 동시에 처리하지 마세요.
history.html과 설치 상태는 그대로 보존됩니다. 이 기록이 Workbench 작업 목록으로 자동 변환되는 것은 아닙니다.Extract, keep the folder, then launch.
| Platform | Package | Requirements |
|---|---|---|
| macOS Apple Silicon | macos-arm64.zip | macOS 14+; native ARM64. Open CALF Workbench.app for the desktop edition. |
| Windows x64 | windows-x86_64.zip | Windows 10/11 x64; Workbench needs Microsoft WebView2 Runtime. Open calf-terminal.exe. |
| Linux x64 | linux-x86_64.tar.gz | glibc desktop. Workbench requires GTK 3, WebKitGTK 4.1 and a graphical session; Debian 13 is the native UI test environment. Run ./calf-terminal. |
Use the package matching the CPU, not only the OS. Intel Mac, Windows ARM64, Linux ARM64 and Alpine/musl are not included. Rust, Node.js and an external SQLite installation are not needed. The checks for your project still need their own runtimes; supported Python checks need Python 3 and, for pytest, an already installed pytest; Cargo checks need an installed Rust toolchain and cached dependencies.
- Download the archive and
SHA256SUMSfrom the matching GitHub or GitLab release. - Verify the archive hash, then extract the entire folder. On Linux use
tar -xzf FILE.tar.gzto preserve executable permissions. - Keep the core
calf/calf.exebeside the desktop executable. On macOS both are inside the app bundle. - Launch Workbench, or run
./calf --help(.\calf.exe --helpin PowerShell).
# macOS
shasum -a 256 CALF-Workbench-1.9.16-macos-arm64.zip
# Linux
sha256sum CALF-Workbench-1.9.16-linux-x86_64.tar.gz
# PowerShell
Get-FileHash .\CALF-Workbench-1.9.16-windows-x86_64.zip -Algorithm SHA256The default records folder is below. An explicit absolute CALF_WORK_HOME overrides it. Existing development installations may also have a runtime.json; an explicit runtime takes precedence and fails closed if its home is invalid.
macOS: ~/Library/Application Support/CALF/workbench
Windows: %LOCALAPPDATA%\CALF\workbench
Linux: $XDG_DATA_HOME/calf/workbench
or ~/.local/share/calf/workbench전체 압축을 풀고, 폴더를 유지한 채 실행하세요.
| 플랫폼 | 패키지 | 필요 환경 |
|---|---|---|
| macOS Apple Silicon | macos-arm64.zip | macOS 14 이상, ARM64. 데스크톱은 CALF Workbench.app을 엽니다. |
| Windows x64 | windows-x86_64.zip | Windows 10/11 x64. Workbench는 Microsoft WebView2 Runtime이 필요하며 calf-terminal.exe를 실행합니다. |
| Linux x64 | linux-x86_64.tar.gz | glibc 환경. Workbench는 GTK 3·WebKitGTK 4.1·그래픽 세션이 필요합니다. Debian 13이 네이티브 UI 시험 환경입니다. ./calf-terminal을 실행합니다. |
운영체제뿐 아니라 CPU도 맞춰 선택하세요. Intel Mac, Windows ARM64, Linux ARM64, Alpine/musl 패키지는 포함되지 않습니다. Rust·Node.js·별도 SQLite 설치는 필요하지 않습니다. 프로젝트 검사에 필요한 실행 환경은 별도이며, Python 검사는 Python 3, pytest는 추가로 설치된 pytest가 필요합니다. Cargo 검사는 Rust 도구 체인과 의존성 캐시가 필요합니다.
- 해당 GitHub 또는 GitLab 릴리즈에서 압축 파일과
SHA256SUMS를 받습니다. - 해시를 비교한 뒤 전체 압축을 풉니다. Linux에서는 실행 권한을 보존하도록
tar -xzf FILE.tar.gz를 사용합니다. calf또는calf.exe를 데스크톱 실행 파일 옆에 유지합니다. macOS에서는 두 파일이 앱 번들 안에 있습니다.- Workbench를 열거나
./calf --help를 실행합니다. PowerShell에서는.\calf.exe --help입니다.
# macOS
shasum -a 256 CALF-Workbench-1.9.16-macos-arm64.zip
# Linux
sha256sum CALF-Workbench-1.9.16-linux-x86_64.tar.gz
# PowerShell
Get-FileHash .\CALF-Workbench-1.9.16-windows-x86_64.zip -Algorithm SHA256기본 기록 위치는 아래와 같습니다. 절대 경로인 CALF_WORK_HOME을 지정하면 우선 사용합니다. 기존 개발판의 명시적 runtime.json이 있으면 그 설정이 우선하며, 잘못된 경로일 때 임의로 다른 위치로 대체하지 않습니다.
macOS: ~/Library/Application Support/CALF/workbench
Windows: %LOCALAPPDATA%\CALF\workbench
Linux: $XDG_DATA_HOME/calf/workbench
또는 ~/.local/share/calf/workbenchChoose the work. Keep track of the result.
You choose the folder, existing AI account and result. CALF connects changes, checks and unfinished attempts so you can review what happened.
- Choose Choose workspace and select the project CALF may work in.
- Choose Connect AI. A saved connection reports local selection, not live authentication or permission.
- In an empty request, choose Use a request outline. Fill in Result I want, Keep unchanged and How to check. Review the completed request, then choose Submit.
The guide folds after a new job appears. Reopen Start a task whenever needed. Check setup opens diagnosis on demand. Existing draft text is preserved.
Your project must already have meaningful unittest, configured pytest, supported single-package Cargo integration tests or node:test checks and their tools. The outline does not create tests or acceptance criteria. Review Diff and Evidence before relying on the result.
The existing host retains its account and approval policy. Direct OpenAI API connection is also available; keys use the OS credential store and provider charges may apply. No new live AI-service benchmark is claimed for this UI update.
Check profiles / Python environment
./calf check-discover /absolute/path/project inspects check selection without starting a task. Python selection is .venv → venv → active environment → bounded PATH probe. An invalid explicit environment stops discovery. Dependencies are not installed automatically; pre-existing failures are recorded rather than waived.
작업을 정하고, 결과의 근거를 확인하세요.
폴더·기존 AI 계정·원하는 결과는 사용자가 정합니다. CALF는 변경·검사·끝나지 않은 시도를 연결해 작업 과정을 확인할 수 있게 합니다.
- Choose workspace로 CALF가 작업할 프로젝트를 고릅니다.
- Connect AI로 연결합니다. 연결 저장은 로컬 선택 상태이며 실시간 인증이나 실행 승인이 아닙니다.
- 빈 요청창에서 Use a request outline을 누릅니다. Result I want(결과), Keep unchanged(유지할 것), How to check(확인 방법)를 채우고 검토한 뒤 Submit을 누릅니다.
새 작업이 나타나면 안내가 접힙니다. Start a task로 다시 열 수 있고, Check setup으로 필요할 때 진단합니다. 기존 입력은 보존합니다.
프로젝트에는 의미 있는 unittest·설정된 pytest·단일 패키지 Cargo 통합 테스트 또는 node:test 검사와 도구가 있어야 합니다. 초안이 검사나 합격 기준을 만들어 주지는 않습니다. 결과를 쓰기 전에 Diff와 Evidence를 확인하세요.
기존 호스트의 계정과 승인 정책은 그대로입니다. OpenAI API 직접 연결도 가능하며 키는 OS 자격증명 저장소를 사용하고 공급자 요금이 발생할 수 있습니다. 이번 UI 업데이트의 새 AI 실서비스 성능 검증을 주장하지 않습니다.
검사 프로필 / Python 환경
./calf check-discover /absolute/path/project로 작업 실행 없이 검사 선택을 확인합니다. Python은 .venv → venv → 활성 환경 → 제한된 PATH 탐색 순서입니다. 명시한 환경이 손상되면 중단합니다. 의존성은 자동 설치하지 않으며 기존 실패를 면제하지 않습니다.
Isolated macOS home; no AI task submitted. Actual captures; lossless crops retain the original pixels. Computer-wide metrics are not a CALF benchmark.AI 작업을 제출하지 않은 분리된 macOS 기록 위치입니다. 제목 표시줄을 포함한 원본 캡처이며 컴퓨터 전체 수치는 CALF 성능 측정이 아닙니다.
Run the same lifecycle without the window.
./calf task home
./calf task connect codex
./calf task run "/absolute/path/project" "Fix the total calculation; preserve the tests."
./calf task list
./calf task status TASK_IDPowerShell uses .\calf.exe. Supply an executable path after connect codex if discovery fails. Shell quotes protect paths and requests containing spaces or CJK text.
| Command | Behavior |
|---|---|
task submit WORKSPACE REQUEST | Queue a new job and print its ID. Does not start a background service. |
task run WORKSPACE REQUEST | Queue, process eligible jobs in the same home, then return this job's current result. Exit 0 requires SATISFIED; 2 means incomplete; 1 is a command error. |
task work | Process the queue in the foreground. Opening Workbench also starts eligible queued work. Its exit 0 means worker idle, not that every task passed. |
task pause / resume / cancel ID | Request control. Resume queues the remaining work; run task work afterward. Cancellation is final. |
task recheck ID | Queue checks after a supported external edit, within the existing budget and scope. |
task preferences "TEXT" | Save a working preference for future jobs. |
For custom non-Python checks and provider adapters, the advanced calf run WORKSPACE REQUEST PROVIDER.json STATE [RESUME_TASK] interface accepts a bounded provider/check specification. The JSON calf api interface exposes the same task operations as Workbench; it requires an explicit home. These interfaces do not add permissions to the connected host.
Share a custom records folder with Workbench
# macOS / Linux: use an existing physical folder
export CALF_WORK_HOME="/absolute/path/calf-records"
./calf task home
# Launch the Workbench executable from this same environment.
# macOS: "CALF Workbench.app/Contents/MacOS/calf-terminal"
# PowerShell
$env:CALF_WORK_HOME = 'D:\CALF\workbench'
.\calf.exe task home
.\calf-terminal.exeGUI launchers may not inherit terminal environment variables. Keep an existing explicit runtime configuration when using custom storage. Do not move a running records folder.
창 없이 작업을 실행하고 진행 상황을 확인하세요.
./calf task home
./calf task connect codex
./calf task run "/absolute/path/project" "합계 계산을 수정하고 기존 검사는 보존해 주세요."
./calf task list
./calf task status TASK_IDPowerShell에서는 .\calf.exe를 사용합니다. 자동 감지가 실패하면 connect codex 뒤에 실행 파일 경로를 지정합니다. 공백이나 CJK 문자가 있는 경로·요청은 셸의 따옴표로 감싸세요.
| 명령 | 동작 |
|---|---|
task submit WORKSPACE REQUEST | 새 작업을 대기열에 넣고 ID를 출력합니다. 백그라운드 서비스를 시작하지 않습니다. |
task run WORKSPACE REQUEST | 작업을 등록하고 같은 기록 위치의 실행 가능한 작업을 처리한 뒤 해당 작업의 현재 결과를 반환합니다. 종료 코드 0은 SATISFIED, 2는 미완료, 1은 명령 오류입니다. |
task work | 포그라운드에서 대기열을 처리합니다. Workbench를 열어도 실행 가능한 작업이 처리됩니다. 이 명령의 종료 코드 0은 워커가 대기 상태라는 뜻이며 모든 작업의 합격을 뜻하지 않습니다. |
task pause / resume / cancel ID | 일시 정지·재개·취소를 요청합니다. Resume 후에는 task work로 처리합니다. 취소는 최종 상태입니다. |
task recheck ID | 지원되는 외부 수정 이후 기존 범위와 시도 예산 안에서 재검사를 예약합니다. |
task preferences "TEXT" | 앞으로 생성할 작업의 개인 선호를 저장합니다. |
Python 외의 명시적 검사와 공급자 어댑터는 고급 인터페이스 calf run WORKSPACE REQUEST PROVIDER.json STATE [RESUME_TASK]에서 제한된 공급자·검사 명세로 지정할 수 있습니다. JSON calf api는 Workbench와 같은 작업 기능을 제공하며 명시적 home이 필요합니다. 이 인터페이스가 호스트 권한을 확장하지는 않습니다.
Workbench와 사용자 지정 기록 폴더 공유
# macOS / Linux: 실제 존재하는 물리 폴더를 사용하세요.
export CALF_WORK_HOME="/absolute/path/calf-records"
./calf task home
# 같은 환경에서 Workbench 실행 파일을 실행하세요.
# macOS: "CALF Workbench.app/Contents/MacOS/calf-terminal"
# PowerShell
$env:CALF_WORK_HOME = 'D:\CALF\workbench'
.\calf.exe task home
.\calf-terminal.exeGUI 실행기는 터미널의 환경 변수를 상속하지 않을 수 있습니다. 별도 저장 위치를 사용하던 기존의 명시적 runtime 설정은 유지하세요. 실행 중인 기록 폴더를 옮기지 마세요.
Keep your existing harness and contracts.
Hook integration is optional. It complements the current Codex / Antigravity environment and does not replace the host's approval or sandbox policy.
./calf install --root "/absolute/path/CALF" \
--codex-home "/absolute/path/.codex" \
--antigravity-home "/absolute/path/.gemini"
./calf register "/absolute/path/project" "/absolute/path/contract.json" \
--config "/absolute/path/CALF/config.json"
./calf status "/absolute/path/project" "example-task"The installer keeps versioned binaries and backs up settings before adding its hooks. Restart the host; Codex may require its normal /hooks review and trust step. Run the exact checks[].commandLine returned by registration. It binds the installed executable, project, task, criterion and contract hash. Keep old installed binaries because old registered commands still reference them.
Use the included contract.example.json as a template. Set a new task ID, relative file scope, an executable-and-arguments array, and environment keys that affect the check. A successful process exit alone is not acceptance; inspect outcome. If no registered evidence exists, CALF retains UNKNOWN.
Remove the hooks without removing records
./calf uninstall --root "/absolute/path/CALF"If settings still match CALF's recorded edits, the original backup is restored. Later user changes are retained while owned hook entries are removed. Conflicting ownership or backup changes stop removal. Records, backups and versioned binaries remain. Do not use the historical 1.8.0 --detach-only escape unless you understand that original settings restoration cannot be established.
기존 하네스와 계약을 유지하세요.
훅 연결은 선택 사항입니다. 기존 Codex·Antigravity를 보완하며 호스트의 승인·샌드박스 정책을 대체하지 않습니다.
./calf install --root "/absolute/path/CALF" \
--codex-home "/absolute/path/.codex" \
--antigravity-home "/absolute/path/.gemini"
./calf register "/absolute/path/project" "/absolute/path/contract.json" \
--config "/absolute/path/CALF/config.json"
./calf status "/absolute/path/project" "example-task"설치기는 버전별 실행 파일을 보존하고 설정을 백업한 뒤 훅을 추가합니다. 호스트를 재시작하세요. Codex의 정상적인 /hooks 검토·신뢰 절차가 필요할 수 있습니다. 등록 결과의 checks[].commandLine을 그대로 실행하세요. 설치된 실행 파일·프로젝트·작업·검사 기준·계약 해시를 연결하는 명령입니다. 예전 등록 명령이 참조하는 이전 버전 실행 파일도 유지해야 합니다.
포함된 contract.example.json을 참고하여 새 작업 ID, 상대 경로 파일 범위, 실행 파일과 인자 배열, 검사에 영향을 주는 환경 키를 설정합니다. 프로세스의 정상 종료만으로 합격하지 않으므로 outcome을 확인하세요. 등록된 근거가 없으면 UNKNOWN을 유지합니다.
기록을 남기고 훅만 제거
./calf uninstall --root "/absolute/path/CALF"설정이 CALF가 기록한 변경과 일치하면 원래 백업을 복원합니다. 이후 사용자가 바꾼 내용은 보존하고 CALF 소유 훅만 제거합니다. 소유권이나 백업 충돌이 있으면 중단합니다. 기록·백업·버전별 실행 파일은 남습니다. 원래 설정 복원을 확인할 수 없다는 의미를 이해하지 못한 상태에서는 이전 1.8.0의 --detach-only 예외를 사용하지 마세요.
Antigravity compatibility update
Harness 1.8.19 and Workbench 1.9.16 recognize the terminal header in Antigravity’s long-output preview. CALF checks the session, step and transcript location before accepting it. It does not search command output for success text. Earlier evidence and settings stay in place.
For Claude CLI or the desktop app’s local Code mode, use the included hosts/ connection kit and its English or Korean guide. The Claude adapter is tested on macOS.
Antigravity 호환성 업데이트
Harness 1.8.19과 Workbench 1.9.16은 Antigravity의 긴 출력 미리보기에서도 실제 종료 정보를 읽습니다. 세션·단계·대화 기록 위치를 먼저 대조하며, 명령이 출력한 성공 문구를 검사 결과로 사용하지 않습니다. 기존 근거와 설정은 그대로 남습니다.
Claude CLI나 앱의 로컬 Code 모드는 함께 제공하는 hosts/ 연결 키트의 영·한 안내를 따라 연결하세요. Claude 어댑터는 macOS에서 검증했습니다.
Read activity separately from completion.
| Area | What it shows |
|---|---|
| Task Flow | Recorded EDIT, CHECK, REPAIR and review stages with small timestamps. Select a node to inspect its evidence. |
| Git Graph | Local commits, HEAD / branch labels and working-tree status. Read-only observation; no fetch, push, checkout or execution permission is granted. |
| Worker terminals | Recorded or current operation, process ID, exit information and check evidence. A node can remain in the view after its process has stopped. |
| System monitor | CPU, GPU, memory, swap, disk and network when available. Missing sensors remain unavailable. Whole-system memory is not CALF's own footprint. |
| Journal | Append-only execution events and recovery evidence. Earlier failure records stay visible after a successful retry. |
Colors are paired with text. Green indicates supported completion, amber indicates waiting / incomplete work, and red marks failure or cancellation where applicable. Git graph colors describe repository state, not test success.
실행 중인 활동과 완료 판정을 구분하세요.
| 영역 | 표시 내용 |
|---|---|
| Task Flow | EDIT·CHECK·REPAIR·검수 단계와 작은 타임스탬프를 표시합니다. 노드를 선택하면 근거를 확인합니다. |
| Git Graph | 로컬 커밋·HEAD·브랜치·작업 트리 상태입니다. 읽기 전용 관측이며 fetch·push·checkout 또는 새로운 실행 권한을 부여하지 않습니다. |
| 워커 터미널 | 현재 또는 기록된 작업, PID, 종료 정보, 검사 근거입니다. 노드가 남아 있다고 프로세스가 살아 있다는 뜻은 아닙니다. |
| 시스템 모니터 | 가능한 CPU·GPU·메모리·스왑·디스크·네트워크 값을 표시합니다. 센서가 없으면 해당 값을 표시할 수 없다고 안내합니다. 전체 시스템 메모리는 CALF 자체의 사용량과 다릅니다. |
| Journal | 실행 이벤트가 순서대로 추가되는 기록입니다. 복구 근거도 함께 남깁니다. 재시도가 성공해도 이전 실패 기록은 유지합니다. |
색상과 상태 문구를 함께 확인하세요. 녹색은 근거가 있는 완료, 황색은 대기·미완료, 적색은 해당하는 실패·취소를 나타냅니다. Git 그래프의 색상은 저장소 상태이며 테스트 합격 표시가 아닙니다.
Which exact change did the check verify?
Diff offers Task, Attempt, Recovery and Working Tree views, with Unified and Before & After presentation. Select a file to see the available content, hashes and evidence. Snapshots, text and output have bounds; content that was not retained cannot be reconstructed from a hash.
A CHECK receipt alone is not sufficient. CALF compares the task / attempt, snapshot and current file version where the recorded evidence allows it. A changed file makes earlier success stale. Read the binding message: if exact file-version binding is not established, the viewer must not present that receipt as proof for the displayed change.
정확히 어떤 변경을 검사했는지 확인하세요.
Diff에서 Task·Attempt·Recovery·Working Tree 범위와 Unified·Before & After 표시를 선택할 수 있습니다. 파일을 선택하면 보존된 내용·해시·근거를 봅니다. 스냅샷·텍스트·출력에는 상한이 있으며, 저장하지 않은 내용은 해시만으로 복원할 수 없습니다.
CHECK 영수증의 존재만으로는 충분하지 않습니다. 기록이 지원하는 범위에서 작업·시도·스냅샷·현재 파일 버전을 비교합니다. 파일이 바뀌면 이전 성공 근거는 오래된 근거가 됩니다. 검사 결과가 어떤 파일 버전에 연결되어 있는지 확인하세요. 정확한 버전이 확인되지 않은 영수증은 현재 변경의 합격 증거가 될 수 없습니다.
Light Edit or your own editor.
- Select a changed file in Diff.
- For a small correction, open Light Edit. Review the text, apply the patch, then wait for revalidation.
- For larger changes, select an editor and choose Open in Editor. The detected list is platform-dependent; Add editor lets you select an application or executable manually.
- After an external edit, return to CALF and choose Recheck. Old PASS evidence cannot be reused for a different file version.
Light Edit supports files up to 16 KiB and up to 40 changed lines. It checks the expected current hash, refuses protected test/settings files or files outside the editable scope, and uses the existing attempt budget. It is unavailable while the worker is active. Manual editor entries are local; up to eight can be stored. Xcode, VS Code, Cursor, Zed and other supported launchers appear only when detected or manually added.
Light Edit 또는 익숙한 에디터를 사용하세요.
- Diff에서 변경된 파일을 선택합니다.
- 작은 수정은 Light Edit를 열어 내용을 확인하고 패치를 적용한 뒤 재검증을 기다립니다.
- 큰 수정은 에디터 목록에서 선택하고 Open in Editor를 누릅니다. 감지 목록은 플랫폼에 따라 다릅니다. Add editor에서 앱이나 실행 파일을 직접 추가할 수 있습니다.
- 외부 수정 후 CALF로 돌아와 Recheck를 누릅니다. 다른 파일 버전에 예전 PASS 근거를 재사용할 수 없습니다.
Light Edit는 최대 16 KiB 파일과 40개 변경 줄을 지원합니다. 예상한 현재 해시를 확인하고, 보호되는 테스트·설정 파일이나 편집 범위 밖의 파일을 거부하며, 기존 시도 예산을 사용합니다. 워커가 동작 중이면 사용할 수 없습니다. 수동 에디터는 로컬에 최대 8개 저장합니다. Xcode·VS Code·Cursor·Zed 등 지원하는 실행기는 감지되거나 수동 추가된 경우에 표시됩니다.
Resume from evidence, not from a success guess.
| State | Next step |
|---|---|
| WAIT / resources | Leave the worker running or reopen Workbench. Eligible work resumes when resources permit. The fader limits work; it does not drop checks. |
| RETRY / response incomplete | Inspect the failure and connection, then Resume. Earlier attempts and consumed budget remain. |
| PAUSE | Resume when ready. Pause applies between owned operations, not necessarily at the instant of a click. |
| CHECK / evidence stale | Review the current file version and Recheck. Do not force old evidence to PASS. |
| CHECK / needs reconciliation | An operation's effects are uncertain. Inspect files and evidence; ordinary Resume is refused until the supported reconciliation is established. |
| FAIL / budget exhausted | Investigate the retained attempts. Reuse can create a new task with a fresh request and checks; it does not reset or rewrite the failed task. |
| STOP / cancelled | The task is final. Start or Reuse a new task if work is needed. |
Reuse loads a recipe from a prior task. It does not copy the prior success verdict or grant new authority. A new task is independently checked. Closing Workbench is not a reliable cancellation command: an owned worker can continue. Use Cancel and inspect its state when you need to stop the work.
Legacy index recovery: after backing up records, use calf recover-index WORKSPACE. New job indexes are rebuilt from validated HTML segments when supported. If the authoritative HTML chain is damaged or missing, recovery stops; it must not fabricate the missing events.
성공을 추측하지 않고 근거를 바탕으로 재개합니다.
| 상태 | 다음 행동 |
|---|---|
| WAIT / resources | 워커를 유지하거나 Workbench를 다시 엽니다. 자원이 허용하면 실행 가능한 작업이 재개됩니다. 페이더는 실행량을 제한하며 검사를 생략하지 않습니다. |
| RETRY / response incomplete | 실패와 연결 상태를 확인한 뒤 Resume합니다. 이전 시도와 사용한 예산은 유지합니다. |
| PAUSE | 준비되면 Resume합니다. 정지는 CALF 소유 작업 사이에 적용되므로 클릭 즉시 멈추지 않을 수 있습니다. |
| CHECK / evidence stale | 현재 파일 버전을 검토하고 Recheck합니다. 오래된 근거를 강제로 PASS로 만들지 마세요. |
| CHECK / needs reconciliation | 작업의 실제 영향이 불확실한 상태입니다. 파일과 근거를 확인하세요. 지원되는 대조·정합성 확인 전에는 일반 Resume를 거부합니다. |
| FAIL / budget exhausted | 보존된 시도를 조사하세요. Reuse로 새 요청과 검사를 갖는 새 작업을 만들 수 있지만 기존 실패 작업을 초기화하거나 다시 쓰지 않습니다. |
| STOP / cancelled | 최종 취소입니다. 필요하면 새 작업을 시작하거나 Reuse합니다. |
Reuse는 이전 작업의 실행 내용을 새 작업의 출발점으로 사용합니다. 이전 성공 판정이나 추가 권한을 복사하지 않고 새 작업을 검증합니다. Workbench 창을 닫아도 소유 워커가 계속 실행될 수 있으므로, 중단이 필요하면 Cancel 후 상태를 확인하세요.
기존 인덱스를 복구할 때는 기록을 먼저 백업한 뒤 calf recover-index WORKSPACE를 사용합니다. 새 작업 인덱스는 지원되는 경우 검증한 HTML 세그먼트에서 다시 만듭니다. 기준 HTML 체인이 손상되거나 사라졌으면 복구를 중단하며, 없는 이벤트를 만들어내지 않습니다.
Read locally. Attach deliberately.
- Open Local sources and choose Add folder.
- Browse or filter names, then preview a text file.
- Use Attach to next task only when you want that reference included in the next AI request.
- Disconnect a source to remove its CALF connection. Earlier task evidence remains.
Up to four references, within 8 KiB including source details, can be attached. Links, hidden files and credential-related paths are excluded by the bounded reader. Changed attachments must be selected again. This is explicit context selection, not a filesystem sandbox for every tool your existing AI host already has permission to use.
The native calf local-mcp "/absolute/path/folder" command exposes the bounded local reader over stdio MCP for compatible clients. Keep the selected root narrow. It is not a network server, an automatic connection to arbitrary MCP plugins, or permission to send all local documents to an AI.
로컬에서 읽고, 필요한 자료만 첨부하세요.
- Local sources에서 Add folder를 선택합니다.
- 파일을 탐색하거나 이름으로 필터링하고 텍스트를 미리 봅니다.
- 다음 AI 요청에 보낼 때만 Attach to next task를 사용합니다.
- Disconnect로 CALF 연결을 해제할 수 있습니다. 이전 작업의 근거는 남습니다.
출처 정보를 포함해 총 8 KiB 이내, 최대 4개 참조를 첨부합니다. 제한된 읽기 기능은 링크·숨김 파일·자격증명 관련 경로를 제외합니다. 첨부한 파일이 바뀌면 다시 선택해야 합니다. 이는 명시적인 문맥 선택이며, 기존 AI 호스트가 이미 가진 모든 도구 권한을 제한하는 파일시스템 샌드박스는 아닙니다.
calf local-mcp "/absolute/path/folder"는 호환 클라이언트에 stdio MCP로 이 로컬 읽기 기능을 제공합니다. 필요한 자료가 있는 폴더만 선택하세요. 네트워크 서버, 임의 MCP 플러그인의 자동 연결, 모든 로컬 문서를 AI에게 보내는 권한을 제공하는 기능은 아닙니다.
Preferences are guidance, not bypasses.
Use My preferences for language, response style and working conventions. New jobs snapshot these preferences into their records. Changing a preference does not rewrite previous jobs or relax a contract. The interface defaults to English; requests, filenames, source text and preferences support Unicode including Korean, Chinese and Japanese, subject to installed fonts.
CALF uses one worker per records home and bounded local data. It does not require local LLMs, an always-running vector database or a multi-agent fleet. Diff and source previews are loaded within limits when needed. Keep sufficient disk space for your retained evidence.
개인 선호는 지침이며 우회 권한이 아닙니다.
My preferences에 언어·응답 방식·작업 관례를 적습니다. 새 작업은 해당 선호를 기록에 보관합니다. 선호를 바꿔도 이전 작업을 다시 쓰거나 계약을 완화하지 않습니다. 앱 화면의 기본 언어는 영어이며 요청·파일명·자료·선호 텍스트는 설치된 글꼴 범위에서 한국어·중국어·일본어를 포함한 유니코드를 지원합니다. 이 매뉴얼의 EN / KR 전환은 앱 설정과 별개입니다.
CALF는 기록 위치마다 하나의 워커와 크기가 제한된 로컬 데이터를 사용합니다. 로컬 LLM·상시 벡터 데이터베이스·다중 에이전트 집단을 요구하지 않습니다. Diff와 파일 미리보기는 필요할 때 제한된 범위로 읽습니다. 보존할 근거에 필요한 디스크 여유 공간을 유지하세요.
Preserve the data; replace only the program.
- Let owned operations finish, or request Pause and wait for the owned process to stop. Close the old Workbench window before replacing program files.
- Back up the existing installation configuration,
history.html, contracts, settings and complete Workbench records home. Keep related journal segments and indexes together; the HTML is authoritative. - Extract the new package into a new folder. Keep the old package until the new one is verified.
- For an existing 1.8.4 hook installation, run the 1.8.19 installer with the same installation root and host homes. The installer preserves versioned binaries, bindings and original setting backups. Review hooks through the host's normal mechanism if prompted.
- For Workbench, keep the same records home. If the old development build used an explicit
runtime.json, retain that private configuration beside the new desktop/core binaries, or launch both interfaces with the sameCALF_WORK_HOME. Do not put your runtime configuration in a public package. - Inspect previous records and a newly executed check. Files changing after verification must become stale, not stay PASS.
Earlier shared-core improvements retained: bounded streaming file hashing, owned child shutdown handling, automatic task execution/resume, bounded local journal and preferences, version-bound change/check evidence, and the shared headless task interface. The desktop views remain in 1.9.x. The legacy hook / contract format is retained.
Update-safe Resume: new queued jobs retain their originating runtime by hash. Keep the complete records home, including runtimes. A new launcher routes that job to its retained runtime; it does not rewrite checks, budgets or old evidence. Unverifiable old jobs remain unresolved. Advanced direct calf run states need their original compatible runtime. SDK 0.2.11 can discover and carry the same native profiles.
Rollback: close the new app and retain its data; launch the previous binary against a backup of the appropriate record format after checking compatibility. Do not restore old host settings over later user edits. Never delete versioned binaries still referenced by registered check commands.
데이터는 보존하고 프로그램만 교체하세요.
- CALF가 실행 중인 작업이 끝나기를 기다리거나 Pause 후 실행 중인 프로세스가 멈춘 것을 확인한 뒤 이전 Workbench 창을 닫습니다.
- 설치 설정·
history.html·계약·설정 파일·Workbench 전체 기록 폴더를 백업합니다. 관련 저널 세그먼트와 인덱스를 함께 유지하며 HTML이 기준 기록입니다. - 새 패키지를 새 폴더에 풉니다. 새 버전을 확인할 때까지 이전 패키지도 보관합니다.
- 1.8.4 훅 설치는 같은 설치 루트와 호스트 폴더로 1.8.19 설치기를 실행합니다. 버전별 실행 파일·등록 정보·최초 설정 백업을 보존합니다. 호스트가 요청하면 정상적인 훅 검토 절차를 진행합니다.
- Workbench는 같은 기록 위치를 사용합니다. 개발판의
runtime.json이 있다면 새 데스크톱·코어 실행 파일 옆에 개인 설정을 유지하거나 양쪽에서 동일한CALF_WORK_HOME을 사용합니다. 개인 runtime 설정을 공개 패키지에 넣지 마세요. - 이전 기록과 새로 실행한 검사를 확인합니다. 검증 후 변경된 파일은 계속 PASS가 아니라 오래된 근거로 처리되어야 합니다.
유지되는 기존 공통 코어 개선: 메모리 사용이 제한된 스트리밍 파일 해시, CALF가 시작한 자식 프로세스 종료 처리, 자동 실행·재개, 제한된 로컬 저널·개인 선호, 검사한 파일 버전과 결과의 연결, 공통 headless 명령입니다. 데스크톱 화면은 1.9.x에 두며 기존 훅·계약 형식은 유지합니다.
이전 버전으로 복귀: 새 앱을 닫고 데이터를 보존합니다. 호환성을 확인한 후 적합한 기록 형식의 백업을 이전 실행 파일로 엽니다. 이후 사용자 변경 위에 오래된 호스트 설정을 덮어쓰지 마세요. 등록된 검사 명령이 참조하는 버전별 실행 파일도 삭제하지 마세요.
업데이트 후 Resume: 새 대기열 작업은 생성 당시 런타임을 해시로 보존합니다. runtimes를 포함한 기록 폴더 전체를 유지하세요. 새 실행기가 해당 작업을 보존된 런타임으로 연결하며, 검사·예산·과거 근거를 다시 쓰지 않습니다. 런타임을 입증할 수 없는 이전 작업은 미해결로 남습니다. 고급 calf run 직접 상태 경로는 원래 호환 런타임이 필요합니다. SDK 0.2.11도 동일한 검사 명세를 조회·전달합니다.
Runtime Work · shared contracts and artifacts
Use SDK 0.2.11 to register a Python, Node or loopback HTTP adapter and construct a calf.work.v1 contract. See SDK_WORK_PROTOCOL.md and the runnable examples in the SDK archive. Registration pins declared executables and adapter files; it is not an OS sandbox.
- Keep the same
CALF_WORK_HOMEfor Harness, SDK, Local MCP and Workbench. - Open Runtime Work → Import contract…. Import freezes the contract and input snapshots; it does not start execution.
- Select the work and use Run / Resume. CALF records the real process, attempt, output manifest and required checks. If an HTTP response is lost, CALF queries the existing request ID before deciding what to do next.
- Inspect artifacts, timestamps, checks and Evidence. Recheck validates the current candidate. If the file digest has changed, the result is UNKNOWN.
- Use Adopt checked version only for a matching validated candidate, or use a contract that explicitly authorizes automatic adoption. A new attempt consumes the original budget and preserves earlier candidates.
Cancel asks CALF to stop and clean up the work within its configured limits. Until cleanup is confirmed, the work stays UNKNOWN and keeps its execution slot. Reopening the panel reads records and does not execute a task. Lists and evidence are bounded and selected work is loaded on demand.
Runtime Work · 공통 계약과 산출물
SDK 0.2.11로 Python·Node·루프백 HTTP Adapter를 등록하고 calf.work.v1 계약을 작성합니다. SDK의 WORK_PROTOCOL_KR.md와 실행 예제를 참고하세요. 선언한 실행 파일·Adapter 파일을 고정하며 OS 샌드박스를 제공하는 기능은 아닙니다.
- Harness·SDK·Local MCP·Workbench에 같은
CALF_WORK_HOME을 사용합니다. - Runtime Work → Import contract…로 계약과 입력 사본을 고정합니다. 가져오기만으로 실행하지 않습니다.
- 작업을 선택하고 Run / Resume을 누릅니다. 실제 프로세스·시도·산출물 명세·필수 검사를 기록합니다. 불명확한 HTTP 요청은 기존 요청 ID로 조회합니다.
- 산출물·타임스탬프·검사·Evidence를 확인합니다. Recheck는 현재 산출물을 재검수합니다. 해시가 달라지면 UNKNOWN입니다.
- 검증 버전이 일치할 때 Adopt checked version을 누르거나 계약에서 자동 채택을 명시합니다. 새 시도는 원래 예산을 사용하고 이전 산출물을 보존합니다.
취소 후 종료를 확인하지 못하면 UNKNOWN과 실행 슬롯을 유지합니다. 화면을 다시 열어도 자동 실행하지 않으며 선택한 작업의 기록만 필요할 때 불러옵니다.
Diagnostics, updates and Check Profiles
Open Check setup to inspect the selected provider, executable, workspace and supported check tools. CALF does not install dependencies. Updates verifies a selected release archive and stages a separate copy; keep the existing records home and retained runtimes. Existing queued jobs resume through their recorded original runtime, not an assumed compatible new executable.
JavaScript/TypeScript checks use a bounded node:test profile. A suitable Node runtime is required; TypeScript support depends on the selected runtime. npm scripts and dependency installation are not executed. Python unittest/pytest and bounded single-package Cargo integration checks remain supported.
Source-reader MCP and work MCP are separate. Work MCP runs over stdio in the foreground. Its tools are read-only by default; enable control explicitly when needed. It does not start a new resident service. The current universal protocol covers file artifacts, not arbitrary side effects, remote transactions, monetary accounting or aesthetic quality.
첫 실행 진단 · 업데이트 · Check Profile
Check setup에서 선택한 프로바이더·실행 파일·작업 폴더·검사 도구를 확인합니다. 의존성을 설치하지 않습니다. Updates는 선택한 배포 압축을 검증하고 별도 사본을 준비합니다. 기존 기록과 보존된 runtimes를 유지하세요. 대기 작업은 원래 기록한 런타임으로 재개합니다.
JavaScript/TypeScript는 제한된 node:test 프로필을 사용합니다. 적절한 Node 버전이 필요하며 TypeScript 지원은 선택한 런타임에 따릅니다. npm 스크립트·의존성 설치는 실행하지 않습니다. Python unittest·pytest·단일 패키지 Cargo 통합 검사도 지원합니다.
자료 조회 MCP와 작업 MCP는 별도입니다. 작업 MCP는 표준 입출력(stdio)으로 통신하며 포그라운드에서 실행됩니다. 기본값은 조회 전용이고 제어 기능은 직접 켜야 합니다. 새 상주 서비스는 추가하지 않습니다. 현재 범용 규약은 파일 산출물을 대상으로 하며 계약에 없는 외부 변경·원격 트랜잭션·금액 정산·미적 품질을 보장하지 않습니다.
Saved results and current status
Choose a workspace and open Task status. The saved completion result and the current observer verdict appear side by side. Refresh status reads evidence; it does not run a check or call an AI.
A check can have recorded PASS and matching files while the current verdict is UNKNOWN because its execution context differs. For example, LC_ALL: Not set → C.UTF-8 identifies the difference directly. CALF does not change the environment to make it pass.
Managed task cards also have an expandable recorded/current summary. In the SDK, use registered_tasks(workspace) and registered_status(workspace, task). Only the top-level current outcome establishes completion.
Older receipts without bound field details are labelled unavailable. Later observations require an exact full-context digest match and are labelled as later observations; they do not rerun or approve the check. Arbitrary environment values are redacted. Existing CHECKs, contracts and settings are kept.
저장된 결과와 현재 조회 판정
작업 폴더를 선택하고 Task status를 열면 저장된 완료 결과와 현재 조회 판정이 나란히 나타납니다. Refresh status는 증거만 다시 읽으며 검사나 AI를 실행하지 않습니다.
당시 CHECK가 PASS이고 파일도 같더라도 실행 문맥이 다르면 현재 판정은 UNKNOWN일 수 있습니다. 이때 LC_ALL: Not set → C.UTF-8처럼 차이를 바로 보여줍니다. 통과시키려고 환경 변수를 변경하지 않습니다.
관리형 작업 카드에서도 상태 요약을 펼쳐 볼 수 있습니다. SDK에서는 registered_tasks(workspace)와 registered_status(workspace, task)를 사용합니다. 완료 여부는 최상위 현재 outcome으로 판단합니다.
과거 영수증에 항목별 정보가 없으면 확인할 수 없다고 표시합니다. 사후 관측은 전체 문맥 해시가 정확히 같을 때만 추가하며, 나중에 관측했다는 표시를 남깁니다. 검사를 다시 실행하거나 승인하는 기능은 아닙니다. 민감할 수 있는 환경 값은 가리고 기존 CHECK·계약·설정은 보존합니다.
Claude Code connection
The lifecycle adapter and versioned setup/update/recovery are now part of the Rust core. Follow Host connections to prepare a native connection beside the previous version, inspect the current settings hash and apply only the reviewed hooks. No Python runtime is needed for this path. Permissions, MCP entries and unrelated hooks are retained.
Claude keeps its own approval flow. Registered checks require real owned-process receipts and matching file versions. A rejected or resolved ordinary tool call cannot create a passing check. New native protocol tests are separate from historical actual desktop/AI sessions; see VERIFICATION.json for the exact scope.
Claude Code 연결
이벤트 어댑터와 버전별 설치·업데이트·복구를 Rust 코어에 통합했습니다. 호스트 연결 안내에 따라 이전 버전 옆에 연결을 준비하고 현재 설정 해시를 확인한 뒤 검토한 훅만 적용하세요. 이 경로에는 Python이 필요하지 않습니다. 권한·MCP 항목·무관한 훅은 유지합니다.
Claude의 승인 절차는 그대로 유지합니다. 등록 검사는 실제 소유 프로세스의 종료 근거와 파일 버전이 일치해야 합니다. 일반 도구 호출의 거절이나 종결만으로 검사를 통과시키지 않습니다. 새 네이티브 프로토콜 시험과 과거 실제 데스크톱·AI 세션은 구분하며, 정확한 범위는 VERIFICATION.json에서 확인할 수 있습니다.
Connect reviewed local MCP tools
Use this extension when an existing work contract needs a local tool. Normal first-task setup is unchanged. Select a pinned server and exact policy; tool descriptions and annotations are data, not permission.
calf_tool_prepare or tool-prepare returns an intent and a review command. It does not execute the requested tool. Review the task, policy hash, arguments, targets, checks and expiry, then use the existing host permission flow. A ticket is not independent proof of a human approval.
Creation uses a new candidate path and runs registered independent checks. The original policy may enable local recovery from the existing terminal receipt and matching files. Recovery never resubmits an uncertain call. Delete, overwrite, external transmission and remote-job recovery remain outside this profile.
MCP contract guide · SDK preparation example · OS-specific evidence
The first-task images in this manual were captured from Workbench 1.9.16; the MCP interface is qualified separately with real local process tests.
검토한 로컬 MCP 도구 연결
기존 작업 계약에 로컬 도구가 필요할 때 선택하는 확장입니다. 일반적인 첫 작업 설정은 그대로 사용합니다. 서버와 정확한 정책을 지정하며 도구 설명이나 annotation을 실행 권한으로 취급하지 않습니다.
calf_tool_prepare 또는 tool-prepare는 실행안과 검토할 명령을 반환합니다. 요청한 도구는 실행하지 않습니다. 작업·정책 해시·인수·대상·검사·만료 시각을 검토한 뒤 기존 호스트 승인 절차로 실행하세요. 티켓 자체가 사용자의 승인 클릭을 증명하지는 않습니다.
새 경로에 후보를 만들고 등록된 독립 검사를 실행합니다. 원래 정책에 로컬 복구가 설정돼 있으면 기존 종료 영수증과 파일을 대조할 수 있습니다. 불명확한 호출을 다시 보내지 않습니다. 삭제·덮어쓰기·외부 전송·원격 작업 복구는 이 지원 범위에 포함되지 않습니다.
MCP 계약 안내 · SDK 준비 예제 · OS별 검증 근거
이 매뉴얼의 첫 작업 이미지는 Workbench 1.9.16에서 촬영했으며, MCP 인터페이스는 실제 로컬 프로세스 시험으로 별도 검증했습니다.
Keep the task in focus
Attention lists decisions that need your attention. Open a task to inspect its result; viewing never resumes or approves work. Result summary shows changed files, recorded checks and the current verdict.
Shape request… helps describe the result, what to preserve and how to check it. Add guidance to the current draft, review it and submit through the existing workflow.
Use Find task… or Cmd/Ctrl + K to search the loaded recent tasks, including Korean, Chinese and Japanese. Use arrows to select, Enter to inspect and Esc to close. Draft text and IME composition stay intact.
Light | Dark / Light | Dark changes only the center. Below 1,200 pixels, monitors start folded. Use Show monitors, Close or Cmd/Ctrl + Shift + M to toggle them. Folding pauses system sampling while task execution continues.
Detailed guide · Verification scope. Earlier screenshots retain their original version captions.
작업에 필요한 정보에 집중하기
Attention에서 사용자의 판단이 필요한 작업을 모아 보고, 작업을 열어 결과를 확인합니다. 조회만으로 재개하거나 승인하지 않습니다. Result summary는 변경 파일·당시 검사·현재 판정을 함께 보여줍니다.
Shape request…에서 원하는 결과·보존 대상·확인 방법을 정리합니다. 기존 초안에 안내를 더한 뒤 검토하고, 기존 절차로 제출하세요.
Find task… 또는 Cmd/Ctrl + K로 이미 읽은 최근 작업을 찾습니다. 한글·중국어·일본어를 지원하며, 방향키로 선택하고 Enter로 조회하거나 Esc로 닫습니다. 요청 초안과 입력기 조합 상태는 유지합니다.
Light | Dark / Light | Dark는 중앙 영역만 바꿉니다. 창 너비가 1,200픽셀 미만이면 모니터를 기본으로 접습니다. Show monitors·Close·Cmd/Ctrl + Shift + M으로 표시를 바꿀 수 있습니다. 접힌 동안에는 자원 조회를 멈추고 작업 실행은 계속 유지합니다.
Know what this release has and has not proven.
| Symptom | Check |
|---|---|
| No automatic checks | Use unittest, explicitly configured pytest, or a single Cargo package with integration tests. Install missing tools yourself; unsupported layouts require an explicit advanced check specification. |
| Codex unavailable / login required | Use the existing Codex login and select its executable. Do not paste credentials into requests, logs or issues. |
| App will not open | Confirm OS/CPU, extract the whole package, check OS trust prompts and required WebView/GTK libraries. On macOS close any old instance and launch the exact new bundle. |
| Missing old jobs | Compare the records home. Legacy hook history is not the Workbench job list. An invalid explicit home does not silently fall back. |
| Memory pressure / provider failure | Read the specific failure. High whole-system memory does not prove the provider failed from memory pressure. |
| Editor missing | Refresh the list or Add editor manually. Select an installed application/executable, not a document. |
| UNKNOWN after a change | Inspect scope, file hashes, check receipt and cleanup. Resolve the cause; do not delete failure evidence. |
The release notes record the actual binary hashes, fresh tests and reused historical evidence. A synthetic provider test proves control flow, not AI service quality. No new long-duration memory qualification is claimed for these packages. CALF is not a security boundary against an attacker running as your OS user and cannot guarantee absolute correctness for arbitrary tasks.
When reporting an issue, include the edition/version, OS/CPU, a minimal reproduction and redacted error text. Do not upload API keys, login state, private runtime files, whole journals or proprietary source without reviewing their contents. Third-party license text is included in THIRD-PARTY-NOTICES.txt; this binary distribution does not publish CALF core source.
이번 릴리즈의 검증 범위를 확인하세요.
| 증상 | 확인 사항 |
|---|---|
| 자동 검사가 없음 | unittest·명시적으로 설정을 마친 pytest·단일 Cargo 패키지의 통합 테스트를 지원합니다. 필요한 도구는 직접 설치하며, 지원하지 않는 구조는 고급 명시적 검사 명세를 사용하세요. |
| Codex 사용 불가·로그인 필요 | 기존 Codex 로그인을 사용하고 실행 파일을 선택하세요. 요청·로그·이슈에 인증정보를 붙여넣지 마세요. |
| 앱이 열리지 않음 | OS·CPU·전체 압축 해제·OS 신뢰 안내·필수 WebView/GTK를 확인하세요. macOS에서는 이전 인스턴스를 닫고 정확한 새 번들을 실행하세요. |
| 이전 작업이 없음 | 기록 위치를 비교하세요. 기존 훅 기록과 Workbench 작업 목록은 다릅니다. 잘못된 명시적 경로를 다른 경로로 조용히 대체하지 않습니다. |
| 메모리 압박·공급자 실패 | 표시된 오류와 실패 기록을 확인하세요. 시스템 메모리 사용량만으로 공급자 실패가 메모리 때문이라고 단정할 수 없습니다. |
| 에디터가 없음 | 목록을 새로 고치거나 Add editor로 추가하세요. 문서가 아니라 설치된 앱·실행 파일을 선택하세요. |
| 변경 후 UNKNOWN | 범위·파일 해시·검사 영수증·종료 처리를 확인하고 원인을 해결하세요. 실패 근거를 삭제하지 마세요. |
릴리즈 노트와 체크섬에서 검증 범위와 패키지 해시를 확인할 수 있습니다. 합성 공급자 시험은 제어 흐름을 확인하며 실제 AI 서비스의 품질을 증명하지 않습니다. 이번 패키지에 대한 장시간 메모리 시험은 새로 수행하지 않았습니다. CALF는 같은 OS 사용자로 실행되는 공격자에 대한 보안 경계가 아니며 임의의 모든 작업에 절대적인 정확성을 보장하지 않습니다.
문제 보고에는 에디션·버전·OS·CPU·최소 재현 방법·민감정보를 지운 오류 문구를 포함하세요. API 키·로그인 상태·개인 runtime 파일·전체 저널·비공개 소스는 내용을 검토하지 않고 업로드하지 마세요. 의존성 고지는 THIRD-PARTY-NOTICES.txt에 포함됩니다. 이 바이너리 배포에 CALF 코어 소스는 포함하지 않습니다.
Recorded files, quarantine and restore
Open Artifacts to see recorded paths, task references and retention reasons. Select workspace records or a task, then refresh. Reading a plan never moves files.
- Choose Preview index quarantine for a verified rebuildable index, or preview an eligible managed file in the file list.
- Review its exact path, size and SHA-256, then choose Confirm quarantine.
- In Retained moves, choose Review restore and confirm separately. A newer file is never overwritten.
Core-created disposable text has a creation receipt, task references and a retention deadline. A completed task can review release of its own reference. All references must be released and retention must expire before quarantine is eligible. Source, tests, existing logs, candidates, records, contracts, settings and recovery evidence stay protected.
Quarantine retains every byte and does not free disk space. There is no background scan, automatic cleanup or permanent deletion. The optional managed-text API is limited to 16 KiB per file and 128 files per journal. See the full guide. Some screenshots illustrate earlier releases; this section describes the current controls.
기록된 파일 조회와 격리·복원
Artifacts에서 기록된 경로, 작업별 참조와 보존 이유를 확인합니다. 작업 공간 또는 작업 하나를 선택하고 새로고침하세요. 조회만으로 파일을 옮기지 않습니다.
- 재생성 가능한 인덱스는 Preview index quarantine을 누릅니다. 조건을 충족한 관리 파일은 목록에서 미리보기를 엽니다.
- 경로·크기·SHA-256을 확인한 뒤 Confirm quarantine을 누릅니다.
- Retained moves의 Review restore에서 대상을 확인하고 별도로 복원을 승인합니다. 같은 위치에 새 파일이 있으면 덮어쓰지 않습니다.
CALF가 직접 만든 임시 텍스트에는 생성 근거·작업 참조·보존 기한이 붙습니다. 종료된 작업은 자신의 참조만 확인 후 해제할 수 있습니다. 모든 참조가 해제되고 기한이 지나야 격리를 검토할 수 있습니다. 소스·테스트·기존 로그·후보·기록·계약·설정·복구 근거는 계속 보호합니다.
격리는 모든 내용을 보관하므로 디스크 여유 공간이 늘어나지 않습니다. 상주 탐색·자동 정리·영구 삭제는 없습니다. 선택적인 관리 텍스트 API는 파일당 16KiB, 저널당 128개로 제한합니다. 자세한 안내를 참고하세요. 일부 화면은 이전 버전의 예시이며, 이 절은 최신 기능을 설명합니다.
