HTMLEdit 1.6.0

HTMLEdit 1.6.0 — 변경 요청 가져오기

자유롭게 적은 지시 사항, 개인 메모, 피드백, 회의록을 HTML 요소별 변경 제안으로 가져옵니다. 기존 Claude Code·Codex 대화에서 분석하고, 사용자가 승인한 항목만 메모로 추가해 HTML에 반영합니다. 별도 AI API 연결은 필요하지 않습니다.

• 텍스트 붙여넣기와 UTF-8 TXT·MD·DOCX 가져오기
• 원문 근거, 다중 대상, 불명확하거나 상충하는 요구 검토
• 개별·일괄 승인, 요청 편집, 대상 재지정, 제외
• 승인 항목만 메모 전환 및 AI 반영, 실행 취소·다시 실행과 중복 방지
• 오래된 분석 차단, 문서별 원문·검토 기록 보관
• Windows 파일 잠금 시 충돌 검사와 함께 저장 재시도
• 미리보기 재로드 중 실행 취소·다시 실행 키보드 포커스 유지

Install / update

Requires Node.js 22.12+. Run in your document folder and update both the editor and installed skills:

npx --yes @woody_s/htmledit@1.6.0 install --agent all
npx --yes @woody_s/htmledit@1.6.0 open "./document.html"

Use --agent claude or --agent codex to install one skill, then start a new AI conversation. This feature uses local connected mode. Existing HTML review v1/v2 remains compatible. Original requests and review history stay in the document-local .htmledit/ folder and are excluded from exported HTML.

Input limits: 10 MiB per file and 200,000 extracted characters. DOCX body text only; audio, PDF and legacy DOC are unsupported.

Verification

98 unit tests, 134 Windows Chrome/Edge browser tests, and 67 Chrome tests each on Ubuntu/macOS, plus packaged installation checks. Actual interactive Codex and signed-in Claude Code independently analyzed synthetic free-form requests and applied only three browser-approved notes on Windows; backup, automatic refresh and clean export were verified. Actual AI verification and platform CI are separate evidence.

Usage · AI verification · PR #4

Published-package verification: npm latest is 1.6.0; registry signature and provenance attestation verified. Both installed skills and request CLI passed on Windows Node.js 22.17.0. The npm tarball, GitHub asset and SHA256SUMS match: cdf97b4a1a4980c8ba3e70661c3ed26ef7db853530642d31e2ca40c598718450.

CI history: the final PR and tag matrices passed on all three platforms. The first post-merge run had a macOS anchor-scroll assertion failure and a Windows temporary-folder cleanup failure. Both jobs passed on one rerun with unchanged code; these intermittent test failures remain recorded in the workflow history.

HTMLEdit 1.5.1 — Safari editing and reliable save/copy

HTMLEdit 1.5.1 — Safari editing and reliable save/copy

Safari can now select document elements and open the inline text editor while keeping document scripts disabled. The fixes preserve 1.5.0 multi-selection, immediate batch deletion and joint notes.

• Use a parent-owned event surface when Safari blocks listeners in the sandboxed preview; keep Ctrl/Cmd selection, Delete and one-step undo/redo working without duplicate keyboard handling.
• Start clipboard permission handling during the click gesture and provide the AI request only after saving succeeds. Failed saves and conflicts preserve the previous clipboard.
• Correct Home/End scrolling in Safari and retain nested scrolling, note-marker positioning and responsive-width previews.
• Preserve review v1/v2, target IDs and joint-note metadata. No review-format migration is required.

Verification

The integrated candidate passed 86 unit tests on Windows, Ubuntu WSL2 and macOS; 132 Windows Chrome/Edge browser cases; and 66 Chrome cases on each of Ubuntu and macOS. Package lifecycle checks and formatting passed.

On the physical Mac, actual Safari 18.6 passed multi-selection, batch delete/undo/redo, joint-note save/reopen, clipboard and download, image editing, scrolling and controlled save-failure/conflict checks. Actual Claude followed the installed skill's checkout/apply procedure in WSLg Chrome, Mac Chrome and Safari, preserving both joint targets and verifying backups and automatic refresh. See the integration record for hashes, environment versions and evidence limits.

