Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/aipoch/open-science/llms.txt

Use this file to discover all available pages before exploring further.

The workspace is the main interface in Open Science — a three-panel layout designed for iterative research. Every panel plays a distinct role: the sidebar manages sessions, the conversation panel is where you interact with the AI agent, and the preview panel surfaces outputs and files without interrupting your flow.

The Three Panels

Sidebar

The left panel shows your project name, lists all sessions, and provides the New and Files entry points. Navigate back to all projects using the ← All projects button at the top.

Conversation

The center panel is the main chat surface — message thread, inline tool activity, permission requests, and the composer at the bottom.

Preview

The right panel renders file previews, notebook output, and the project file browser. It defaults to 40% of the workspace width and can be resized or collapsed entirely.

Session Sidebar

The sidebar is scoped to the active project — only sessions belonging to that project are listed. Each session row shows a status indicator dot:
Status dotMeaning
Empty ring (border only)idle — the session is waiting for input
Solid color with glowrunning — the agent is actively executing
Amber with glowwaiting-permission — paused for a permission decision
Rederror — the last run encountered a problem
Creating a session: click the New button at the top of the session list to start a fresh conversation. The button is disabled until session persistence has finished hydrating — this prevents new messages from being stamped to the wrong session. Switching sessions: click any session row to make it the active session. Unsent attachments from the previous draft are discarded automatically when you switch. Renaming or deleting a session: hover over a session row and click the menu icon that appears. Select Rename… to edit the session title, or Delete to permanently remove the session and its runtime state. Files button: clicking Files opens the project file browser in the preview panel, giving you a tree view of every file in the project’s working directory. Home button: the ← All projects link at the top of the sidebar navigates back to the project list.

Conversation Panel

The conversation panel renders the full message thread for the currently selected session and owns the composer for sending new messages. Message thread: the thread shows user messages, streaming assistant responses rendered as Markdown, tool activity events (including tool inputs and outputs), and artifact events when the agent produces output files. Composer: the textarea at the bottom of the panel accepts your message. Attached files appear as chips above the text area. Errors from the runtime or attachment upload failures appear between the notebook status bar and the composer frame. Notebook status bar: when the agent first uses the notebook in a session, a small status bar appears above the composer with a Notebook button. Clicking it opens the live notebook session in the preview panel. Cancelling a run: while the agent is running or waiting for a permission decision, the Send button is replaced by a Cancel (square) button. Clicking it cancels the active run for the current session. Preview panel toggle: the icon in the conversation header opens or collapses the preview panel. The icon color changes to indicate the current state.
Press Enter to send a message. Use Shift + Enter to insert a newline in the composer without sending. IME composition (e.g. CJK input) is always allowed to complete before submission.

Preview Panel

The preview panel is a tabbed workbench on the right side of the workspace. Each open item — a file, the notebook, or the project files browser — gets its own tab. Clicking a tab’s × button closes it without affecting other open tabs. Opening and closing: click the preview panel toggle in the conversation header, or click the Files button in the sidebar, or click any artifact file in the conversation thread to open the panel. The panel opens and closes with a smooth spring animation (disabled when the system prefers-reduced-motion setting is on). Resizing: drag the divider between the conversation panel and the preview panel to resize. The preview panel enforces a minimum open size of 30% of the workspace width and a default size of 40%. Panel state persistence: the open/collapsed state and last-used width are persisted per project, so your layout is restored the next time you open the same project.
Drag the divider between the conversation and preview panels to find the split that best fits your workflow — a wider preview is useful when examining large data tables or 3D molecular structures.

Build docs developers (and LLMs) love