morphyDocs

Terminal, browser and env vars

The side dock gives every project a real terminal, a browser, an editor for its .env files and a viewer for its files.

The dock on the right side of Morphy has four tabs: Terminal, Browser, Env vars and File viewer, as four icons in its top row (hover one for its name). Open or close it with Ctrl + Shift + B, or the panel icon at the right end of the tab strip. It opens on the tab you used last, and you can make it wider or narrower by dragging its left edge.

You can also open it from Ctrl + K (Show or hide the terminal and browser). Morphy remembers whether you left it open, also after a restart.

Typing in a chat?

Ctrl + Shift + B doesn't work while the cursor is in a text box, including the terminal itself. Click an empty spot on the canvas first.

Terminal

A real terminal. On Windows it's PowerShell 7 if you have it, otherwise Windows PowerShell, otherwise the command prompt. Its PowerShell runs installed scripts such as npm, even on a PC where Windows' default setting blocks them ("running scripts is disabled on this system"). On a Mac it's your login shell (zsh, unless you changed it).

  • Every project has its own terminals, and they open in the project's folder. A project without a folder uses Morphy's data folder.
  • The dock shows the terminals of the project you're working in: the last one you opened, or whose chat you clicked, typed in or went to from the sidebar or Ctrl+K (⌘K on a Mac). A chat outside any project leaves it as it was.
  • Click + (New terminal) for another one. Each tab's × ends what runs in it.
  • Terminals keep running when you switch projects or close the dock.
ToPress
CopyCtrl + C with text selected, or Ctrl + Shift + C
Stop the running commandCtrl + C with nothing selected
PasteCtrl + V or Ctrl + Shift + V
Copy or paste with the mouseRight-click (copies a selection, otherwise pastes)

On a Mac, ⌘ + C copies and ⌘ + V pastes. Control + C stops the running command, like in the Terminal app.

Pasting a screenshot or a copied picture pastes the path of a file Morphy saves it to, so Claude Code or Codex running in the terminal attaches it as an image.

If the shell ends (for example you typed exit), press Enter for a new one.

To work with an AI in its own command-line app instead of a chat, open a chat as a terminal: see Chats and agents.

Browser

A simple browser for checking a page while your agents work, for example the site an agent is building on localhost.

  • Type an address and press Enter. example.com becomes https://example.com.
  • A local dev server opens with or without http://: localhost:3000, 127.0.0.1:5173 or 192.168.1.20:8080 open as http://, like in Chrome.
  • Back, Forward and Reload sit next to the address bar.
  • Mute a page: when a page plays sound, a speaker icon shows up next to the address bar. Click it to mute the browser. It stays muted on other pages and the next time you open Morphy, until you click the speaker again. Morphy's own sounds, like a chat's bell, keep playing.
  • A page that doesn't load says why, for example "Nothing is running on localhost:80" when you typed localhost without your dev server's port. On your own computer it also offers the local servers you opened here before (one click opens one), and for an https:// address on a dev server, its http:// version. Try again loads it once the server is up.
  • It remembers the last page you opened.
  • Sign-ins on a dev server stay signed in, as in Chrome, also when the app's session cookie has a name starting with __Host- or __Secure- on http://localhost.
  • Links that open in a new tab open right here. Sign-in popups, like "Sign in with Google" on a site, open in a small window of their own and close themselves when you're signed in.
  • A file on your computer opens too: type or paste its path. See Open a file on your computer.

The address bar takes addresses and file paths only: typing words doesn't search the web. Pages in it can't reach Morphy or your files.

Open a file on your computer

