Workspace sessions

A workspace session is a session that does not belong to a task. It has no workflow steps. It uses the same session page as a task session. The agent can read your repository and create tasks.

FIFADS

Needs you0

Running2

Recent3

Plan the export feature

ArchiveTerminal

Split this request into tasks that each fit in one pull request. Search the board first, and do not create a task that already exists. Request: Export notebooks to Markdown and PDF

10:24:12 AM

search_tasks1 result · title: export · limit: 10212ms10:24:15 AM

fieldnotes-m2q7 already covers the Markdown export. I will create the two tasks that are missing.

create_taskExport a notebook as PDF64ms10:24:21 AM

Export a notebook as PDF

fieldnotes-q7d1Open

FeatureP2Backlog

Save a notebook as a PDF file. Reuse the Markdown export of fieldnotes-m2q7.

exportpdf

create_taskAdd Export to the notebook menu64ms10:24:26 AM

Add Export to the notebook menu

fieldnotes-w5j3Open

TaskP3Backlog

Add an Export item to the notebook menu. It saves the notebook as Markdown, and it shows an error when the export fails.

exportui

Worked for 14s

The two new tasks are in Backlog. The PDF export is a feature, so it starts with a spec. fieldnotes-w5j3 is a task, so its Builder can start now.

claude/Lyra 3 · high

/tasks-from-requestcustomSplit a request into tasks that each fit in one pull request./tasks-from-bugcustomWrite a bug task with the steps to reproduce and the expected result./tasks-cleanupcustomFind duplicate and stale tasks in the backlog.

@ for files; / for commands; $ for skills

Lyra 3high18.4K

Starting Builder sessionBuilder session ready3/3

fieldnotes · fieldnotes-w5j3

Create task worktreePendingRunning
Set branch upstreamPendingRunning
Start sessionPendingRunning

Open

A workspace session creates the missing tasks, then starts a Builder in the background.

Start a workspace session

FIFADS

Search tasksLabelsTypePriority

Refresh Tasks

Backlog2 tasks

No tasks in this lane.

Export a notebook as Markdown

FeatureP2

fieldnotes-m2q7

Start Spec

Show an error when sync fails offline

BugP1

fieldnotes-b8t1

Start Builder

Spec Ready1 task

No tasks in this lane.

Let people search notes by title

FeatureP2

fieldnotes-h5w3

Spec

Start Planner

In Progress1 task

No tasks in this lane.

Open search with a keyboard shortcut

FeatureP2

fieldnotes-k3x9

SpecPlanner

BuilderRunning

New session

Choose where the agent works and how it starts.

Name optionalProfile the slow searchWhat are you working on?

Runtime and modelGPT-6-Astra

Efforthigh

SpeedStandard

Custom role optional

No roleManage roles

Work location

Current checkoutWork with the files already here.New worktreeUse an isolated directory and branch.Existing worktreeUse a worktree that already exists.

Target branchorigin/main

Compare this session's changes with this branch.

Existing branchNew branch

Creates a new branch from the target branch.

Worktree namesearch-profilemy-feature

Spaces and slashes become hyphens in the directory name.

Directory: search-profile

Advanced

New branch: odt/search-profile

fieldnotes · Workspace session

0 of 3 steps

Create workspace worktreePendingRunning
Set branch upstreamPendingRunning
Start sessionPendingRunning

CancelCreate sessionCreating session…

Start a session in a new worktree, then send the first message to the agent.

In a collapsed sidebar, select +, then New session. You can also run New session from the command palette.

Runtime and model starts with the Default model of the repository. For OpenCode, also check Runtime profile.

Work location	Where the agent works
Current checkout	In your repository folder, on its current branch. The agent changes the files of your checkout.
New worktree	In a new folder, on a new branch or an existing branch. Enter a Worktree name. Your checkout does not change.
Existing worktree	In a worktree that you select. Use it to continue work in the worktree of a task or an earlier workspace session.

The session compares its changes with the Target branch.

New session has no Goal mode. To give the agent a goal, send /goal and the objective in its composer. See Set a goal with /goal.

Use a custom role

A custom agent role, such as a code reviewer, gives a workspace session its own instructions.

Open Settings, then Custom agent roles, and select Add role.
Enter a Name and a System prompt, then select Save settings.
Start a workspace session, and choose the role in Custom role in the New session dialog.

Roles are available in every workspace. New sessions use the saved role. Existing sessions keep their role when you edit or delete it.

Create tasks from a request

Ask the agent to create tasks, for example:

Message to the agent

Let people export a notebook to Markdown and to PDF. Split this into tasks that each fit in one pull request. Search the board first, and do not create a task that exists.

New tasks start in Backlog. Their first step depends on their issue type.

Each new task shows as a card in the session. Select Open on a card. The task details open.
Select the workflow action, for example Start Builder. Then select Run in background. The task session starts, and the workspace session stays open.

Fork a workspace session

FIFADS

Profile the slow search

ArchiveTerminal

Find why search is slow in large notebooks, and suggest a fix.

10:31:08 AM

Worked for 52s

