← Home  ·  English  ·  한국어

AgentDeckTabby plugin · 1.3.2

A tool for running several agent CLIs (Claude Code · Codex · Gemini) in one terminal and seeing, at a glance, which session is doing what and which one is waiting for you. From installation to tab editing, scheduled work, messaging and settings. Some screenshots show earlier versions; follow the current instructions in the text.

Install and get started

  1. In Tabby, open Settings → Plugins, find agentdeck, install it and restart Tabby.
  2. Set your work root in Settings → AgentDeck. Add named work root profiles to choose between projects when opening a tab.
  3. Use + New tab or Ctrl+T. A single work root opens immediately; multiple roots show a chooser. Run your agent CLI in the terminal.
  4. Install the status hook for the agent you use for more accurate status and session linking. For messaging, also follow the connection instructions.

Verified on Windows. When an update is offered, choose whether to install it. Read the complete change history before updating.

01At a glance

The screen is in two parts. The terminal on one side, the session list (sidebar) on the other. Tabby's own tab bar is hidden and this sidebar manages tabs instead — once you have several tabs open, a horizontal tab bar has no room to say what each one is working on.

The session list - four sessions grouped by working folder, each row showing title, task name, status and elapsed time
Four sessions, grouped by working folder. Each row carries title · task name · status · elapsed time, and ⏸1 ●1 ✔1 ○1 at the right of a header is the per-status count.
The terminal width is derived from the window height at a fixed 4:3 ratio. However wide you make the window, the terminal does not stretch sideways, so the boxes and line wrapping a TUI draws stay put. The leftover width goes to the sidebar, and whatever is still left is absorbed by the terminal.

02Session status

Each session reports one of six states.

BadgeMeaningWhen
● runningthe agent is workingoutput keeps coming
⏸ waitingit is waiting for youasking permission to use a tool
⛔ rate limitedusage limit hitshown with the reset time
✔ donethe turn finishedanswered and stopped
✘ errorit failedan error message appeared
○ idlenothing is happeningno output for a while

A waiting badge says what it is waiting for. The second row in the screenshot above reads ⏸ waiting · Claude needs your permission to use Bash. When you come back from doing something else, you know which session stopped and why without clicking into it.

Setting a status by hand

Right-click on a session row - the status menu
This screenshot shows an earlier menu. In the current version, use right-click → Edit, select a status and save. You can also return to automatic detection.
Status is judged from what is printed on screen, with no hook installed. That is why it works for Codex and Gemini too, not just Claude Code. Installing the hook (one click in settings) lets the agent report directly and makes the reading exact — but the tool is built to be usable without it.

03Session groups

Sessions are grouped by working folder (project) — api-server, tools and web-client in the screenshot above. The number next to a header is how many sessions are in that group. Click the header to collapse it.

Two groups collapsed
tools and web-client are collapsed. Collapsed state survives a restart.
Grouping is by the folder the tab was born in — cd in the shell does not move a session to another group. If membership shifted while a session was alive you would keep asking "where did that row just go". When there is only one group the header is not drawn at all, so a single-project setup looks exactly as it did before.

04Search and filter

Type in the search box at the top of the sidebar to narrow by title · task name · working folder at once. Click a status chip (⏸1 ●1 …) to keep only that status.

One session left after searching
Searching left a single matching task. Esc or ✕ clears it.
A collapsed group opens temporarily if it holds a match. Otherwise the search would look like it found nothing. Clearing the search puts the group back the way it was — the collapse setting itself is never touched.

05Keyboard control

Ctrl+L moves focus into the list so you can look through it without the mouse.

KeyWhat it does
↑ ↓move between rows. The active tab does not change
Home Endfirst row / last row
Enterswitch to that session. On a group header, collapse or expand
Escif a search or filter is set, clear that first. Otherwise return to the terminal
Tabgo to the search box
Keyboard focus on the second row while the active tab is a different row
The outline (keyboard focus) is on the second row while the highlighted active tab is a different row — that split is the point of this screenshot.
Focus and selection are deliberately separate. If the tab changed on every row you passed, that tab's output would flood the screen and the terminal width would be re-applied each time, making the display jump. Looking through your sessions would become impossible. So ↑↓ move only the outline, and Enter is the single thing that actually opens a tab.

↑ inside the search box is deliberately not intercepted — in a single-line input that key moves the cursor to the start, and you really do use it when fixing a search term you are typing.

06Aliases, order and tab editing

