Velork Alpha 0.1.3

A big step forward for Inspiration capture, design import fidelity, and chat tooling — plus a cleaner prompt system and several reliability fixes from real alpha usage.


What's in this release

Inspiration capture and design canvas

  • Capture Inspiration from the design toolbar: paste a website URL or pick a running desktop app window; progress phases show while DOM, assets, and the design file are built
  • After capture, the app can name layers semantically using your selected chat model before import
  • Captured assets hydrate locally (images/fonts from CDP network cache) so imported brands load reliably offline
  • Font pipeline overhaul: WOFF/WOFF2/OTF normalize to TTF, track weight/style/subset per @font-face, and prefer captured bytes over re-fetching
  • Import fidelity fixes: pseudo-elements (::before, ::after, ::marker), mask-image icons (including Framer SVG data URLs), line-clamp/text-overflow, aria-hidden, and skipping Framer raster text duplicates
  • Stroke-only pseudo borders no longer render as solid gray overlays on cards
  • Export selected layers from the toolbar as PNG, JPG, or SVG
  • Design canvas pan on macOS restored to natural trackpad direction after a wheel-handling regression
  • Canvas blank after tab switch fixed; AVIF captures transcoded correctly when reloading saved brands

Design read tools

  • get_structure defaults to depth 6, returns topLevelSections, frameIndex, childIds, and navigation hints to reduce redundant calls
  • Inspiration mode agents can use live canvas read tools (get_pages, get_structure, get_node) — not just the capture tool
  • Brand context guidance now points agents at the live canvas instead of grepping ~/.velork/brands/**/*.design.json on disk

Chat, tools, and prompts

  • New read_terminal tool (Develop mode): list terminals and page through scrollback without re-running commands
  • eslint_check hybrid mode backfills TS/JS diagnostics via the TypeScript server when editor markers are empty; supports JSON/JSONC and info-level issues
  • System prompts refactored into modular mode/provider sections (Plan, Develop, Debug, Design, Inspiration) with Cursor-specific overlays
  • Grep / glob / list tuned for higher caps and smarter include-pattern normalization
  • Per-session model and mode preferences persist per chat, not just globally
  • Cursor provider: more accurate context-usage meter, synthetic streaming for native file-mutation tools, MCP timeout/progress keepalive for long calls

Chat UI

  • Composer visible immediately on first paint
  • Inspiration capture segment shows live phase status (spinner/checkmark)
  • Redesigned lint check segment with loading state and expandable results
  • Action tags bar: Tab/Enter navigation plus ⌘1–9 (Mac) / Ctrl+1–9 (Windows/Linux) shortcuts
  • Model picker shows Loading models… during bootstrap without clobbering your saved choice
  • Duplicate workspace folders collapsed in pickers (case/path insensitive)
  • Streaming segments auto-scroll while content arrives; multiple edits to the same file show as separate rows

AI tool permissions

  • Ask first (default): every shell command shows a confirmation card unless you add an allow shortcut
  • Auto-run: run commands automatically, with safety patterns (e.g. rm *, destructive git) still prompting and a block list still enforced
  • Permission cards: clearer remember choices — Ask before every command, Auto-run commands (except safety & block lists), or Always allow a specific command (label shows the command)
  • Choosing auto-run on a card updates workspace settings (velork.bash.policy: allowAll) instead of bypassing safety lists
  • Read tools use the same permission card flow as shell and edits
  • Session trust for this chat toggle; remembered rules visible per workspace/session in settings
  • Fixed duplicate permission cards for one bash call; fixed rm * on allow list when it also matched the safety list

Velork Settings (permissions)

  • Redesigned Permissions section: shell default is Ask before running or Auto-run commands, with plain-language lists
  • Always confirm before running (safety), Never run (block), and Run without asking (shortcuts, ask-first only)
  • Per-category defaults (read, edit, MCP, fetch, …), path allow/deny rules, and Manage permissions from chat
  • Open Velork Settings action; autonomous-mode strict permissions row; usage/activity views where configured

Stability

  • Website capture no longer hangs waiting on Network.enable on some sites
  • Font fetch rejects HTTP error pages instead of saving them as font files
  • Headless TS diagnostics work for files not open in an editor
  • Titlebar no longer double-initializes the design sidebar

macOS install help

Alpha Mac builds are not Apple-notarized yet. If macOS says Velork Alpha is "damaged" or won't open, the app is usually fine. Gatekeeper is just being strict.

  1. Double-click the .zip file to unzip it. You should see Velork Alpha.app (not Velork.app).
  2. Drag Velork Alpha.app into your Applications folder before running any Terminal commands.
  3. First launch: open Applications, right-click Velork Alpha, choose Open, then click Open again.
  4. Still blocked? Open Terminal and run:
xattr -cr "/Applications/Velork Alpha.app"

If you get "No such file", the app is still in Downloads. Either move it to Applications first, or run:

xattr -cr ~/Downloads/Velork Alpha.app

(Adjust the path if your browser saved the zip somewhere else.)

We will ship signed/notarized builds later. For now this is expected on alpha.


May 2026. The Velork team.