Skip to main content
Sessions are the core workspace in OpenCode Portal where you interact with AI agents to accomplish coding tasks. Each session maintains its own conversation history and context.

​
Creating a New Session

There are multiple ways to create a new session:
Click the New Session button in the left sidebar. The session will be created instantly and you’ll be navigated to the new chat interface.
On desktop, press Shift + Enter to quickly create a new session from the empty state screen.On mobile, tap the New Session button at the top of the home screen.
Use the command palette to quickly create a session without leaving your current view.

​
Viewing Sessions

All your sessions are listed in the left sidebar, organized chronologically. Each session displays:
  • Session title - Automatically generated based on your conversation
  • Quick access - Click any session to open it immediately
Session titles are truncated for readability. Hover over a session name to see the full title in a tooltip.

​
Managing Sessions

​
Switching Between Sessions

Simply click on any session in the sidebar to switch to it. Your current conversation context is preserved when you switch away.

​
Deleting Sessions

To delete a session:
  1. Hover over the session in the sidebar
  2. Click the three-dot menu icon that appears
  3. Select Delete Session
Deleting a session is permanent and cannot be undone. All conversation history and context will be lost.
When you delete the currently active session, you’ll automatically be redirected to the home screen.

​
Session Behavior

​
Mobile Experience

On mobile devices, the session list is integrated into the home screen for easy access:
  • The New Session button appears prominently at the top
  • Sessions are listed below with swipe-friendly controls
  • The menu for deleting sessions is accessible via the three-dot icon

​
Desktop Experience

On desktop, the sidebar provides persistent access to all sessions:
  • Sessions remain visible while working
  • Keyboard shortcuts make session creation faster
  • The sidebar can be collapsed for more workspace

​
Empty State

When you first open OpenCode Portal or have no active session selected, you’ll see the empty state screen:
  • A welcome message with instructions
  • Quick access to create a new session
  • A list of existing sessions (on mobile)
  • Keyboard shortcut hints (on desktop)
Sessions persist across browser sessions. Close and reopen Portal anytime to continue where you left off.

Build docs developers (and LLMs) love

Get started for freeTalk to us