Back to Marimo

Sidebar and Developer Panel

docs/guides/editor_features/panels.md

0.23.53.2 KB
Original Source

Sidebar and Developer Panel

marimo organizes editor tools into two main areas: the sidebar on the left and the developer panel at the bottom. This layout keeps everyday notebook tools easily accessible while providing a dedicated space for debugging and development utilities.

<div align="center"> <picture> <source srcset="/_static/docs-sidebar-developer-panel.webp" type="image/webp"> </picture> </div>

The sidebar provides quick access to panels you'll use frequently while working on notebooks. Click the icons on the left edge of the editor to open panels.

Default sidebar panels:

PanelDescription
FilesBrowse workspace files and inspect remote storage connections
VariablesExplore variables and data sources in your notebook
PackagesView installed packages and manage dependencies
AIChat with AI assistants and use agents
OutlineNavigate your notebook via table of contents
DocumentationView live documentation as you type
DependenciesVisualize cell relationships with the minimap and dependency graph

Toggle the sidebar with Cmd/Ctrl-Shift-S.

Developer Panel

The developer panel houses tools for debugging, tracing execution, and other advanced functionality. It appears at the bottom of the editor, similar to the developer tools in VS Code or browser DevTools.

Default developer panel tabs:

PanelDescription
ErrorsView all errors across your notebook
ScratchpadA scratch cell for quick experiments without affecting your notebook
TracingMonitor cell execution and performance
SecretsManage environment secrets
LogsView stdout and stderr output
TerminalIntegrated terminal for shell commands
SnippetsBrowse and insert code snippets

Toggle the developer panel with Cmd/Ctrl-J.

<!-- TODO: Add screenshot of developer panel expanded -->

Customizing your layout

Both the sidebar and developer panel are fully customizable. You can:

  • Reorder panels: Drag panels to rearrange their order within a section
  • Move panels between sections: Drag a panel from the sidebar to the developer panel (or vice versa) to relocate it
  • Hide panels: Right-click a panel icon to access options for hiding or moving it

Your layout preferences are saved and persist across sessions. Panels automatically adapt their appearance based on their location — showing a more compact vertical layout in the sidebar and a wider horizontal layout in the developer panel.

<div align="center"> <video autoplay muted loop playsinline style="max-width: 700px; width: 100%; border-radius: 8px;"> <source src="/_static/docs-panel-drag-drop.webm" type="video/webm"> </video> </div>

Keyboard shortcuts

ShortcutAction
Cmd/Ctrl-JToggle developer panel
Cmd/Ctrl-Shift-SToggle sidebar
Cmd/Ctrl-Shift-IOpen minimap (in Dependencies panel)
Ctrl-`Open terminal