Earlier manual tests separately confirmed Safari click/double-click and Korean IME input/apply in Safari and WSLg. WSL required IBus Hangul configuration. Native picker checks were historical and were not repeated for this patch; picker code is unchanged. Windows Chrome/Edge remain primary, with other platform claims limited to the recorded environments.

Update

Run outside the HTMLEdit source checkout:

npx --yes @woody_s/htmledit@1.5.1 install --agent all

Save work and stop/reopen old editor sessions to load the new runtime. Existing skills and already-running servers are not automatically replaced. Documents and backups are preserved. Use --agent claude or --agent codex to update one skill.

Publication follows main CI, then tag v1.5.1, then GitHub Actions OIDC trusted publishing. No local npm publish is used.

Publication verification

• Source: c4fef7f5739bfa834bd072be0226d2118d93afa3.
• Main CI passed on Windows, Ubuntu 24.04 and macOS 15 before tag push: 86 unit tests per OS, 132 Windows Chrome/Edge cases, 66 Chrome cases each on Ubuntu/macOS, plus package lifecycle checks.
• Release workflow passed using GitHub OIDC trusted publishing; npm publisher is GitHub Actions.
• Public npm version and latest: 1.5.1.
• The npm and GitHub tarballs are byte-identical and match the attached SHA256SUMS.
• SHA-256: 67fa19e01d2a2c12c34a742a597132b10ba9588f27b160458531489cfee88749.
• Provenance matches tag v1.5.1, .github/workflows/release.yml and the source commit above.
• A fresh isolated public-registry installation passed both skill installations and a v2 joint-note status → checkout → apply → status smoke, preserving both target IDs, original bytes and exact backup bytes. This is a deterministic publication smoke, separate from the actual Claude candidate verification described above.
• npm audit signatures: one verified registry signature and one verified attestation. A separate npm cache was used after initial stale registry metadata delayed discovery of the new version.

Existing user skill installations and running editor sessions were preserved. Update and reopen as described above to load 1.5.1.

HTMLEdit 1.5.0 — Joint notes and immediate deletion

HTMLEdit 1.5.0 — Joint notes and immediate deletion

Select several elements with Ctrl+click (or Cmd+click) and leave one request covering the entire group. Every target shows the same note number. For example, select two headings and ask the AI to swap their positions.

• Click normally to select one element; Ctrl/Cmd+click adds or removes targets.
• Del deletes the selected elements without confirmation. Ctrl/Cmd+Z restores the entire deletion in one step. The delete buttons use the same behavior. Text inputs, inline editors, dialogs and Interact mode are protected from element deletion.
• Joint notes retain all target IDs, expose missing targets and can be reassigned. AI apply preserves the entire target list and only completed requests should be marked done.
• Multiple selection supports joint notes and batch deletion. Text, color, size and image editing continue to use one selected element.
• UI, error messages, AI request text and documentation cover all five existing languages.

Compatibility and update

Single-target reviews continue to use review v1. Files containing joint notes use review v2. Older runtimes explicitly reject v2 rather than silently dropping targets. Update both the editor runtime and the skills that process its notes:

npx --yes @woody_s/htmledit@1.5.0 install --agent all

Run this outside the HTMLEdit source checkout. Use --agent claude or --agent codex to update one skill. Save current work, stop the old editor session when finished, and reopen with the updated runtime. Existing servers keep their loaded code until restarted. Original documents, review files, candidates and backups are preserved. HTML containing only v1 notes remains compatible with previous releases; a v2 file requires the new runtime. Final HTML exports remove either metadata version.

Verification

Local checks: build and formatting, 82 unit tests, 114 Windows Chrome/Edge regression cases, 16 final focused cases across five languages, built CLI v2 checkout/apply and package lifecycle smoke. An actual user-created joint note was interpreted by this Codex session: two heading elements were swapped, both IDs and the entire note were preserved, only the fulfilled request was completed, and backup bytes and Chrome rendering were verified. See the detailed evidence and limits.

The platform scope is unchanged. Windows Chrome/Edge remain primary; Linux/macOS launchers and pickers remain experimental. CI runs on Windows, Ubuntu 24.04 and macOS 15. These automated checks do not substitute for native Safari, native file-picker interaction, or a new actual Claude verification. Publication uses tag-triggered GitHub OIDC trusted publishing; no local npm publish is required.

