openhop

Changelog

Every version, newest first.

What changed in openhop and on this site. One list with two depths: plain words, or the details if you write code.

  1. v3.3.6

    Honest status while openhop looks for a free IP

    In plain words

    • While openhop is still looking for an address with free messages, the main panel now says Looking for an IP with free messages…, with how many addresses were already used up and a note to come back in a few minutes. Before, it said “Everything is working” between two tries, and then the limit came back.
    • The tray notification works the same way: one “Looking for an IP with free messages” notice instead of “you can keep going” after every try.
    • Fewer false antivirus alarms: openhop.exe is now built with its own launcher instead of the generic one many antivirus programs distrust, it shows its name, version and description in the file's Properties, and it's a third smaller (about 21 MB instead of 32) because unused parts were left out.

    Under the hood

    • _build_health() gets failed_hops / last_ok_hop from the guard state. Status is busy while a hunt is on (a re-wall within 180 s) or the newest limit error is later than the last hop and under 3 min old; health.hunting tells the tray. “Looks resolved now” is only said when there was no limit error in the last 3 min.
    • Build: PyInstaller bootloader compiled from source (tools/build_bootloader.ps1, MSVC) instead of the stock one; Windows version resource (--version-file); unused native modules excluded (cryptography, bcrypt, tornado, ujson, markupsafe, parts of pywin32 and Pillow). Unsigned PE files inside the exe went from 28 to 14.
  2. v3.3.5

    Tries more addresses, and a clearer first start

    In plain words

    • At busy hours most shared WARP addresses already used up their free messages (we saw 7 in a row). openhop now tries up to 15 addresses in a row instead of 8 before pausing.
    • Opening openhop again while it's still starting no longer closes the copy that was starting. It waits for that window and brings it to the front.
    • openhop now writes a short startup log (%LOCALAPPDATA%\openhop\logs\startup.log), so if it ever opens and closes by itself we can see why.
    • The install steps on the website now list everything you need: OpenCode, the Cloudflare WARP (1.1.1.1) app and WebView2. There's also a new FAQ entry for when openhop doesn't open.

    Under the hood

    • Guard: FAILED_HOPS_MAX 8 → 15 (live run: 7 used-up /64s in a row before a fresh one).
    • Window process: named mutex Local\openhop-UI. A second copy that finds it held waits up to 60 s for the first copy's window instead of killing it with _kill_previous_instances(); windows of other versions are still replaced.
    • logs/startup.log (start, set-up, window shown, closed, errors; capped at 256 KB) is written from before the heavy imports; faulthandler writes hard crashes to logs/crash.log; any unexpected exception in main() is logged and shown instead of exiting silently.
  3. v3.3.4

    Fixes OpenCode being blocked, and finds an IP with messages left

    In plain words

    • Important fix: 3.3.3 could wrongly decide that WARP wasn't protecting you and block OpenCode with "WARP isn't protecting the connection right now". The check itself was broken, not WARP. If you saw that message, update.
    • Free messages are counted per IP and per day, and reset between 1:00 and 2:00 at night (UTC). WARP and Tor addresses are shared, so the next one is often already used up. When the limit comes back right after a new IP, openhop now tries the next address straight away, up to 8 in a row, instead of waiting and giving up after 2.
    • Addresses that were already used up are skipped until their counter resets that night, instead of forever.
    • After a new IP, OpenCode's open connection is closed first, so the automatic 'continue' really goes out with the new address.
    • Tor mode now checks the new exit and skips exits that were already used up today.

    Under the hood

    • trace_warp_path() passed --noproxy * together with -x; curl then ignores -x, so App-only mode always measured the direct path (warp=off) and the proxy refused OpenCode with NoRealIpError. --noproxy is now used only on the direct path.
    • New bump_egress_epoch() (lane/egress_epoch): called after every successful hop (WARP, Tor, custom, manual). zen_proxy polls it every second and closes OpenCode tunnels opened before it.
    • Guard: FAILED_HOPS_MAX 2 → 8; a re-wall within REWALL_SECONDS rotates again after 12 s instead of the 75 s cooldown. Blacklist entries carry an expiry (burnt_until, next_free_reset() = next 01:05 UTC); old entries without one are dropped.
    • Tor: the exit is measured with trace_via_socks() before and after NEWNYM; burnt exits are retried up to 4 times, 10 s apart.
  4. v3.3.3

    No more limit loop, and a button to report problems

    In plain words

    • Fixed the loop where the chat hit the free limit again a few seconds after every new IP. Sometimes Cloudflare WARP says it's connected but OpenCode goes out with your own IP. openhop now checks the real path, tries to repair WARP by itself, and never sends OpenCode out unprotected: it waits instead.
    • If WARP can't be repaired automatically, the status panel says so, with a Repair button and what to try next.
    • New Report a problem button at the top: it sends a diagnostic report to the developer. You see exactly what's in it before sending, and your user name, folders, passwords and full IP are removed on your PC first. Reports are kept on openhop.cfd for 90 days at most, so problems can be worked through, and then deleted.
    • If openhop was running in the background and you open it when an update is ready, you get the notification right away. Clicking it takes you to the window and highlights the Update now button.

    Under the hood

    • trace_warp_path() reads /cdn-cgi/trace through the WARP SOCKS port; get_egress_v6() only accepts an IP when warp=on|plus. The result goes to lane/warp_leak.json, read by warp_path_leaking().
    • The keeper checks the path every 20 s and repairs a leak (reconnect, then endpoint reset + rotate-keys), at most once per 120 s. The guard stops rotating while it leaks. The proxy answers 503 for opencode.ai instead of falling back to a direct connection (NoRealIpError).
    • Report: report_bundle.py builds and redacts the report on the PC; POST openhop.cfd/api/report is rate-limited by the ReportGuard Durable Object, forwarded to Discord from a Worker secret and saved in the ReportStore Durable Object (90 days, 500 MB max; private /api/reports behind a token). Each report gets an ID.
    • Opening the window runs a throttled update check (_on_window_opened()); notification card clicks go to body_action (show_update → window.focusUpdate()). Launching a second copy no longer swaps the exe under a running one.
  5. v3.3.2

    It tells you when it updates, and checks itself after

    In plain words

    • When a new openhop comes out while the app is open, you get a notification and a bar at the top with an Update now button. The tray notification has the same button.
    • Update now replaces the program completely and reopens it: your settings and the background protection stay as they are. No download folder, no reinstalling.
    • Right after updating, openhop runs a few quick checks by itself (new version, right file, settings, proxy, protection, connection) and tells you how it went. If something is off, the bar says what, and Run checks again repeats them.

    Under the hood

    • updater.install() writes update/just_updated.json (from, to, sha256, at) before Popen. The new process consumes it with take_just_updated(): one-shot, 15 min TTL, only when to == VERSION.
    • New run_post_update_checks() builds {ok, passed, total, checks[]} and saves it to update/last_check.json; updater.state() exposes it as post. _start_post_update_checks() waits up to 20 s for :41987, then runs it once; run_update_checks() backs the button.
    • Checks: version, exe SHA-256 against the downloaded file (automatic run only), settings JSON parses, proxy port, keeper and guard mutexes, worker fingerprint (_STAMP_FILE vs _bundle_fingerprint()), and no bad health issues. The notification honors notify_updates.
    • UI: #updateBar now has two modes (update waiting / just updated), a toast once per session, and a per-report Hide in localStorage. The tray action label is Update. Nothing is written outside %LOCALAPPDATA%\openhop\update.
  6. v3.3.1

    A shorter break, and it retries by itself

    In plain words

    • If two new addresses hit the free limit right away, openhop used to stop rotating for 10 minutes. Now it rests for 2 minutes, then tries one more address on its own, without you doing anything.
    • The warning now has a Try now button: one click gets a new IP immediately instead of waiting.
    • It no longer points you to Tor as the only way out. If the new address is also used up, it says so, pauses again and keeps trying.

    Under the hood

    • BACKOFF_SECONDS 600 → 120. It still pauses after FAILED_HOPS_MAX = 2 walls that come back inside REWALL_SECONDS = 180; the rest of the loop logic is unchanged.
    • New _end_pause() runs on every tick: when the pause expires and chats are still in pending, it hops once and lets _rotate() dispatch auto-resume, instead of waiting for the next wall line. It clears failed_hops, hop_counted and backoff_logged first, so a bad block still counts once.
    • The health warning for the pause now carries fix="hop" (Try now). hop_now() is unchanged and already ignored the pause.
    • No writes to opencode.db: the drafts.sqlite unlock still runs before every auto-resume, and the source browser only sees this app repo.
  7. Website

    The site has its own scrollbar

    In plain words

    • The page no longer uses the browser's scrollbar: a thin, square one in the site's grey that turns amber when you grab it.
    • It looks the same in light and dark, and wide code tables keep their own scrollbar.

    Under the hood

    • One CSS block: ::-webkit-scrollbar (10 px, square, --dim thumb, --amber on hover, --amber-hi while dragging) plus a Firefox-only @supports (-moz-appearance: none) gate for scrollbar-width: thin / scrollbar-color. The gate matters: Chromium 121+ drops the ::-webkit-* rules once the standard properties are set.
    • No radius, images, JavaScript or overflow changes. The track is transparent, so it blends with --bg and .sec-dark; checked light, dark, horizontal code tables and the source tree.
  8. Website

    A changelog you can actually read

    In plain words

    • This page. Every version, newest first, in two depths: one in plain words, one for people who write code.
    • It is built from the same data as the rest of the site, so it moves with every release.

    Under the hood

    • Static, bilingual page generated at build time from src/changelog.mjs; both audiences are rendered in the HTML and switched by CSS plus a few lines in site.js.
    • Without JavaScript both lists show, each with its own label, and the switch is hidden. No content depends on a script.
  9. v3.3.0

    Token usage, in plain numbers

    In plain words

    • A new card under the status panel shows how much OpenCode has used on this PC: total tokens, input and output, cache, and how many chats and projects.
    • It refreshes by itself every minute. Reasoning tokens and an estimated cost sit next to it.
    • It only reads OpenCode's own data file, in read-only mode. If it can't (first run, file busy), the card hides instead of showing you zeros.

    Under the hood

    • _read_token_stats(): one read-only query over session_v2 (file:…?mode=ro, PRAGMA query_only=ON) summing input, output, reasoning, cache read, cache write and cost, with COUNT(DISTINCT project_id) and time_updated in ms turned into seconds.
    • AvatarControlApi.get_token_stats() caches the result for 60 s and is deliberately not part of get_state(), so the 3 s status poll never opens SQLite.
    • Total = input + output + cache read + cache write. Reasoning is shown separately (providers already count it inside output) and never added. Child and archived sessions are included on purpose.
    • Any failure (missing, corrupt, locked, old schema, empty) returns ok: false and the card stays hidden. The advanced grid gets a tokens area; tools/preview_ui.py mocks the API for screenshots.
  10. v3.2.0

    The status panel stops guessing

    In plain words

    • It only says “Everything is working” after a real check reaches opencode.ai through openhop. Until then it says “Checking the connection…”.
    • If OpenCode is installed but not pointed at openhop, it says so and offers a Connect button.
    • If a background helper is running but silent for 4 minutes, it tells you and offers Restart.
    • A new address that hits the limit again within 3 minutes, twice in a row, now pauses automatic rotation for 10 minutes instead of spinning. “Get a new IP” still works whenever you want.

    Under the hood

    • probe: HTTPS request to opencode.ai through 127.0.0.1:41987 (fresh socket, no environment proxy) every 120 s, 30 s after a failure and on Refresh. 407/502/503/504 and transport errors fail; any other status proves the path works. Exposed as probe in get_state().
    • Wiring check reads service.json and the PATH shim; the connect_opencode action re-wires both.
    • Heartbeats: keeper every 45 s (keeper/heartbeat.txt), guard every 10 s (guard/heartbeat.txt). Stale over 240 s becomes a warn or bad issue with restart_workers; missing files from older workers are ignored.
    • Rotation loop: a same /64 result is not a hop and sends no continue; a wall under 180 s after a hop counts once as a failed attempt; two failures pause automatic rotation for 10 minutes while the log offset keeps advancing.
  11. Website

    The weekly counter left the landing

    In plain words

    • There is no public number on the front page any more. It counted devices, not people, and it did not deserve the space.

    Under the hood

    • Removed from the templates, i18n and CSS; /stats.js now returns 404. The tally moved to /stats.txt: plain text, no-store, noindex, not linked and disallowed in robots.txt.
    • Still only app update checks (User-Agent: openhop/<version>), one HMAC row per network and UTC day, IPv4 as-is and IPv6 /64, daily key, rows deleted after 14 days. There is no decrement path.
  12. v3.1.1

    The limit card disappears, updates arrive by themselves

    In plain words

    • When OpenCode puts the “free limit reached” card where you type, openhop removes it. Your drafts and chats are not touched.
    • The app updates itself: it checks openhop.cfd every few hours, downloads the new version, verifies it and swaps it in. You can turn the check off in the openhop app settings.

    Under the hood

    • Free-limit card: CSS/JS patch inside Desktop's out/renderer/assets/route-*.js, applied to a copy of app.asar with a full backup, an updated integrity entry and a read-back check. It refuses while Desktop runs, when the asar fuse is on, or when the marker is missing. Restore is byte-identical.
    • src/updater.py: reads /latest.json (version, url, sha256, size), downloads to a temp file, verifies SHA-256, swaps the exe and keeps the .old copy; --update-check for scripts; auto_update setting.
    • The keeper applies the Desktop patch within about 2 minutes of Desktop closing and re-applies it after an OpenCode update.
    • update.log only records downloads, installs and errors; a normal “nothing new” check writes nothing.
  13. Website

    A new landing

    In plain words

    • Redesigned front page: the same story, easier to follow, with real screenshots and a download you can check.
    • The moving background only loads on devices that can handle it; on a slow PC or phone you get the same page without it.

    Under the hood

    • New layout; self-hosted React Bits effects behind a capability check (reduced motion, save-data, 4 GB or less, 4 cores or less, no WebGL), English and Spanish, strict CSP.
    • Screenshots are rendered from the app at build time, so the site never shows a mock-up.
  14. v3.1.0

    The bugs you reported

    In plain words

    • Fixed: after a hop, OpenCode could still go out with your real address, so the limit never moved. Now it stops and asks you to repair WARP instead of using your own IP.
    • Fixed: “Checking IP” stuck forever on PCs whose WARP exit is IPv4.
    • Fixed: “Launch OpenCode Desktop” flashed a black command window first.
    • Fixed: the tray menu closed the moment it opened.
    • The panel now warns when the limit keeps coming back after a hop.

    Under the hood

    • zen_proxy._open_warp_direct: 3 tries of 10 s against WARP's SOCKS on :40000; OpenCode hosts now fail closed (ConnectionRefusedError) instead of falling back to the direct address. Other hosts keep the fallback.
    • get_egress_v6: several probes (Cloudflare trace, 1111 trace, ipify, 1.1.1.1), IPv4 accepted and passed through normalize_v6_64; egress_failed retried every 25 s and shown as “Couldn't check”.
    • _is_desktop_exe() looks for resources/app.asar beside the exe, so launching Desktop no longer picks the CLI.
    • Tray: private ctypes.WinDLL(“user32”) per module (argtypes were being shared), focus-loss dismiss via GetAsyncKeyState, DWM rounded corners and opaque #1f2125 notice windows.
    • Health: _recent_wall_times() raises a warning after 3 walls more than 90 s after the last hop with the latest under 5 min; error groups no longer merge across gaps over 10 min; blockLabel() stops doubling the ::/64 suffix.
  15. v3.0.0

    It has a name now: openhop

    In plain words

    • New name, new look: openhop, with its own icon in the tray, on the taskbar and in notifications.
    • Your old install moves over by itself: settings, counters and the blacklist stay, and the old folder is kept as a backup.
    • App-only mode by default: only OpenCode goes through WARP; the rest of your PC stays on your normal connection.
    • With several chats open, every chat that hits the limit gets its “continue”, not just the one in front.
    • Close the window and openhop keeps working from the tray.

    Under the hood

    • Renamed across ouc_common: APP_NAME, VERSION, BRAND, mutexes, scheduled tasks openhop-Keeper/Guard, firewall prefix OPENHOP_LEAKGUARD_ and the openhop, openhop-hop and openhop-doctor shims.
    • ouc_migrate.py runs from AvatarControlApi.__init__: stops the old tasks, copies state without overwriting, skips scripts, bin and webview_cache, renames the old folder to .old and writes a marker.
    • WARP isolated scope only connects over MASQUE, so apply_warp_mode('isolated') forces MASQUE; full TUN keeps WireGuard.
    • The guard keeps a per-session pending set and last_ok_hop; auto-resume now uses opencode run --session <id> continue, which talks to the same background service Desktop uses, instead of typing into windows.
    • Tray and notifications: WS_EX_NOACTIVATE | WS_EX_TOOLWINDOW, never stealing focus; AUMID bernatlol.openhop.controller so Windows shows “openhop”.
    • desktop_brand.py draws openhop.cfd on Desktop's start screen: CSS only, verified copy of app.asar and a byte-identical restore.
  16. Website

    openhop.cfd goes live

    In plain words

    • The site is up: a Windows download with its SHA-256, a source browser and the FAQ, in English and Spanish.

    Under the hood

    • Cloudflare Worker with static assets on the custom domain, a second Worker redirecting www, strict security headers and a CSP with no third-party scripts.
    • Downloads stream in 24 MiB chunks (Workers assets cap is 25 MiB) with Range, HEAD and 304 support. The source browser is generated from git archive HEAD of the app repo and highlighted at build time.

This list starts at the first openhop release. Before that, openhop is a fork of Opencode Unlimited (MIT) by Avatar (ShadowySphinX). The app updates itself, so these changes arrive without you doing anything.