From ee107a5959f9582bae61a4e787cc2016354a0bd4 Mon Sep 17 00:00:00 2001 From: kali-upper Date: Sat, 17 Oct 2026 02:17:35 +0300 Subject: [PATCH 01/22] docs: sync docs for AutoClaw suite, app-cloning playbook, per-clone bots - README/docs cover the 8th IDE suite (AutoClaw) + its GHOST.bat submenu [4] - APP_CLONING_PLAYBOOK / EDGE_CASES / INTAKE_TEMPLATE: generic clone-any-app methodology (identity suite, never-silently-degrade rule, icon policy) - AGENTS.md: AutoClaw conventions, elevation ground truth, cloning playbook - CHANGELOG: Unreleased accumulates both features (kept Unreleased until the 1.1.0 release commit) --- AGENTS.md | 199 ++++++++++++++- CHANGELOG.md | 62 ++++- README.md | 21 ++ docs/APP_CLONING_EDGE_CASES.md | 310 ++++++++++++++++++++++ docs/APP_CLONING_INTAKE_TEMPLATE.md | 83 ++++++ docs/APP_CLONING_PLAYBOOK.md | 369 +++++++++++++++++++++++++++ docs/README.md | 4 + docs/ZCODE_CHAT_SYNC_WATCHER_PLAN.md | 2 +- docs/architecture.md | 49 +++- docs/cli.md | 12 +- docs/getting-started.md | 2 +- docs/troubleshooting.md | 12 +- 12 files changed, 1098 insertions(+), 27 deletions(-) create mode 100644 docs/APP_CLONING_EDGE_CASES.md create mode 100644 docs/APP_CLONING_INTAKE_TEMPLATE.md create mode 100644 docs/APP_CLONING_PLAYBOOK.md diff --git a/AGENTS.md b/AGENTS.md index 09d2d7e..3c7c21a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,22 +2,26 @@ ## Project overview -Fresh-start toolkit for local AI-IDE identity stores — **Cursor**, **Windsurf/Devin Desktop**, **Trae**, **Qoder**, **ZCode**, **QoderWork**, **MiniMax Agent/OpenCode** — for privacy hygiene, multi-account testing, and dev-environment resets. Windows PowerShell (primary) and Linux Bash scripts. +Fresh-start toolkit for local AI-IDE identity stores — **Cursor**, **Windsurf/Devin Desktop**, **Trae**, **Qoder**, **ZCode**, **QoderWork**, **MiniMax Agent/OpenCode**, **AutoClaw** — for privacy hygiene, multi-account testing, and dev-environment resets. Windows PowerShell (primary) and Linux Bash scripts. ## Repository layout ``` README.md AGENTS.md GHOST.bat/ghost.sh # root launchers (scripts live under src/; # CLI cheat sheet: docs/cli.md); GHOST.bat = - # 3 submenus with CONTINUOUS LOCAL numbering - # (IDE resets [1]-[8] / ZCode Multi-Instance & + # 4 submenus with CONTINUOUS LOCAL numbering + # (IDE resets [1]-[9] / ZCode Multi-Instance & # Clones [1]-[17] / System & GHOST Maintenance - # [1]-[2]) + ANSI colors + local chained input + # [1]-[2] / AutoClaw Multi-Instance & Clones + # [1]-[12]) + ANSI colors + local chained input # per submenu (e.g. "1 3 4"), main-menu sub-paths # ("2 1 3 4" = ZCode then run its [1] [3] [4]), # global gid jump from the main menu, and # [U] Check for updates on the main menu src/windows/ # current .ps1 resetters (unversioned names) + identity_utils.ps1 + change_device_id.ps1 + # + launch_autoclaw_clone.ps1 (AutoClaw clone launcher, + # -Instance inst1..inst4 + -Status) + Launch-AutoClaw-Clone.bat + # + reset_autoclaw.ps1 (-Target Primary|inst1..4|All) src/linux/ # .sh scripts (id_reset_common.sh + per-IDE resetters) src/python/ # stdlib-only Python core (ghost/ package) + ghost_cli.py bootstrap — # owns the shared SQLite/JSON identity logic; the PS bridges @@ -122,6 +126,35 @@ tools/ # reviewed utilities (block_qoder_domains.ps1 # overwrite-edits prompt); GHOST.bat replaced by either path # prints a close-and-relaunch note (cmd reads the .bat # incrementally) + # patch_autoclaw_ports.ps1 (+ .mjs engine v10) — one-time app.asar + # patch widening AutoClaw's hardcoded MCP candidate-port array + # [19681..19684] -> [19681..19688] + home-override (the state-dir +# isolation marker .autoclaw-home; see the ELEVATION bullet below) + # multi-instance ceiling; inst4 has no port without it); + # backup + marker (autoclaw-ports-patch.marker.json) + -Restore + # (verified byte-identical) + node --check gate; AutoClaw must be + # closed; an app update reverts it (all instances run with + # system.autoUpdate=false as the guard); AutoClaw submenu [11]; + # install_autoclaw_clone_shortcuts.ps1 — per-user Desktop + + # Start-menu shortcuts for inst1..inst4 (AppUserModel.ID = + # com.zhipuai.autoclaw.inst1..4; base read from the Primary .lnk + # or the verified app constant; -Instance to scope; -Remove; + # -RepairPrimaryAumid strips a hijacked .instN suffix + restores + # ,0 icon; .lnk AUMIDs read ONLY via Shell.Application + # ExtendedProperty); per-clone IconLocation = + # tools\autoclaw--branding\tray_icon.ico,0 (blue/yellow/ + # green/red ← inst1..4; missing dir warns + falls back to the + # exe icon); AutoClaw submenu [2] + # make_clone_icon.ps1 — GENERIC clone-icon generator (any app, + # PS 5.1 + System.Drawing only): corner-sampled background → + # tile detection (LongestLowRun profiles, -BgTolerance, or + # -ManualCrop x,y,size) → inset crop → 1024 master + + # rounded-corner alpha mask → tray_icon.ico (16..256 + # PNG-in-ICO) + icon_windows.png + source. provenance; + # -HueRotate derives extra colors (autoclaw-red-branding = + # blue master +150°); re-runs reuse the transparent-corner + # master; verify-after + TEMP previews; built for the + # opencode/cline future clones — do not delete ``` ## Architecture @@ -130,7 +163,6 @@ tools/ # reviewed utilities (block_qoder_domains.ps1 src/windows/identity_utils.ps1 # Shared library, dot-sourced by all IDE scripts New-IdentitySet # -> { devDeviceId, machineId, macMachineId, sqmId } Assert-Administrator # -> exit 1 if not elevated - Stop-AppProcesses # -> kill loop (auto-expands Windsurf->Devin+codeium, Trae->Broker) Backup-FileToTimestampDir # -> copy to \ID_Backups\\