Release validation

• Source: 1682a9a2894a7d9271d5d4306de4cc6535bc5989.
• Main CI: Windows, Ubuntu 24.04 and macOS 15 passed. Each ran 82 unit tests; Windows ran 114 Chrome/Edge cases, Ubuntu and macOS each ran 57 Chrome cases. All passed package lifecycle checks.
• The first macOS run exposed a test input mismatch (literal Control+click rather than Cmd+click). The final commit uses the platform-native modifier and passes all macOS cases; the application selection code was unchanged by that correction.
• Actual Codex joint-note interpretation, candidate-only editing, target preservation, completed-note marking, exact backup and rendering evidence are recorded in the verification document.

Publication receipt

• Release workflow: GitHub OIDC trusted publishing; npm publisher is GitHub Actions.
• Public npm version and latest: 1.5.0.
• npm and GitHub tarballs are byte-identical and match the attached SHA256SUMS.
• SHA-256: 2c230dc6a46e4d8a59df31b3661157a409f1560850047bc429df69903e7f74fc.
• Provenance resolves to tag v1.5.0, workflow .github/workflows/release.yml and source commit 1682a9a2894a7d9271d5d4306de4cc6535bc5989.
• A fresh isolated registry installation passed a v2 joint-note status → checkout → apply → status replay, preserving both targets and exact backup bytes. This publication smoke is distinct from the actual Codex interpretation recorded above.
• npm audit signatures: one verified registry signature and one verified attestation.

Existing user skill installations and already-running editor servers were not automatically replaced. Use the 1.5.0 update command above and reopen the editor to use the published runtime.

HTMLEdit 1.4.1 — Table-of-contents navigation fix

HTMLEdit 1.4.1 — Table-of-contents navigation fix

Clicking a table-of-contents link such as #section in Interact mode could navigate the preview frame to the editor's localhost address, replacing the document with a connection or frame-loading error. HTMLEdit now scrolls to the target inside the document. Switching back to Edit directly keeps that scroll position.

• Supports element IDs, percent-encoded IDs, legacy named anchors and empty/top fragments. Missing targets leave the document open.
• Preserves the document's links when saving. External navigation restrictions and iframe isolation remain in place.
• No review-format, file-path or checkout/apply changes. Documents and notes do not need migration.

Update

npx --yes @woody_s/htmledit@1.4.1 install --agent all

Use --agent claude or --agent codex to update one skill. Save your work and reopen the editor in a new session after updating; an already-running server keeps its loaded runtime. Originals, review files and backups are preserved.

Verification

Local build, formatting and 78 unit tests passed. Chrome and Edge passed 10 interaction cases plus two connected-frame API isolation cases. An actual nine-section document was checked in Edge: every table-of-contents link scrolled correctly, and returning to direct editing preserved the current section. The user's private document is not included in the repository.

The platform scope remains unchanged: Windows Chrome/Edge are primary; Linux/macOS remain experimental, with the previously documented manual Safari/native-picker checks outstanding. Publication uses the existing tag-triggered GitHub OIDC trusted-publishing workflow.

Release validation

• Main CI: Windows, Ubuntu 24.04 and macOS 15 passed for commit 92d62cbc19fe9ad598ec7f7aa7ca944b8cfa2410 (78 unit tests per platform; 98 Chrome/Edge cases on Windows, 49 Chrome cases on each other platform; package lifecycle checks).
• The initial macOS visual comparison differed at two link-edge pixels by 7/255; the measured rendering tolerance is documented in the repository verification record.
• One Ubuntu CI attempt missed the first anchor scroll. The unchanged source passed 20 local Ubuntu repetitions and the Ubuntu CI rerun; the original failed attempt remains available. This was not counted as a first-attempt pass.
• Trusted-publishing workflow is triggered by v1.4.1. No local npm publish was used.

Published package verification

npm latest is 1.4.1, published by GitHub Actions with OIDC provenance tied to the release tag and exact source commit. Isolated registry installation and CLI startup passed; npm audit signatures verified the registry signature and attestation.

