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.
-
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.exeis 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()getsfailed_hops/last_ok_hopfrom the guard state. Status isbusywhile 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.huntingtells 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.
-
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_MAX8 → 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;faulthandlerwrites hard crashes tologs/crash.log; any unexpected exception inmain()is logged and shown instead of exiting silently.
-
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 withNoRealIpError.--noproxyis now used only on the direct path.- New
bump_egress_epoch()(lane/egress_epoch): called after every successful hop (WARP, Tor, custom, manual).zen_proxypolls it every second and closes OpenCode tunnels opened before it. - Guard:
FAILED_HOPS_MAX2 → 8; a re-wall withinREWALL_SECONDSrotates 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 afterNEWNYM; burnt exits are retried up to 4 times, 10 s apart.
-
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/tracethrough the WARP SOCKS port;get_egress_v6()only accepts an IP whenwarp=on|plus. The result goes tolane/warp_leak.json, read bywarp_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.pybuilds and redacts the report on the PC;POST openhop.cfd/api/reportis rate-limited by theReportGuardDurable Object, forwarded to Discord from a Worker secret and saved in theReportStoreDurable Object (90 days, 500 MB max; private/api/reportsbehind a token). Each report gets an ID. - Opening the window runs a throttled update check (
_on_window_opened()); notification card clicks go tobody_action(show_update→window.focusUpdate()). Launching a second copy no longer swaps the exe under a running one.
-
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()writesupdate/just_updated.json(from,to,sha256,at) beforePopen. The new process consumes it withtake_just_updated(): one-shot, 15 min TTL, only whento == VERSION.- New
run_post_update_checks()builds{ok, passed, total, checks[]}and saves it toupdate/last_check.json;updater.state()exposes it aspost._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_FILEvs_bundle_fingerprint()), and nobadhealth issues. The notification honorsnotify_updates. - UI:
#updateBarnow has two modes (update waiting / just updated), a toast once per session, and a per-report Hide inlocalStorage. The tray action label is Update. Nothing is written outside%LOCALAPPDATA%\openhop\update.
-
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_SECONDS600 → 120. It still pauses afterFAILED_HOPS_MAX = 2walls that come back insideREWALL_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 inpending, it hops once and lets_rotate()dispatch auto-resume, instead of waiting for the next wall line. It clearsfailed_hops,hop_countedandbackoff_loggedfirst, 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: thedrafts.sqliteunlock still runs before every auto-resume, and the source browser only sees this app repo.
-
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,--dimthumb,--amberon hover,--amber-hiwhile dragging) plus a Firefox-only@supports (-moz-appearance: none)gate forscrollbar-width: thin/scrollbar-color. The gate matters: Chromium 121+ drops the::-webkit-*rules once the standard properties are set. - No radius, images, JavaScript or
overflowchanges. The track is transparent, so it blends with--bgand.sec-dark; checked light, dark, horizontal code tables and the source tree.
-
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 insite.js. - Without JavaScript both lists show, each with its own label, and the switch is hidden. No content depends on a script.
-
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 oversession_v2(file:…?mode=ro,PRAGMA query_only=ON) summing input, output, reasoning, cache read, cache write and cost, withCOUNT(DISTINCT project_id)andtime_updatedin ms turned into seconds.AvatarControlApi.get_token_stats()caches the result for 60 s and is deliberately not part ofget_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: falseand the card stays hidden. The advanced grid gets atokensarea;tools/preview_ui.pymocks the API for screenshots.
-
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 through127.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 asprobeinget_state().- Wiring check reads
service.jsonand the PATH shim; theconnect_opencodeaction 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 withrestart_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.
-
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.jsnow returns 404. The tally moved to/stats.txt: plain text,no-store,noindex, not linked and disallowed inrobots.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.
-
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 ofapp.asarwith 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.oldcopy;--update-checkfor scripts;auto_updatesetting.- The keeper applies the Desktop patch within about 2 minutes of Desktop closing and re-applies it after an OpenCode update.
update.logonly records downloads, installs and errors; a normal “nothing new” check writes nothing.
-
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.
-
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 throughnormalize_v6_64;egress_failedretried every 25 s and shown as “Couldn't check”._is_desktop_exe()looks forresources/app.asarbeside the exe, so launching Desktop no longer picks the CLI.- Tray: private
ctypes.WinDLL(“user32”)per module (argtypes were being shared), focus-loss dismiss viaGetAsyncKeyState, DWM rounded corners and opaque#1f2125notice 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::/64suffix.
-
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 tasksopenhop-Keeper/Guard, firewall prefixOPENHOP_LEAKGUARD_and theopenhop,openhop-hopandopenhop-doctorshims. ouc_migrate.pyruns fromAvatarControlApi.__init__: stops the old tasks, copies state without overwriting, skipsscripts,binandwebview_cache, renames the old folder to.oldand writes a marker.- WARP
isolatedscope only connects over MASQUE, soapply_warp_mode('isolated')forces MASQUE; full TUN keeps WireGuard. - The guard keeps a per-session
pendingset andlast_ok_hop; auto-resume now usesopencode 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; AUMIDbernatlol.openhop.controllerso Windows shows “openhop”. desktop_brand.pydraws openhop.cfd on Desktop's start screen: CSS only, verified copy ofapp.asarand a byte-identical restore.
-
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 HEADof 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.