Default New Tab

A new-session screen: where the chat starts and what needs you over the composer, your five latest chats as quiet rows.

manaflow-ai· 0 downloads · 0 stars· v1.0.0

Default New Tab screenshot 1Default New Tab screenshot 2

cmux's Default New Tab page, rebuilt as a look on the public customization API: a cmux.newtab/1 view that draws the whole New Tab page, picked with tabs.newTabApp. Remove it and cmux's own New Tab page comes back.

Default New Tab

Get it on cmux

The Default New Tab page: the environment and suggestions cards, recent chats, the composer

cmux's Default New Tab page, as a look you install, laid out like Claude's desktop new-session screen: over the composer, centered, the environment card (the folder the chat starts in, this Mac's other recent projects, Choose environment) and the suggestions card (the chats that need you), then your five most recent chats as quiet rows.

It used to ship inside cmux as a New Tab template. It is now built only on the public customization API, so you can read and change every part of it:

FileWhat it does
cmux-setup.jsonSets tabs.newTabApp to this look's view, so it draws the New Tab page
customize/A cmux.newtab/1 view: the cards, the recent rows and the composer (main.js)
shots/How the screenshots are drawn: main.js in cmux's own app runtime, through cmux's web New Tab page
SHOTS.mdBefore (the template cmux shipped) and after (this look), side by side
cmux setup install github.com/manaflow-ai/cmux-newtab-default-look
cmux setup remove manaflow-ai/newtab-default-look

Reading your chats and projects is granted at install. Starting a chat, opening one and choosing a folder need Run actions and Change workspaces, which you turn on in Settings > Apps > My views.

While it is installed, its customize/ view stands in for your own view, if you have one; cmux setup remove puts yours back and cmux draws its own New Tab page again.

What the public API does not do yet

The look follows cmux's own page as far as the API reaches today. What is still missing is tracked in the cmux repository and lands there, not here:

  • cmux's own composer as a view node, with a folder the view can set (the environment card's rows pick it) and its footer (mode, model, effort). Until then the field is a plain text field that starts a chat with newTab.submit, in a new tab, and a row only marks the folder.
  • cmux's project chooser for Choose environment (search, a typed path, Browse, No project).
  • The page's height for the view, so the composer sits at the page's foot; until then it follows the cards.
  • Recent chats and the chats that need you, read and ordered by cmux itself, with each chat's last reply; the rows' hover card; an agent's own mark; the cards' raised surface and shadow.