The npm and GitHub tarballs are byte-identical and match SHA256SUMS. SHA-256: 988c92cc4f42f9ccdd052d8bf0c83441907c271ef7ddd5bf844229e0c802764c.

HTMLEdit 1.4.0 — Image insertion

HTMLEdit 1.4.0 — Image insertion

Select where an image belongs, bring it in from a local file, a direct image URL or the clipboard, and preview it before applying. Images are embedded in the HTML so the same file can be handed to Claude Code or Codex for further layout changes.

• Insert before, after or at the end inside a selected element. Invalid insertion positions are disabled.
• Set proportional width, left/center/right alignment and alternative text. Cancel the preview or apply it as one undo step.
• Replace existing images using the same file, URL and paste inputs while preserving their layout styles.
• PNG, JPEG, WebP and GIF are supported, up to 10MB per image and 25MB for the entire saved HTML. URL downloads follow browser access restrictions; use a file or paste if a site blocks retrieval.
• Korean, English, Spanish, Japanese and Brazilian Portuguese interfaces and guides are included. Review format v1 and the existing checkout/apply workflow are unchanged.

Update

npx --yes @woody_s/htmledit@1.4.0 install --agent all

Run outside the source checkout. Use --agent claude or --agent codex for one skill. Reopen the editor and start a new AI session after updating; existing editor sessions keep their previous runtime. Save your current work before switching sessions. Originals, working files and backups are preserved.

Validation and platform scope

Local validation passed 78 unit tests on Windows, Ubuntu WSL2 and a physical Apple Silicon Mac; 96 browser tests on Windows Chrome/Edge and 48 each on Linux and Mac Chrome; and package installation/lifecycle checks on all three platforms. An actual Codex checkout/apply test verified image-note interpretation, automatic browser refresh, preserved image bytes, a matching backup and clean export. See verification details.

Windows Chrome/Edge remain the primary supported environment. This release also includes experimental Linux/macOS browser launchers and native document pickers, plus a macOS runtime reinstall fix for aliased paths. Automated coverage used Ubuntu 24.04 WSL2 and macOS 15.6.1 Apple Silicon Chrome. Safari and manual native-picker operation remain unverified; these results do not certify other Linux desktops, Intel Macs, or unattended native AI sessions. Translations have not had native-speaker review.

Publication uses the existing GitHub tag-triggered OIDC trusted-publishing workflow. The GitHub release tarball is downloaded from npm and accompanied by SHA256SUMS.

Publication verification

• Main CI: Windows, Ubuntu and macOS passed.
• Trusted-publishing workflow: succeeded for tag v1.4.0, commit 0cc9b16b5d41b1d0ef69d563d597bbfe022ebc65.
• npm latest is 1.4.0. Registry signature and provenance attestation verified with npm audit signatures; isolated installation and CLI startup passed.
• npm and GitHub tarballs are byte-identical. SHA-256: 0bc6daf0b35ac04d4f15bb1b2ee9f573ad2e8d58cdbf53c1eaf666f36c17e5d5 (also recorded in SHA256SUMS).

HTMLEdit 1.3.0

HTMLEdit 1.3.0

Use HTMLEdit in Korean, English, Spanish, Japanese, or Brazilian Portuguese, from installation and editing to element-linked notes and AI handoff.

• Translated editor controls, diagnostics, CLI help, examples, and installation/use/troubleshooting guides.
• Automatic language detection and a language picker. Switching languages preserves selections, unsaved text and notes, and undo history.
• Connected language preferences persist across documents and ports. CLI --lang supports temporary overrides.
• User HTML, note content, filenames, target IDs, and review format version 1 remain unchanged. Earlier 1.2.2 review files remain compatible.
• English Claude Code and Codex skill instructions guide responses and button names in the user's language.

Install or update

Run outside the HTMLEdit source checkout with Node.js 22.12 or newer:

npx --yes @woody_s/htmledit@1.3.0 install --agent all
npx --yes @woody_s/htmledit@1.3.0 open "./document.html"

Use --agent claude or --agent codex for one skill. Start a new editor session after updating, and a new AI session if the updated skill is not listed.

Validation

