GeckoGrid changelog.

More room on smaller screens: an interface size setting and a scan panel that folds away.

• ✓Interface size in Settings > Application, from 80% to 125%. Text, controls, and the map scale together, and the setting is saved per computer. Ctrl or Cmd with + and - changes it from anywhere, and Ctrl or Cmd 0 resets it.
• ✓The scan page's side panel, with Top Competitors and the live scan card, collapses to a thin strip so the map can use the full width. GeckoGrid remembers your choice.
• ✓Fixed thin horizontal lines that could appear across the map on macOS at some zoom levels.

Simpler upgrades: see what Agency adds, change plans from inside the app, and a GeckoGrid-only customer portal.

• ✓Solo plans get an Agency Features page in Settings, showing what Agency adds: your branding on client deliverables, DataForSEO API scans, and 10 machines. Upgrade and Manage subscription buttons open the customer portal.
• ✓GeckoGrid licenses now come from GeckoGrid's own store, so the customer portal lists only GeckoGrid plans. Keys bought before the change keep working.
• ✓Changing plans issues a new license key. The license screen now says where to find it: in the Polar email and the customer portal.
• ✓Lifetime has its own checkout, so buying it never starts a second subscription.
• ✓Fixed the Application settings layout and a cut-off option in the date and time format menus.

A faster path from new project to finished scan: import from Google Maps, an organised export folder, regional formats, scan notifications, and missed-schedule handling.

• ✓Import from Google Maps: paste a business's Maps link into the project form to fill in its name, location, and address. Keywords are entered as chips, and a grid preview map shows the exact points a scan will visit and the area they cover.
• ✓Exports save to a GeckoGrid Scans folder you can move anywhere, organised by project and keyword and named for the scan's own date. The scan date now appears on the map and in exported images.
• ✓Regional formats in Settings: date format, 12 or 24-hour time, meters or miles, and first day of the week, applied across the app.
• ✓A desktop notification when queued scans finish, an option to start GeckoGrid when you sign in, and a window that remembers its size and position.
• ✓Missed scheduled scans: choose to be asked, to catch up when the app opens, or to skip. Each schedule catches up at most once, and automatic catch-ups stay within 30 local scans a day.
• ✓Project cards show average rank with its change, the last scan, and the next scheduled run, with sorting, search over keywords and address, and Duplicate.
• ✓On a scan, step to the older or newer scan of the same keyword, switch keyword, see every competitor, and open a listed business in Google Maps or view its grid. The live scan view has progress, a time estimate, and Cancel.
• ✓The Schedules page can create a schedule and run one on demand, Logs can copy and export entries, deleting a scan or schedule offers Undo, and there are keyboard shortcuts for search and new projects.
• ✓Fixes: a project can no longer be saved without a location, the grid spacing field can be cleared while typing, and exported images are named for the day of the scan.

A redesigned project page: scan history you can read at a glance, honest rank changes, and scan controls up front.

• ✓Scan History has three views: Keywords (one row per keyword with map rank, change, found %, top 3 %, a trend line, and last scanned), Timeline (keywords by scan date, colored by rank), and Runs (scans grouped by day with each keyword's change and the run's cost).
• ✓One rank definition across the page: the map's average rank, where points the business was not found at count as 20. Changes only compare scans on the same grid and source, and a resized grid is flagged instead of shown as a change.
• ✓Filter by 30 days, 90 days, or all time and by Local or API scans, sort keywords by worst, best, biggest drop, biggest gain, or least recently scanned, and the page remembers your view for each project.
• ✓Scan all keywords, Scan one keyword, and your schedules (with their next run) sit in an action bar above the history, which now uses the full page width.
• ✓Never-scanned keywords show a Scan now button, failed and cancelled scans gather into one notice you can review or clear, and selected scans export to one CSV or delete together.
• ✓Scans started by a schedule or an AI agent are labelled as such in the history.

Grid sizes that match the grid shape, so hexagon and circle scans show their real point count and cost.

• ✓Hexagon and circle grids are labelled by shape and point count, for example "Hexagon 5 (19 points)", instead of a square "5x5" they never were.
• ✓The DataForSEO cost estimate, project cards, project header, Settings defaults, and new reports all use the shape-aware labels and the real point count.
• ✓Square grids read exactly as before, and reports built earlier keep their original wording.

A guided first run, a redesigned Settings page, report contact fields back in the app, and a trial countdown.

• ✓A Getting started checklist on the Projects page walks new users through their first project, scan, and heatmap, with a one-click agent setup prompt.
• ✓Settings now shows one section at a time from a left-hand menu: Scanning, Results, DataForSEO, White Label, Application, License, and a new Help section.
• ✓Agency and Lifetime users can set the report footer contact name, phone, and website in Settings > White Label again.
• ✓Solo and Agency trials show a "Trial: N days left" chip in the sidebar, linked to the trials and billing guide.
• ✓The Schedules page gained a search bar that filters by project name or keyword.

