Getting startedOverview

Getting started

Overview

PzzaCode keeps every terminal and every coding agent on one grid. This page walks your first session from the top bar to the grid.

Top bar · New session
Get started in a minute

Creating a session is the same gesture whether you want a plain shell or a coding agent - the app launches a real terminal on the device you pick and drops it into the current workspace.

  1. Start a session. Hit New session in the top bar and give it a name.
  2. Pick where it runs. Choose the device and workspace - and an account, if you keep several.
  3. Stay on the grid. Hop between tiles with ⌃1⌃9.
  4. Quit freely. Sessions keep running on their devices.
One grid for every terminal

Each tile is a live terminal: a plain shell, or a coding agent like Claude Code, Codex or OpenCode. Instead of hunting through tmux windows or terminal tabs, everything you run is visible on one screen - across every device you added. Tiles can be dragged to reorder, maximized, hidden, or sized wide, tall and big inside the grid.

Closing changes nothing

Tiles are backed by real tmux sessions on the device, not by the app window. Closing PzzaCode - or losing the connection - only detaches your view. Reopen the app, or open the same session from a plain terminal: the agents are exactly where you left them, output and all.

Everything you change is remembered

Workspaces, grid columns, tile names, hidden tiles and window state are saved by the device’s agent, not by the browser. Point any browser at that device and your layout is already there.

New here? Open your first session from the top bar, then take the guided tour - it walks every control in place.

Was this page helpful?