• 51 unit tests and 82 browser tests across Windows Chrome and Edge passed locally, plus packaged installation/workflow smoke checks.
• Actual Codex and separate Claude Code workflows each applied five multilingual notes using checkout/apply. Independent file checks, backups, automatic refresh, and clean exports passed.
• Claude's successful test used user-selected manual approval mode. It does not claim that the separate CLI API-key issue or automatic approval restriction was fixed.
• No native-speaker translation review was performed. Windows Chrome and Edge remain the supported desktop environment.

See verification details and the five-language documentation.

HTMLEdit 1.2.2

기존 AI 요청 복사 버튼은 메모를 파일에 저장하지 않아 별도 저장 단계가 필요했습니다. 이제 저장하고 AI 요청 복사를 누르면 현재 수정과 추가한 메모를 먼저 저장하고, 그 작업 파일을 가리키는 요청을 복사합니다.

• 연결 모드는 작업 파일을 저장하며, 다운로드 모드는 전달용 HTML을 내려받습니다.
• 미적용 입력, 저장 실패·충돌, 저장 중 추가 편집이 있으면 복사를 중단합니다.
• 저장 후 클립보드 복사가 실패하면 사용 방법에서 전달 문구를 직접 복사할 수 있습니다.
• Claude·Codex 스킬과 사용 안내도 새 흐름으로 업데이트했습니다.

검증: 1.2.2 tarball을 별도 사용자 환경에 설치하고, 내장 브라우저에서 직접 편집과 메모 3개 작성 → 저장·요청 복사 → 실제 Codex checkout/apply → 열린 화면 자동 갱신까지 통과했습니다. 제목 변경·SVG 추가·설명 삭제, 완료 상태, 기존 문구와 메모 정보 보존, 반영 전 백업을 확인했습니다. 이번 실제 AI 반영은 Codex 데스크톱에서 수행했습니다.

• Windows CI 통과: 단위 테스트 44개, Chrome·Edge 테스트 64개, 빌드·형식 검사·패키지 설치 검증.
• 태그 배포 워크플로
• 상세 검증 기록

업데이트는 HTMLEdit 소스 저장소 밖의 폴더에서 실행하세요.

npx --yes @woody_s/htmledit@1.2.2 install --agent all

업데이트 후 새 편집기 세션을 열어 사용하세요. GitHub Actions의 태그 기반 trusted publishing으로 게시하며, 릴리스 tarball은 npm 레지스트리에서 내려받은 파일입니다. SHA-256은 첨부한 SHA256SUMS에서 확인할 수 있습니다.

HTMLEdit 1.2.1 — 소스 보기 복원 수정

HTMLEdit 1.2.1

브라우저의 소스 보기로 저장한 HTML을 다시 정렬한 경우, 복원 시 화면 ID 안에 줄바꿈이 들어가 메뉴 전환이 멈추던 문제를 수정했습니다. 소스 보기의 행 경계를 기준으로 원본 줄바꿈을 복원해 ID와 스크립트를 유지합니다.

• 공백·빈 행·엔티티·스크립트 보존 및 ID 기반 메뉴 전환 회귀 테스트를 추가했습니다.
• Codex 1.2.0 스킬의 문서 열기 → 화면 편집 → 메모 3개 저장 → AI 반영 → 자동 갱신 → 완성본 저장 실사용 검증 기록도 포함했습니다.
• 기존 작업 사본은 자동으로 재생성하지 않습니다. 이미 손상된 작업 사본은 백업 후 개별 복구가 필요하며, 이번 수정은 소스 보기 파일을 새로 가져올 때 적용됩니다.

업데이트

HTMLEdit 개발 저장소 밖의 폴더에서 실행하세요.

npx --yes @woody_s/htmledit@1.2.1 install --agent all

기존 작업을 저장한 뒤 새 스킬로 다시 여세요. 이전 서버 버전 안내가 나오면 해당 작업 파일의 서버를 종료하고 다시 열면 됩니다.

배포

v1.2.1 태그로 GitHub Actions의 npm trusted publishing을 실행합니다. 릴리스의 tarball은 npm 레지스트리에서 내려받은 파일이며 SHA256SUMS를 함께 제공합니다. 검증 기록

검증 결과

