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
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

cmux's Default New Tab page, as a look you install, laid out like Claude's desktop new-session screen: 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 "Chats" with five chats as quiet rows (the ones that need you first), and the composer.
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:
| File | What it does |
|---|---|
cmux-setup.json | Sets 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.md | Before (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-lookReading 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 (permission mode, model). Until then the field is a plain text field that
starts a chat with
newTab.submit, and a row only marks the folder the label over the field shows. - 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 (a view gets the chat glyph); the cards' raised surface and shadow.
- With no chats, cmux's page shows placeholder rows while it reads; the look says "No chats yet".
