Editor & Tabs

Tab Management#

Agentastic uses a familiar tab-based interface for managing open files.

Opening Files#

• Click a file in the Navigator to open it
• Double-click to open in a permanent tab (single-click creates a preview tab)
• Press Cmd+P for Quick Open

Tab Navigation#

Tab Sizing#

Tabs share the width of their pane's tab bar: a single tab spans the whole bar, two tabs split it in half, three take a third each, and so on. Once tabs would get narrower than their minimum width, they keep that width and the tab bar scrolls instead; a fade at either end shows there are more tabs that way, and selecting a tab scrolls it into view. The + button stays at the end of the tab bar however many tabs are open.

Agent Shortcuts in the + Menu#

The tab bar's + menu includes installed, enabled agents by default. Selecting an agent opens a session using its default interface and launch settings.

To hide a shortcut, choose Agent Settings… from the menu, configure the agent, and turn off Enable in Tabs Shortcut (+) Menu. Your OFF choice is remembered, including after uninstalling and reinstalling the agent.

Uninstalled agents stay out of the menu and show the shortcut toggle as OFF. Installing an agent makes its shortcut available automatically unless you previously turned it off.

Split Views#

Split your editor to view multiple files side by side.

Creating Splits#

The split shortcuts work from files, terminals, browsers, and agent chat interfaces. A terminal split starts a new terminal with the same shell and working directory. You can also:

• Drag any tab to an edge of a pane — files, terminals, chats, browsers, diffs, pull requests, tmux sessions, and panels like Kanban, Usage, and Scheduled Tasks all split the same way
• Right-click any tab and choose Split Up, Split Down, Split Left, or Split Right to move that tab into a new pane

Navigating Splits#

Move focus between editor panes using keyboard navigation or by clicking in the desired pane.

Pane Style#

Choose how panes are drawn in Settings > General > Pane Style:

• Classic tiles panes edge to edge, separated by thin dividers.
• Modern (the default) draws each pane as a rounded card with space around it. Each pane's tab bar becomes the card's header, and its split, focus, and close buttons sit at the header's trailing edge. Drag the space between two cards to resize them. The utility area and Agent Home appear as cards too. The background around the cards runs on under the toolbar as one solid surface; in full screen, the top cards start right where the toolbar ends.

Switching styles keeps your splits, their sizes, and running terminals as they are.

Editor History#

Navigate through your editing history:

Jump Bar#

The Jump Bar appears at the top of the editor showing the file path and code structure. Click any segment to navigate.

Toggle the Jump Bar in Settings > General > Show Jump Bar.

Line Operations#

Working with a Selection#

Select code in a file and a small bar appears under it: Add to Chat ⌘L and Quick Edit ⌘K. The shortcuts act on the selection only while code is selected in the focused editor; otherwise Cmd+L and Cmd+K keep their usual meaning.

Quick Edit#

Cmd+K opens a prompt at the selection. Say what to change and press Return: the selection is rewritten using your Fast Model from Settings → Tasks, and the result appears in place as a diff, with the original lines in red and the new lines in green.

To refine a rewrite, type a follow-up in the panel instead; the selection is rewritten again with your follow-up added. While a rewrite is shown, the file can be scrolled, copied, and saved, but not edited.

To hand the request to an agent instead of editing in place, choose Ask agent in the prompt. It goes to the agent you pick, otherwise the worktree's agent, otherwise the agent selected in the Agent Chat sidebar; agents waiting on a question or an approval are skipped. If no agent can take it, the request is staged in the sidebar composer.

Add to Chat#

Cmd+L pins the selection as a chip in the agent's composer, labeled with its file and lines. Type your question and send: the agent receives the code, its path and line numbers, and your message. Pins work in new chat drafts, Chat sessions, and terminals in Chat mode, and they stay put if you switch the agent between Terminal and Chat. A terminal in Terminal mode gets a path:lines reference typed at its prompt instead, without pressing Return.

Markdown Documents#

Markdown files get a dedicated block editor — Notion-style editing over plain GFM, inline Mermaid diagrams, image and video pasting, and comments you can send straight to an agent.

Cycle Source → Document → Split with Shift+Cmd+V. See Markdown Documents for the full guide.