Skip to content
Shelzo

Code mode

Keep terminals, files, and a browser beside each other in your project folder. A card holds one pane or a group of tabs.

Arrange your workspace

  1. Open a folder and select Code (⌘2). Start an engine terminal or a plain shell with New Terminal (⇧⌘T).
  2. Use ⌘T to repeat the last engine pane. Until you have created one, it opens a plain terminal. Use ⌥⌘T to add a tab to the focused card.
  3. Drag a card header onto another header to group them as tabs, or onto the body to reorder cards. Cycle the focused card’s tabs with ⌃⇥ and ⌃⇧⇥.
  4. Choose a grid, columns, rows, or focus layout. Move between cards with Control-Option and an arrow key. Double-click a header or press ⌘Return to maximize or restore it.

Files and Browser

Open Files with ⇧⌘F. Expand folders and select a file to preview it. Local Files supports search and Reveal in Finder. Open a Browser pane with ⇧⌘B and enter a URL, for example your local development server’s address.

Worktrees and Changes

  1. For an isolated branch, choose a worktree when creating the session. An empty chat also offers Shared checkout / Own worktree; its first message creates the worktree.
  2. Review edited files in Changes. Use unified or split diffs and move between hunks to inspect each change.
  3. When ready, use Finish worktree to review the available commit, merge, pull-request, or discard actions. Resolve any reported Git problem before trying again.
  4. For delegated work, Shelzo verifies the result and a different engine reviews it. You decide whether to merge; Shelzo never auto-merges.

A worktree is a separate checkout of the same Git repository. For example, two engines can work on different branches without sharing the same working files.

If it fails

Worktrees need a Git repository. Check the selected folder and the error shown by Finish worktree. If a terminal engine exits, use Restart engine. For remote Files and Changes availability, read SSH; remote worktree finishing and delegation remain unavailable.