A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
/* Copyright 2026 Marimo. All rights reserved. */
import type { EditorView } from "@codemirror/view";
import { useAtomValue, useSetAtom } from "jotai";
import {
ChevronDownIcon,
ChevronLeftIcon,
ChevronRightIcon,
ChevronsDownIcon,
ChevronsUpIcon,
ChevronUpIcon,
Code2Icon,
Columns2Icon,
DatabaseIcon,
EyeIcon,
EyeOffIcon,
HashIcon,
ImageIcon,
LinkIcon,
PlayIcon,
PlusCircleIcon,
ScissorsIcon,
SparklesIcon,
TextCursorInputIcon,
Trash2Icon,
XCircleIcon,
ZapIcon,
ZapOffIcon,
} from "lucide-react";
import { MultiIcon } from "@/components/icons/multi-icon";
import { useImperativeModal } from "@/components/modal/ImperativeModal";
import {
DialogContent,
DialogHeader,
DialogTitle,
} from "@/components/ui/dialog";
import { Label } from "@/components/ui/label";
import { toast } from "@/components/ui/use-toast";
import { aiCompletionCellAtom } from "@/core/ai/state";
import { maybeAddMarimoImport } from "@/core/cells/add-missing-import";
import { hasOnlyOneCellAtom } from "@/core/cells/cells";
import { useCellActions } from "@/core/cells/actions";
import { showHiddenCodeAtom } from "@/core/cells/editor";
import { type CellId, SETUP_CELL_ID } from "@/core/cells/ids";
import { useNotebookDocumentEdit } from "@/core/notebook/document";
import type { CellData } from "@/core/cells/types";
import { formatEditorViews } from "@/core/codemirror/format";
import {
getCurrentLanguageAdapter,
toggleToLanguage,
} from "@/core/codemirror/language/commands";
import { switchLanguage } from "@/core/codemirror/language/extension";
import { MARKDOWN_INITIAL_HIDE_CODE } from "@/core/codemirror/language/languages/markdown";
import {
aiFeaturesEnabledAtom,
appWidthAtom,
autoInstantiateAtom,
} from "@/core/config/config";
import type { CellConfig, RuntimeState } from "@/core/network/types";
import { canEditAtom } from "@/core/notebook";
import { canLinkToCell, createCellLink } from "@/utils/cell-urls";
import { copyToClipboard } from "@/utils/copy";
import { downloadCellOutputAsImage } from "@/utils/download";
import { MarkdownIcon, PythonIcon } from "../cell/code/icons";
import { useDeleteCellCallback } from "../cell/useDeleteCell";
import { useRunCell } from "../cell/useRunCells";
import { useSplitCellCallback } from "../cell/useSplitCell";
import { NameCellInput } from "./name-cell-input";
import type { ActionButton } from "./types";
export interface CellActionButtonProps extends Pick<
CellData,
"name" | "config"
> {
cellId: CellId;
status: RuntimeState;
hasOutput: boolean;
hasConsoleOutput: boolean;
getEditorView: () => EditorView | null;
}
interface Props {
cell: CellActionButtonProps | null;
closePopover?: () => void;
}
export function useCellActionButtons({ cell, closePopover }: Props) {
const {
moveCell,
sendToTop,
sendToBottom,
addColumnBreakpoint,
clearCellOutput,
createCell,
} = useCellActions();
const showHiddenCode = useSetAtom(showHiddenCodeAtom);
const edit = useNotebookDocumentEdit();
const splitCell = useSplitCellCallback();
const runCell = useRunCell(cell?.cellId);
const hasOnlyOneCell = useAtomValue(hasOnlyOneCellAtom);
const canDelete = !hasOnlyOneCell;
const deleteCell = useDeleteCellCallback();
const { openModal } = useImperativeModal();
const setAiCompletionCell = useSetAtom(aiCompletionCellAtom);
const aiFeaturesEnabled = useAtomValue(aiFeaturesEnabledAtom);
const autoInstantiate = useAtomValue(autoInstantiateAtom);
const canEdit = useAtomValue(canEditAtom);
const appWidth = useAtomValue(appWidthAtom);
if (!cell || !canEdit) {
return [];
}
const {
cellId,
config,
getEditorView,
name,
hasOutput,
hasConsoleOutput,
status,
} = cell;
const toggleDisabled = () => {
edit((tx) => tx.updateConfig(cellId, { disabled: !config.disabled }));
};
const toggleHideCode = () => {
const newConfig: Partial<CellConfig> = { hide_code: !config.hide_code };
edit((tx) => tx.updateConfig(cellId, newConfig));
const editorView = getEditorView();
// If we're hiding the code, we should blur the editor
// otherwise, we should focus it
if (editorView) {
if (newConfig.hide_code) {
editorView.contentDOM.blur();
} else {
editorView.focus();
}
}
};
const isSetupCell = cellId === SETUP_CELL_ID;
// Actions
const actions: ActionButton[][] = [
[
{
icon: <PlayIcon size={13} strokeWidth={1.5} />,
label: "Run cell",
hotkey: "cell.run",
hidden:
status === "running" ||
status === "queued" ||
status === "disabled-transitively" ||
config.disabled,
redundant: true,
handle: () => runCell(),
},
{
icon: <SparklesIcon size={13} strokeWidth={1.5} />,
label: "Refactor with AI",
hidden: !aiFeaturesEnabled,
handle: () => {
setAiCompletionCell((current) =>
current?.cellId === cellId ? null : { cellId },
);
},
hotkey: "cell.aiCompletion",
},
{
icon: <ScissorsIcon size={13} strokeWidth={1.5} />,
label: "Split",
hotkey: "cell.splitCell",
handle: () => splitCell({ cellId }),
},
{
icon: <Code2Icon size={13} strokeWidth={1.5} />,
label: "Format",
hotkey: "cell.format",
handle: () => {
const editorView = getEditorView();
if (!editorView) {
return;
}
formatEditorViews({ [cellId]: editorView });
},
},
{
icon: config.hide_code ? (
<EyeIcon size={13} strokeWidth={1.5} />
) : (
<EyeOffIcon size={13} strokeWidth={1.5} />
),
label: config.hide_code ? "Show code" : "Hide code",
handle: toggleHideCode,
hotkey: "cell.hideCode",
},
{
icon: config.disabled ? (
<ZapOffIcon size={13} strokeWidth={1.5} />
) : (
<ZapIcon size={13} strokeWidth={1.5} />
),
label: config.disabled ? "Enable execution" : "Disable execution",
handle: toggleDisabled,
hidden: isSetupCell,
},
],
// View as
[
{
icon: <MarkdownIcon />,
label: "Convert to Markdown",
hotkey: "cell.viewAsMarkdown",
handle: async () => {
const editorView = getEditorView();
if (!editorView) {
return;
}
maybeAddMarimoImport({ autoInstantiate, createCell });
switchLanguage(editorView, {
language: "markdown",
keepCodeAsIs: false,
});
// Code stays visible until the user blurs the cell
if (!config.hide_code && MARKDOWN_INITIAL_HIDE_CODE) {
edit((tx) =>
tx.updateConfig(cellId, {
hide_code: MARKDOWN_INITIAL_HIDE_CODE,
}),
);
showHiddenCode({ cellId });
}
},
hidden: isSetupCell,
},
// We need to check this here because the user may have toggled the language
getCurrentLanguageAdapter(getEditorView()) === "sql"
? {
icon: <PythonIcon />,
label: "View as Python",
hotkey: "cell.viewAsSQL",
handle: () => {
const editorView = getEditorView();
if (!editorView) {
return;
}
toggleToLanguage(editorView, "python", { force: true });
},
hidden: isSetupCell,
}
: {
icon: <DatabaseIcon size={13} strokeWidth={1.5} />,
label: "Convert to SQL",
hotkey: "cell.viewAsSQL",
handle: () => {
const editorView = getEditorView();
if (!editorView) {
return;
}
maybeAddMarimoImport({
autoInstantiate,
createCell,
});
switchLanguage(editorView, {
language: "sql",
keepCodeAsIs: false,
});
},
hidden: isSetupCell,
},
],
// Movement
[
{
icon: (
<MultiIcon>
<PlusCircleIcon size={13} strokeWidth={1.5} />
<ChevronUpIcon size={8} strokeWidth={2} />
</MultiIcon>
),
label: "Create cell above",
hotkey: "cell.createAbove",
handle: () => createCell({ before: cellId }),
hidden: isSetupCell,
redundant: true,
},
{
icon: (
<MultiIcon>
<PlusCircleIcon size={13} strokeWidth={1.5} />
<ChevronDownIcon size={8} strokeWidth={2} />
</MultiIcon>
),
label: "Create cell below",
hotkey: "cell.createBelow",
handle: () => createCell({ after: cellId }),
redundant: true,
},
{
icon: <ChevronUpIcon size={13} strokeWidth={1.5} />,
label: "Move cell up",
hotkey: "cell.moveUp",
handle: () => moveCell({ cellId, before: true }),
hidden: isSetupCell,
},
{
icon: <ChevronDownIcon size={13} strokeWidth={1.5} />,
label: "Move cell down",
hotkey: "cell.moveDown",
handle: () => moveCell({ cellId, before: false }),
hidden: isSetupCell,
},
{
icon: <ChevronLeftIcon size={13} strokeWidth={1.5} />,
label: "Move cell left",
hotkey: "cell.moveLeft",
handle: () => moveCell({ cellId, direction: "left" }),
hidden: appWidth !== "columns" || isSetupCell,
},
{
icon: <ChevronRightIcon size={13} strokeWidth={1.5} />,
label: "Move cell right",
hotkey: "cell.moveRight",
handle: () => moveCell({ cellId, direction: "right" }),
hidden: appWidth !== "columns" || isSetupCell,
},
{
icon: <ChevronsUpIcon size={13} strokeWidth={1.5} />,
label: "Send to top",
hotkey: "cell.sendToTop",
// When using the cell menu, likely the user doesn't want to scroll
// and instead just wants to get the cell out of the way
handle: () => sendToTop({ cellId, scroll: false }),
hidden: isSetupCell,
},
{
icon: <ChevronsDownIcon size={13} strokeWidth={1.5} />,
label: "Send to bottom",
hotkey: "cell.sendToBottom",
// When using the cell menu, likely the user doesn't want to scroll
// and instead just wants to get the cell out of the way
handle: () => sendToBottom({ cellId, scroll: false }),
hidden: isSetupCell,
},
{
icon: <Columns2Icon size={13} strokeWidth={1.5} />,
label: "Break into new column",
hotkey: "cell.addColumnBreakpoint",
handle: () => addColumnBreakpoint({ cellId }),
hidden: appWidth !== "columns" || isSetupCell,
},
],
// Outputs
[
{
icon: <ImageIcon size={13} strokeWidth={1.5} />,
label: "Export output as PNG",
hidden: !hasOutput,
handle: () => downloadCellOutputAsImage(cellId, "result"),
},
{
icon: <XCircleIcon size={13} strokeWidth={1.5} />,
label: "Clear output",
hidden: !(hasOutput || hasConsoleOutput),
handle: () => {
clearCellOutput({ cellId });
},
},
],
// Link to cell
[
{
icon: <TextCursorInputIcon size={13} strokeWidth={1.5} />,
label: "Name",
disableClick: true,
handle: (evt) => {
evt?.stopPropagation();
evt?.preventDefault();
},
handleHeadless: () => {
openModal(
<DialogContent>
<DialogHeader>
<DialogTitle>Rename cell</DialogTitle>
</DialogHeader>
<div className="flex items-center justify-between">
<Label htmlFor="cell-name">Cell name</Label>
<NameCellInput
placeholder={"cell name"}
value={name}
onKeyDown={(e) => {
if (e.key === "Enter") {
e.preventDefault();
e.stopPropagation();
openModal(null);
}
}}
onChange={(newName) =>
edit((tx) => tx.setName(cellId, newName))
}
/>
</div>
</DialogContent>,
);
},
rightElement: (
<NameCellInput
placeholder={"cell name"}
value={name}
onChange={(newName) => edit((tx) => tx.setName(cellId, newName))}
onEnterKey={() => closePopover?.()}
/>
),
hidden: isSetupCell,
},
{
icon: <LinkIcon size={13} strokeWidth={1.5} />,
label: "Copy link to cell",
disabled: !canLinkToCell(name),
tooltip: canLinkToCell(name)
? undefined
: "Only named cells can be linked to",
handle: async () => {
await copyToClipboard(createCellLink(name));
toast({ description: "Link copied to clipboard" });
},
},
{
icon: <HashIcon size={13} strokeWidth={1.5} />,
label: "Copy cell ID",
additionalKeywords: ["cell_id", "identifier"],
handle: async () => {
await copyToClipboard(cellId);
toast({ description: "Cell ID copied to clipboard" });
},
},
],
// Delete
[
{
label: "Delete",
hidden: !canDelete,
variant: "danger",
icon: <Trash2Icon size={13} strokeWidth={1.5} />,
handle: () => {
deleteCell({ cellId });
},
},
],
];
// remove hidden
return actions
.map((group) => group.filter((action) => !action.hidden))
.filter((group) => group.length > 0);
}