2026-08-11 · NextClaw v0.31.0

Published: 2026-08-11 Tags: release npm minor

NextClaw v0.31.0 turns the session workspace from a place that opens one file into a continuous project surface. The directory tree can stay beside the file preview, common file operations no longer interrupt the task, and message recovery, journal scanning, and startup editing are more resilient.

Features

• Shared project Explorer: Keep the directory tree and file preview visible together. Files opened in sequence get their own tabs.
• Complete project file actions: Create files and folders, upload several files, download, rename, delete, copy paths, or add a file or folder to the conversation.
• Resizable, remembered sidebar: Drag the divider to resize the Explorer and keep that width after a refresh. The overlay is reserved for genuinely narrow layouts.
• Parallel read-only tools: Native sessions can run read-only file, image, web, and memory queries from the same turn concurrently. Writes, commands, and tools without an explicit safety declaration remain exclusive, and results keep their original call order.

Enhancements

• The project-root background and folders expose familiar editor-style context menus. Folders no longer show an ambiguous Open action.
• New items scroll into view for inline naming, while breadcrumbs remain on one line and preserve the current file when space is tight.
• Selection controls in files and messages appear reliably after selection without conflicting with sidebar resizing.

Fixes

• Idle Web Chat SSE connections send keepalives. Short interruptions can recover the session and reconnect, while persistent failures still surface clearly.
• Startup recovery scans journals one session and one line at a time, reducing peak memory and OOM risk for large histories.
• Message editing and continuation pause while NCP is unavailable and recover automatically once the service is ready.

Defaults and compatibility

• Create, upload, rename, and delete operations remain inside the current project root. Uploads do not overwrite by default, and deletion always asks for confirmation.
• Existing file previews and Add to chat actions continue to work without workspace migration.
• The unreliable in-agent gateway.restart action has been removed. Run top-level nextclaw restart from an external terminal when a restart is required; nextclaw gateway only starts a foreground gateway.

Learn more: Session workspace · Tasks and sessions