The layout
Note
Shortcuts in these pages are shown for a Mac. On Windows and Linux, use Ctrl where a Mac uses Cmd. The keyboard shortcuts page lists both.
From top to bottom, left to right:
- The title bar, across the top.
- The side panel on the left, with the Explorer and the other views.
- The editor in the middle.
- The bottom panel: Problems, Output, Debug Console, Terminal and Ports.
- The right panel: the Code agent and Operations.
The title bar
| Part | What it does |
|---|---|
| Back and forward | Move through the places you've been in the code (Ctrl- and CtrlShift- on a Mac, AltLeft and AltRight elsewhere). |
| Project | The open folder. Click to open another. |
| Visual and Code | Switch Piye's side, on the same project. |
| Piye Studio | Open the window for agents across all your projects. |
| Right panel views | Show Operations only, the agent only, or both side by side. |
| Marketplace | Find and connect MCP servers. See MCP and the Marketplace. |
| Account menu | Your plan and credits, the last 14 days of AI use, Account, Handoff, AI, your outside agents (Claude Code, Codex) and Open Settings. |
On a window with no project open, the bar shows only the Visual and Code switch, the Marketplace and your account.
The side panel
The name at the top of the side panel (for example Explorer ▾) is a menu: click it to switch view.
| View | What it shows |
|---|---|
| Explorer | Your files, with Git status, plus Outline (the symbols in the open file) and Timeline (the file's history). |
| Apps | Phone and desktop apps in the project: run them, devices, stores and setup. See Apps and previews. |
| Deploy | Ship to hosts, Docker and history. See Deploy. |
| Search | Search and replace across files. See Search and replace. |
| Source Control | Changes, staging, commits and branches. See Source control. |
| Run and Debug | Launch configurations and the debugger. See Run and debug. |
| Testing | Your tests, by file. See Tasks and testing. |
| Extensions | OXP extensions installed on this computer. See Extensions. |
| Disk | What fills your disk in known developer places, with a safe cleanup. |
| OXP | The OXP catalog. |
Shortcuts open the main views directly: Explorer CmdShiftE, Search CmdShiftF, Source Control CtrlShiftG (Mac), Run and Debug CmdShiftD, Marketplace CmdShiftX. CmdB shows or hides the side panel.
The editor
Tabs along the top, with splits side by side (Cmd\). Above the code, a path bar shows where you are in the file and its symbols. See The editor.
The bottom panel
| Tab | What it shows |
|---|---|
| Problems | Errors and warnings from the language servers, type checks and linters, with a filter. |
| Output | Logs from Piye's tools and language servers, by channel. |
| Debug Console | The running program's console while debugging. |
| Terminal | Your terminals. See Terminal. |
| Ports | Ports your running programs listen on: open them in Piye's browser or your own. |
Show or hide it with Ctrl` on every computer; the X closes it, and a tab on the window edge brings it back.
The right panel
The right panel holds the Code agent (CmdShiftA toggles it, Cmd3 focuses it) and Operations (CmdShiftO). Show either one, or both split.
Rearrange it
- Hide a side panel with the tab on its inner edge; bring it back from the tab on the window edge where it was. The controls follow a panel wherever you dragged it.
- Drag a panel by its top edge to swap it with another.
- Pull a panel into its own window: the agent, Operations and the terminal can each live in a separate window (drag them off, or use their pull-off button; CmdShiftT pulls off the terminal). Bring back returns them.
- Reset Workbench Layout (command palette) puts everything back.
Window layouts
Settings, Window & Layout, Window Layout:
- Editor + Panels: the editor with the Explorer, agent and terminal (the layout once a folder is open).
- Editor Only: the empty canvas before a folder is open.
- Agent Focus: keeps the chat and hides the Explorer and terminal.
Interface size (Settings, General) draws Piye's own screens smaller or larger, without changing your code's font size.