• Windows CI: 빌드, 형식 검사, 단위 테스트 44개, Chrome·Edge 브라우저 테스트 54개, 패키지 설치 검증 모두 통과.
• 실제 문제가 발생했던 소스 파일의 화면 ID 8개가 정상 복원됨을 확인했습니다. 기존 작업 사본을 백업 후 복구하고 내장 브라우저에서 전체 채팅으로 이동하는 것도 확인했습니다.
• 릴리스 커밋: 9004ed23a548e87ed0f16caa71ceaef4c1ae9e61.

공개 게시 확인

• Release 워크플로의 publish·release job 모두 성공했습니다. 로컬 npm publish는 실행하지 않았습니다.
• npm latest: 1.2.1. GitHub Actions OIDC trusted publisher와 SLSA provenance를 확인했습니다. _resolved·_from 경로 필드는 없습니다.
• GitHub 첨부 tarball과 레지스트리 tarball 및 SHA256SUMS가 일치합니다.
• SHA-256: 6e7c76d7b15907cc8978b6d4d7f1befe189853eb59e0f43d50ed8ede0d92743d

HTMLEdit 1.2.0 — 다른 문서 열기

HTMLEdit 1.2.0

Claude Code·Codex와 파일을 공유하는 편집기에서 다른 문서 열기를 사용할 수 있습니다.

• 미저장 작업의 저장 여부를 확인한 뒤 Windows 파일 선택 창으로 새 HTML을 엽니다.
• 기존 작업 사본은 덮어쓰지 않고 다시 연결합니다. 취소·오류·동일 파일 선택 시 현재 작업을 유지하고, 저장 충돌 시 전환을 중단합니다.
• 저장하지 않고 전환한 변경은 이전 문서의 임시 작업에 보관합니다. 이전 서버와 백업도 유지됩니다.
• API로 임의 파일 경로를 받지 않습니다. 같은 출처와 인증을 확인한 요청이 OS 파일 선택 창을 열고, 사용자가 선택한 파일에 별도 연결을 만듭니다.

설치 및 업데이트

Node.js 22.12 이상이 필요합니다.

npx @woody_s/htmledit@1.2.0 install --agent all

기존 편집기의 작업을 저장한 뒤 새 스킬로 문서를 다시 여세요. 이전 버전의 서버가 실행 중이라는 안내가 나오면 해당 작업 파일의 서버를 종료하고 다시 엽니다. 다른 문서를 연 뒤 AI에게 보낼 설명 복사로 새 작업 파일 경로를 Claude·Codex에 전달하세요.

파일 선택 창은 Windows를 지원합니다. 다른 운영체제에서는 기존처럼 AI에게 파일을 열어 달라고 요청할 수 있습니다.

검증

Windows CI에서 빌드, 단위 테스트 43개, Chrome·Edge 브라우저 테스트 52개 및 패키지 설치 검증을 모두 통과했습니다. CI 결과 Chrome·Edge에서 새 문서 연결, 미저장 확인, 취소·오류·기존 사본 보존, 저장 충돌을 검증했습니다. 실제 Windows 파일 선택 후 새 문서에서 편집·저장되는 것도 확인했습니다. 자세한 검증 이력은 docs/SKILLS_VERIFICATION.md를 참고하세요.

이 릴리스는 v1.2.0 태그를 통해 GitHub Actions의 npm trusted publishing으로 게시합니다. 첨부 tarball은 npm 레지스트리에서 받은 파일이며 SHA256SUMS를 함께 제공합니다.

새 Claude Code Remote Control 세션에서도 공개 1.2.0 설치 → 첫 문서 편집 → 저장 후 다른 문서 선택 → 새 문서 메모 저장 → Claude 반영 → 편집기 자동 갱신을 확인했습니다. 첫 작업 파일과 두 원본 보존, 메모 정보 보존, 백업 일치도 별도로 검증했습니다. 검증 기록

개발 저장소 자체에서 동일 버전을 npx로 실행하면 npm이 로컬 패키지를 먼저 선택할 수 있습니다. 공개 설치 명령은 저장소 밖의 폴더에서 실행하세요.

HTMLEdit 1.1.1

Full Changelog: v1.1.0...v1.1.1