All releasesVelork logo

Velork Alpha 0.1.4

This release introduces the Tasks view, a new way to plan, queue, and run agent work from a dedicated board instead of only from chat. You also get autonomous task execution with sub-tasks, background shell tracking, git worktrees for isolated agent runs, and a round of chat and MCP reliability improvements.

What's in this release

Tasks view: a new development workflow

Switch to Tasks from the title bar (or Switch to Tasks View in the command palette). The board replaces the old "chat-only" loop for multi-step work: create tasks with rich descriptions, attach images, pick a workspace and model, then let Velork run them one at a time or in sequence.

Tasks view overview
  • Kanban-style board with Backlog, In Progress, In Review, and Done columns. Filter by workspace, agent status, or priority
  • Per-task chat sessions linked automatically; titles and models stay in sync as you edit the task
  • Sub-tasks break large goals into ordered steps executed in the same session
  • Autonomous runner queues idle tasks, runs parent work then sub-tasks, and recovers interrupted runs after restart
  • Live agent status: progress updates, file-change counters, and summaries while work is in flight
Task detail with sub-tasks and agent progress
Task activity log with live agent progress updates

Background shells and terminals

  • Background shell panel lists deferred shells (dev servers, long builds) with live status cards in chat
  • Agents auto-resume when a background shell exits instead of polling logs
  • Unified Velork terminal paths under ~/.velork/projects/<workspace>/terminals/. Tools like shell, await, kill_shell, list_shells, and write_shell all use the same session registry
  • Tool segments consistently mark incomplete and failed tool calls across providers

Git worktrees for agent isolation

  • Optional git worktree per agent session or task. Agents work in an isolated branch/worktree without touching your main checkout
  • Worktrees are registered, reused, and cleaned up when sessions end

Chat, MCP, and providers

  • External MCP servers register correctly when using Cursor as a provider; improved MCP tool UI and timeout handling (60s keepalive for long calls)
  • Cursor bridge maps native Cursor tool calls to Velork segments and handles early tool results without duplicate cards
  • Velork app version decoupled from VS Code engine compatibility for clearer update semantics

Design and inspiration

  • Figma clipboard paste and scoped DOM capture reliability improvements
  • Extension paste assets persist locally under the page bundle
  • WOFF2 font assets emit correctly in release builds

Permissions (from 0.1.3 follow-up)

  • Ask first / auto-run shell permissions with redesigned Velork Settings permissions UI
  • Safety and block lists still apply in auto-run mode; read tools use the same permission card flow

Stability

  • Inspiration capture and chat reliability fixes from continued alpha usage
  • Redesigned Velork Settings stylesheet

0.1.4 refresh (June 12, 2026)

  • Shell permission menu on terminal cards: open the header menu to change Auto-Run policy, manage allowlist rules, always-allow the current command, or copy the command text
  • Terminal status lines now match the thinking segment style (Finished, Stopped, and related lifecycle labels)
  • Archived shell cards no longer keep polling or updating after a run completes
  • Foreground shell output is read directly from the session instead of re-reading log files
  • Task board git workflow: branch/remote/sync prompts, conflict handling, SCM commands, push recovery, failure classification, and automation retry policy
  • Alpha updates: clearer version comparison (skip same commit, block downgrades), portable update support, and platform-specific update reliability improvements
  • Dialogs: refreshed layout and styling for native confirmation dialogs

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.

June 2026. The Velork team.