Reports that fill their own gaps, honest handling of blocked collection, and sharper prospect fix plans.

• ✓Agents can now fill values the collectors could not measure, with provenance recorded, and attach their own screenshots and grid images.
• ✓Websites that serve a block or challenge page are reported as blocked with a reason instead of being silently scored.
• ✓Prospect reports gained a "What we would fix first" fix-plan section and honest partial-review labels.
• ✓Report render options for full or leave-behind output, including a print-friendly light theme.
• ✓Maps-link geocoding: geocode_address accepts Google Maps links and resolves the place name and coordinates directly.

Reports built by your AI agent, Clients and Prospects project types, and a daily local-scan advisory counter.

• ✓Client reports: your agent pulls keyword history and period summaries over MCP and assembles reports in your branding, exported to HTML or PDF, with white-label branding on Agency and Lifetime.
• ✓Prospect reports: a sales audit of any business a scan observed, scored out of 100, with email, DM, and walk-in outreach variants, a leave-behind mode, and a QR contact page.
• ✓Projects are now Clients or Prospects, with tabs on the Projects page, a badge on prospect cards, and a Type field in the project form.
• ✓A daily local-scan counter in the sidebar shows green, yellow, and red advisory warnings; local scans are never refused and the monthly DataForSEO spend cap remains the hard limit.
• ✓Heatmap image exports render offscreen, with zoom options and the ability to render a competitor's grid.

Per-schedule scan settings, heatmap image exports through MCP, and a masked license key.

• ✓Each schedule can override the scan type with Local or API scanning, and API schedules can pick their own delivery mode.
• ✓New export_scan_image MCP tool renders a completed scan's heatmap and saves a timestamped PNG.
• ✓The license key on the Settings page is masked by default with a reveal toggle.
• ✓Fixed MCP export paths on Windows so export_csv works with Downloads, Desktop, and Documents folders.

API-powered scanning, competitor intelligence, and a rebuilt Project Home dashboard, built for agencies that outgrew local-only scans.

• ✓Added DataForSEO API scanning with Standard, Priority, and Live speeds, whole grids in as little as ten seconds using your own pay-as-you-go key.
• ✓Added Competitor Intelligence with per-keyword leaderboards, rank trends, and competitor-versus-you map views.
• ✓Rebuilt Project Home as a full dashboard with stats, keyword-grouped history with trends and deltas, and schedules.
• ✓Introduced Solo, Agency, and Lifetime license tiers with per-plan machine limits, plus OS-keychain storage to keep API credentials secure.
• ✓Grew the local MCP server to 28 tools for compatible AI agents.
• ✓Added a scan retention setting and smarter history management to keep long-running projects tidy automatically.
• ✓Added per-route error recovery so one failed request no longer takes down a running scan.

A clearer GeckoGrid presence in the system tray across Windows and macOS.

• ✓Introduced the full-color GeckoGrid tray icon across supported platforms.
• ✓Removed tray-icon theme switching for a more consistent appearance.
• ✓Updated macOS tray behavior so the icon is no longer treated as a monochrome mask.

Faster movement between scan results inside a project.

• ✓Stopped the map from reloading when switching between completed scans.
• ✓Made historical scan changes feel immediate while preserving the current map view.

Local AI-agent integration through a protected MCP server and seven analyst skills.

• ✓Added a localhost Streamable HTTP MCP server with 25 GeckoGrid tools.
• ✓Added a generated setup prompt for connecting compatible AI agents.
• ✓Bundled rank diagnostics, competitor analysis, trend analysis, keyword research, GBP audit, website audit, and schedule-planning skills.
• ✓Added persistent MCP logging, port health checks, and clearer startup failure states.
• ✓Redesigned the AI & MCP screen for setup, token management, and offline skill downloads.

Stability work for long-running scans.

• ✓Reduced memory pressure during repeated and larger scan workflows.
• ✓Improved cleanup after browser-driven search work completes.

More predictable memory use during active projects.

• ✓Continued scanner memory optimizations and lifecycle cleanup.

Deeper competitor context and new ways to shape a market grid.

• ✓Added ratings and review counts to rank-detail results.
• ✓Added circle and hexagon grids alongside square grids.
• ✓Added the option to ignore sponsored map results.

Automation and project throughput moved to the center of the app.

• ✓Added dynamic grid configuration and a one-at-a-time scan queue.
• ✓Added scheduled recurring scans and background exports.
• ✓Expanded the project workflow for repeat client reporting.

The first public GeckoGrid foundation.

• ✓Launched local Google Maps grid scanning and keyword projects.
• ✓Added PNG heatmap exports and the original desktop project workflow.