Jean logoJean

Project Canvas and Chat

Move between the canvas, session tabs, terminal, files, and shortcuts without losing the thread of the work.

Jean's day-to-day workflow lives in two places: the project canvas and the chat window.

The canvas helps you choose and manage work. The chat window is where you execute it.

Project canvas

The project canvas is what you see when a project is selected but no workspace chat is active.

It gives you a rolled-up view of:

  • worktrees
  • session cards
  • activity state
  • git status
  • PR status
  • run script availability
  • quick open actions for editor, terminal, finder, and GitHub

This is the best place to answer "what is already in flight for this repo?"

Session status at a glance

Jean groups active work with status cues such as:

  • waiting for input or approval
  • planning
  • active execution
  • review-ready or completed

That makes it easier to spot which sessions need your attention before you dive back into one of them.

Chat window

When you open a base session or worktree, Jean switches into the chat window.

This is where you:

  • send messages
  • switch tabs
  • approve plans
  • answer agent questions
  • inspect tool calls
  • preview files and images
  • open diffs
  • keep a terminal panel beside the conversation

Terminal and file tools

Jean's chat workflow is not limited to text.

Inside the workspace you can:

  • run the configured project command from jean.json
  • inspect file content and previews
  • open git diffs
  • open the workspace in your preferred editor or terminal

That keeps the talking part close to the checking part.

Command palette

Press Cmd+K on macOS or Ctrl+K elsewhere to open the command palette.

It includes:

  • project switching
  • navigation
  • settings
  • GitHub actions
  • session actions
  • window controls

This is often the fastest way to move around once the workspace gets crowded.

A few defaults worth learning

Common defaults include:

  • Cmd+L to focus chat input
  • Cmd+B to toggle the left sidebar
  • Cmd+, to open preferences
  • Cmd+M to open the magic menu
  • Cmd+N to create a worktree
  • Cmd+T to create a new session
  • Shift+Tab to cycle execution mode

Next reads

On this page