Search reads every note from disk for each query. An index of the words in each note lets a query read only the notes that match.

openai/GPT-6-Astra · high

Build the index in a background worker.

10:33:40 AM

Worked for 1m 14s

The worker builds the index when a notebook opens, and search now reads the index.

openai/GPT-6-Astra · high

@ for files; / for commands; $ for skills

GPT-6-Astrahigh50.4K

Fork session

Copy the conversation through this reply, then choose where the new session works.

Work location

Same folderWork with the files already here.New worktreeStart from the last commit in the source folder.

Source folder

search-profile

odt/search-profile

/Users/sam/.openducktor/worktrees/fieldnotes/workspace-sessions/search-profile

Worktree namesearch-profile-forkmy-feature

Spaces and slashes become hyphens in the directory name.

Directory: search-profile-fork

Branch name optionalodt/search-profile-fork

New branch: odt/search-profile-fork

Uncommitted changes in the source folder do not go to the new worktree.

fieldnotes · Workspace session

0 of 3 steps

Create workspace worktreePendingRunning
Set branch upstreamPendingRunning
Start sessionPendingRunning

CancelFork sessionForking session…

Fork a session from an earlier reply into a new worktree, then send another follow-up.

A fork is a new workspace session with the conversation of the source session up to one reply. Use it to try another follow-up and keep the source session as it is.

Fork from this reply shows under the last reply of each completed turn. The fork keeps the runtime, the model, the role, and the target branch of the source session.

Work location	Where the fork works
Same folder	In the folder of the source session. The two sessions change the same files.
New worktree	In a new worktree, on a new branch from the last commit of the source folder. Uncommitted changes do not go to the new worktree. The source folder must have a commit.

Import a session from an external runtime

Continue in OpenDucktor a conversation that you started in OpenCode, Codex, or Claude Code.

FIFADS

Search tasksLabelsTypePriority

Refresh Tasks

Backlog2 tasks

No tasks in this lane.

Export a notebook as Markdown

FeatureP2

fieldnotes-m2q7

Start Spec

Show an error when sync fails offline

BugP1

fieldnotes-b8t1

Start Builder

Spec Ready1 task

No tasks in this lane.

Let people search notes by title

FeatureP2

fieldnotes-h5w3

Spec

Start Planner

In Progress1 task

No tasks in this lane.

Open search with a keyboard shortcut

FeatureP2

fieldnotes-k3x9

SpecPlanner

BuilderRunning

Import session

Continue an existing conversation from this repository or one of its worktrees.

RuntimeClaude

Search sessionsTitle, session ID, or directory

Speed up search in large notebooks
/Users/sam/code/fieldnotes
Session ID7c1e4b2a-93d5-4f08-b6a1-2e8d5c0f9a34
2h agoImportImporting…
Fix the sync retry after offline mode
/Users/sam/code/fieldnotes
Session IDe5a90f3c-1b7d-4c62-8e44-9d03a6b1f7c8
1d agoImportImporting…
Search notes by tag name
/Users/sam/code/fieldnotes-tags
Session ID3f8b6d10-c2e9-47a5-9b3e-61a4d7e2c05b
3d agoImportImporting…
Review the export to Markdown
/Users/sam/code/fieldnotes
Session IDb04d7e9a-58c1-4e3f-a2d6-0c9f1b8e3a72
6d agoImportImporting…

4 sessions

Cancel

Import a Claude Code conversation of the repository, then continue it in OpenDucktor.

Select the arrow beside New task, then Import session from an external runtime. You can also run it from the command palette.

The list shows only the main conversations that started in the repository folder or in one of its Git worktrees, and that no task or workspace session uses yet. For Codex, it also shows the sessions that you archived in Codex.

The import does not copy the conversation. OpenDucktor continues the same session, with the same session ID, in the same folder. It uses the title and the model of the session, and the default target branch of the repository.

The list stays current for 10 minutes. If an import fails with a message that ends with Reload sessions., close the dialog and open it again.

Archive a workspace session

Select Archive in the session header.
For a session in a worktree, Remove worktree and branch is on. Archive then deletes the worktree and its branch. To keep them, turn it off. If another workspace session or an open task uses the worktree, OpenDucktor keeps it.
Select Archive session. The session moves to Archived sessions, and its agent and terminals stop.

To restore a workspace session, select the arrow beside New task, then Archived sessions, then Restore on the session.

Workspace sessions

Start a workspace session

Use a custom role

Create tasks from a request

Fork a workspace session

Import a session from an external runtime

Archive a workspace session

Next

Coding sessions

Tasks and workflows

Command palette

On this page

Workspace sessions

Start a workspace sessionCopy Anchor Link

Use a custom roleCopy Anchor Link

Create tasks from a requestCopy Anchor Link

Fork a workspace sessionCopy Anchor Link

Import a session from an external runtimeCopy Anchor Link

Archive a workspace sessionCopy Anchor Link

NextCopy Anchor Link

Coding sessions

Tasks and workflows

Command palette

On this page

Start a workspace session

Use a custom role

Create tasks from a request

Fork a workspace session

Import a session from an external runtime

Archive a workspace session

Next