To see an HTML file as a web page instead of as code (one an agent made, or one you're writing):

  • Type or paste its path in the address bar, for example C:\Users\you\my-site\index.html (on a Mac, /Users/you/my-site/index.html). A folder's path opens its index.html. A file:// address works too.
  • Right-click it in the Files view and choose Preview in the browser, or click the globe icon at the top of the file viewer while it's open there.

The page shows with its styles, scripts, pictures and fonts, and the address bar shows its path, which Morphy remembers like any address. Links to its other pages work. When you or an agent change the file, click Reload to see the change.

What such a page can reach: the files in its own folder and the folders inside it. When its links point higher, like ../css/style.css, it gets the folder they reach, but never more than its project's folder, nor your whole home folder, Desktop or Downloads. Only the kinds of file a web page uses are served (pages, styles, scripts, pictures, fonts, sound, video and data). Hidden files such as .env, and data files named like secrets such as secrets.json, never are. Other websites can't load or read any of them. Pointing at what should change works on these pages too.

See it as a phone

Click the phone icon at the right end of the address bar to see the page the way a phone sees it, like Chrome's device toolbar:

  • The page gets a phone's width, screen sharpness and user agent, so mobile layouts and media queries kick in. Your clicks act as taps (no hover).
  • The phone sits in the middle of the panel. When the panel is shorter than the phone, it's drawn smaller to fit; the row under the address bar shows its size and how far it's scaled, for example 393 × 852 · 85%.
  • Click the device's name in that row to switch between iPhone 15, iPhone SE, Pixel 8 and iPad mini, or to go back to Full width. The arrow at the row's end turns it sideways.
  • The page reloads when you switch, so it starts out as that device. It stays a phone while you browse, also on other sites, and Morphy remembers the choice next time.
  • Pointing at what should change works in phone view too.

It's Chrome pretending to be a phone, not Safari on an iPhone: it's right for layout and touch, but a Safari-only bug won't show up here.

Click the phone icon again to go back to the full width.

Point at what should change

On a site you're building, show an agent exactly what you mean instead of describing it (part of Pro; on Freemium the icon's tooltip says so):

  1. Click the select icon at the right end of the address bar.
  2. Move over the page: whatever is under the pointer gets a blue outline. Click the part you want changed. (Clicking doesn't press buttons or follow links while you pick.)
  3. A small box opens under it. Type what should change, for example "make this bigger and blue", and press Enter.

The chat gets your message together with that element: its text, its code, where it sits on the page and a picture of it. When your site runs as a development build (npm run dev), it also gets the components that put the element on the page and, for a CSS module, the class and the file it's in, for example .lead in app/site.module.css.

Which chat gets it: the box shows it ("→ chat name"), and so does the icon's tooltip. To send it somewhere else, click that name (or press Alt + ↓, Option + ↓ on a Mac): a list opens with the chats in your open tabs, each under its tab's name. Pick one with the mouse, or with the arrow keys and Enter. Esc closes the list without leaving the box.

When you don't choose, Morphy picks:

  • A chat you've selected on the canvas.
  • Otherwise the chat you switched to the last time you picked from this tab, while its tab is open.
  • Otherwise the chat on the canvas you're looking at that you used last, preferring one that's on screen and one working in the project's folder. If it's off screen, the canvas brings it into view, and it glows briefly when the message lands.
  • With no chat on this canvas, the chat you used last in your open tabs.
  • Morphy's own chat never gets it.

A chat on another tab gets the message where it is; the tab shows a badge when it's done. If the chat is busy, your message waits until it's done, like any message you send while it works.

Press Esc or click the icon again to stop picking.

Picking only works on sites running on your computer or your local network: localhost, addresses like 127.0.0.1 or 192.168.1.20, names ending in .test, .local or .internal, and files you open from your computer. On any other site, YouTube or your email for example, the icon stays off.

Env vars

Shows the .env files in the open project's folder (.env, .env.local, .env.production and so on), with a dropdown when there are several.

  • Values are hidden until you click Show value (or Show all values). Copy value copies one without showing it.
  • Add, Edit and Delete change the file directly, keeping its comments and order.
  • Import from a .env: paste the contents of another .env file, or drop the file onto the pane. You see how many keys are new, updated or unchanged before you confirm. An import never removes a key.
  • If the file changed on disk in the meantime, Morphy won't overwrite it: click Reload and make your change again.

A project without a folder has no .env files to show.

File viewer

Read a project's files without leaving Morphy. Click a file in the sidebar's Files view and it opens here, with its colours, line numbers and the dock opened on this tab. A file an agent read or wrote opens here too: click its name in the chat's steps ("reading warm.png"), even when it sits outside the project's folder. You can edit it too: any text or code file, not only Markdown.

  • Code and text show with colours for most languages. Pictures show as pictures.
  • Text files can be edited. Click in the text and type. A .md file reads like a note: headings, lists and checkboxes instead of raw symbols. Click a checkbox to tick it, for example to check off a test checklist an agent wrote for you. Any other text or code file keeps its usual colours and line numbers while you type. Your changes save to the file by themselves a moment after you stop typing (Ctrl + S saves at once), and Ctrl + Z undoes them. The file keeps its line endings. If an agent changes the file while your latest changes aren't saved yet, Morphy doesn't overwrite it. A row at the top asks instead: Keep my edits saves yours over it, Load the file shows the file as it is now (Ctrl + Z brings your edits back). Pictures, documents and other files Morphy can't show as text stay read-only.
  • It stays current. When an agent changes the file you're looking at, the change appears in place and the changed lines light up for a moment. Where you were scrolled stays put.
  • See an HTML file as a page: the globe icon at the top opens it in the dock's browser. Edits you haven't saved yet are saved first.
  • Several files open as tabs. Click a tab to go back to a file where you left it; its × (or a middle-click) closes it. Right-click a tab for Preview in the browser (an HTML file), Open in VS Code, Show in File Explorer, Copy path and Close others. Your tabs are still there after a restart.
  • Ask a chat about some lines: select them, then click Ask … under the selection. It names the chat it goes to: one on screen that works in this project if there is one, else the chat you used last. The file is attached to it and its message box starts with the lines, like "Lines 40–60 of src/app.js:". Type your question and send.
  • Find in the file: Ctrl + F while the file has the cursor (⌘ + F on a Mac). Enter goes to the next match, Esc closes it.
  • Long lines: the wrap icon at the top, or Alt + Z, wraps them to the dock's width. Markdown files always wrap.
  • Open in your code editor: the </> icon opens the file in VS Code, Cursor or whichever editor you picked in Settings.

A click only ever opens the file here. A very large file (over 2 MB) shows its start, and says so. A PDF, a video or another file Morphy can't show gets a tab too, with Open in its app and Show in File Explorer. A program only has the second: nothing is ever run from here.

On this page