Titles and aliases are separate. Aliases are assigned from the working project and stay stable while a tab is open. Closing a tab releases its number; new tabs reuse the lowest free number. Set your own alias in the edit dialog.

Drag rows to reorder tabs. Ctrl+1 through 9 selects the first through ninth currently visible tab, not the number in its alias. There is no nine-tab creation limit. Scroll the list to reach later tabs.

Right-click → Edit

  1. Right-click the target sidebar row and choose Edit. Double-clicking its title or task name opens the same dialog.
  2. Change the fields you need. Changes remain a draft until saved.
  3. Choose Save to apply them together, or Cancel / Esc to discard them. Correct duplicate aliases or invalid counts before saving again.
FieldHow to use it
Tab titleA title to identify the tab, up to 160 characters.
AliasA name for the agent, up to 40 characters. It must not duplicate another open tab.
Task nameA description of the current work, up to 500 characters.
StatusChoose a manual display status or automatic detection. This does not start or stop the agent.
Scheduled countDisable automatic counting to enter an integer from 0 to 999999. This does not create or cancel actual tasks.

Titles, aliases and manual scheduled counts survive a reload. Automatic updates arriving during editing are preserved for fields you did not change.

07Output preview

Read the documents, images, tables and code an agent produced right next to the terminal. File paths printed on screen are picked up automatically, so you never have to ask for a file to be opened.

A markdown document rendered in the preview panel
Markdown is rendered with tables, inline code and quotes intact. The chips along the top are recently seen files; the status line at the bottom gives size, time and full path.
WhatHow
Drag and dropDrop a file on the panel and it opens. Drop it on the terminal and you are asked — open in panel / paste the path
Edit and save✎ to edit, Ctrl+S to save. BOM and line endings are restored exactly as they were
FindCtrl+F
New filePut a path that does not exist into + and press Enter twice — it is created and opened for editing
Open it after working with it closedEverything touched so far is waiting as chips and the body shows the most recent file (if you were on Changes, the diff is re-read) — Settings → Preview panel → preload into the panel (on by default)
Make it open by itselfSettings → Preview panel → open the panel automatically (off by default — opening and closing is yours to do). Turn preload off and nothing happens automatically
Each tab remembers its own. Move to another session and the body switches to the file that session was last looking at — so you never mistake another session's document, still sitting open beside you, for the output of the one you are now in.

08Diff view and commit

The Changes tab of the same panel shows git diff for that session's working folder. It does not care who made the change — agent or human, you are looking at the working tree itself.

Changes tab - file list, insertions and deletions, diff with line numbers, commit box
2 files · +192 -16 at the top, then the file list (including six untracked new files), then the diff with line numbers. The commit message box is at the bottom.
WhatHow
StageClick the tag at the left of a file to git add or unstage it
CommitWrite a message and press commit — it takes two presses (the first one asks to confirm)
file:line referenceClick a diff line and that position is typed into the terminal. Shift+click for a range
Clicking a line to insert its position is the most-used thing in this panel. Saying "fix this line" used to mean typing a filename and a line number by hand; that round trip is gone. Commit takes two presses so that it cannot happen by accident.

09Input fixes

While composing text with an IME (Korean, Japanese, Chinese), pressing Home, End or Shift+Enter used to make the syllable still being composed follow the cursor or drop onto the new line. Keys are now held until composition finishes.

KeyWhat it does
Ctrl+Enter · Shift+Enternewline (next line without sending)
Ctrl+Vpaste. If the clipboard holds only an image, it is pasted as an image
Right-clickcopy when there is a selection, paste when there is not. Hold for the menu

10Settings

Sidebar settings button → the AgentDeck section.

AgentDeck settings in English — layout, session recovery and keyboard shortcuts
The English settings screen in version 1.2.8: layout, session recovery and keyboard shortcuts. Most changes apply immediately.

The ones actually worth touching:

EntryDefaultMeaning
keyboard controlonCtrl+L list navigation
wrap around at the endsoff↓ at the bottom jumps to the top
show subagent counton❖3 on the row
auto-scroll while draggingonthe list scrolls at the edges
group by projectonsession groups
tab aliasautomaticStable while open; closed numbers are reused. Change it with right-click → Edit
show elapsed timeon2m at the right of a row
The subagent count (❖3) is how many background agents that session is running. It is counted by matching what was launched against what finished in the transcript, so it is right even when no hook is reporting. Hover the row to see what is running and how long the oldest has been going.

11Key reference

KeyWhat it does
Ctrl+Tnew tab in the work root (replaces Tabby's own new-tab)
Ctrl+1 … 9select fixed session slot 1–9
Ctrl+Lfocus the session list / same key returns to the terminal — then ↑↓ walk, Enter picks, Esc leaves
Ctrl+Wclose the current tab (the focused row when the list has the keyboard)
Ctrl+Oopen / close the preview panel
Ctrl+Rscreen repair (same as ↻; replaces Tabby's rename-tab — rename by double-clicking the row)
Ctrl+S · Ctrl+Dsplit the pane side by side / top-bottom (Tabby's own)
Ctrl+Qclose the focused split pane (Tabby's own close-pane, filled in while unbound)
Ctrl+Enter · Shift+Enternewline
Ctrl+Vpaste (images included)
Right-clickcopy with a selection, paste without one; hold for the context menu
Ctrl+Ffind inside the preview panel
Ctrl+Ssave while editing in the panel

Two actions ship unbound — agentdeck-toggle (sidebar / 4:3 on-off) and agentdeck-view-mode (Files ↔ Changes). Change any key under Settings → AgentDeck → Shortcuts — a key Tabby or AgentDeck already uses is flagged before it is applied. Tabby settings → Hotkeys (agentdeck-) works too.

12When something breaks

The screen is garbled

If a TUI looks broken, press ↻ in the sidebar (or right-click a row → repair screen). It clears the input-line remnant and has the app redraw. Turning on auto repair in settings detects the breakage and handles it for you.

Reporting a problem

Settings → Report a problem → collect builds a zip of diagnostics — version, environment, settings and recorded exceptions. Terminal contents are left out by default: that file would carry your code verbatim, so it is only included when you explicitly turn it on. Attach the zip to a GitHub issue.

New tabs will not open

Tabby 1.0.235 has a problem tangled up with restoring previous tabs. Turning on do not restore tabs on startup in settings fixes it — only the shell is restored anyway, and the agent session inside it is already dead, so there is nothing to lose.

13Scheduled work

A tab with pending work shows its scheduled task count. Automatic counting reads successful task creation, deletion, list and firing events from connected Claude sessions. One-shot tasks leave the list after firing; repeating tasks remain. Split tabs combine only their own connected sessions.

Other schedulers and tasks without recorded events cannot be counted automatically. Use right-click → Edit, disable automatic counting and enter a manual count. Change actual tasks through the agent or tool that created them. A subsequent scheduling event returns the display to automatic counting.

Closing a tab with pending tasks asks for confirmation. Setting a manual count of zero does not remove that protection when actual tasks are known. The subagent count ❖N is separate from the scheduled task count.

14Messaging between agents

  1. Set up status hooks and mailbox registration for participating sessions. The connection guide covers optional MCP and the authenticated CLI fallback. Registered agents in external terminals can participate by session ID too.
  2. Ask an agent to send its findings to the alias shown in your sidebar. It resolves the alias from the latest live list to an exact session ID.
  3. Look for a reply or acknowledgement. A queued message does not mean the recipient has read it.

A visible tab is not proof of messaging readiness. With message notifications enabled, an idle or completed tab receives a notice when ready for input; work, typing and IME composition defer it. Inserting the notice is not acknowledgement. See notification behavior and settings.

15Search and resume past conversations

  1. Expand Past sessions and enter a function name, error code, file name or session ID in its search box.
  2. Select a matching saved Claude or Codex conversation to preview the questions and answers.
  3. Choose Resume conversation to continue it.

This search is separate from the active-tab filter. It matches literal text without case sensitivity and excludes tool output and system instructions. Search runs locally and requires Node.js on PATH; it uses no MCP connection or AI request. See search scope and storage.

16Accounts, storage and further reading

Accounts

Click the account name below the sidebar to list accounts for the current tab's service. Use + to add account details including its full email address. For first login or expired authentication, complete browser login and connection approval for the selected account. Removing an account from the list does not log out a running CLI. See account switching and storage details (Korean).

Storage and work roots

Use Settings → AgentDeck → Storage paths to choose account, Claude and Codex data folders. Changes take effect after restarting Tabby; existing files are not moved automatically. To preserve records, close sessions, copy existing data to the new folders and restart. See storage migration steps (Korean).

Work root profiles choose where new tabs start. Removing a profile does not close open tabs. Move the Windows application by dragging its top title bar. See work roots and window movement (Korean).

Consult the full reference for configuration values, and all changes or GitHub Releases for version history.