[FEATURE]: Allow sessions to have custom working directories

Feature hasn't been suggested before.

I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Feature: Allow sessions to have custom working directories

Problem

Currently, all sessions share the same working directory (Instance.directory). This limits the ability to run multiple sessions in parallel when they need isolated file systems, such as:

Working on different git branches simultaneously
Running sessions in sandboxed environments
Supporting non-standard project layouts

Proposed Solution

Add a session.creating plugin hook - Allow plugins to customize session creation, including setting a custom working directory
Add Session.directory accessor - Allow sessions to have their own working directory that tools respect, falling back to Instance.directory if not set

Use Cases

Git worktrees: A plugin could create a separate worktree for each session, enabling parallel work on different branches without conflicts
Sandboxing: Sessions could operate in isolated directories for security or testing
Monorepos: Sessions could target different packages within a monorepo

Implementation

I already started playing around to add this feature and opened these two PRs that would complete the feature:

Let me know what you think and thanks for making opencode! 🫡

This issue might be a duplicate of existing issues. Please check:

[FEATURE]: tie working directory / directories with chat session #4048: [FEATURE]: tie working directory / directories with chat session - Requests the ability to tie working directories with chat sessions
Create session with a different root/working directory #1143: Create session with a different root/working directory - Requests session-specific working directories for monorepo scenarios
[FEATURE]: Multiple model usage with git worktrees #6679: [FEATURE]: Multiple model usage with git worktrees - Related request for git worktree support with separate directories
Concurrent sessions working on different repos interfer each other #4251: Concurrent sessions working on different repos interfere each other - Reports interference issues when sessions work in overlapping directories

Feel free to ignore if none of these address your specific case.

#4048 and #1143 are related use-cases to issue I opened here (not necessarily a duplicate IMO)
#6679 would become possible with solution i provided, but has a different use-case in mind

None of those previous issues had a solution proposed or implemented, but I have two (hopefully useful) PRs open that adds the feature.

This is actually already working on CLI side. If you start opencode in a subdirectory of a project - it will set session.directory to that pwd. Allowing a different external_directory permission setup and such.

The POST /session API also has that directory parameter.

Issue is just: the web UI just doesn't currently show these (they are shown in TUI), nor allows to select this (in console you just start in that directory)

Closing as duplicate of #1143 - this is being addressed in PR #9365 which adds per-session working directory support.

Navigation Menu

Repository navigation

[FEATURE]: Allow sessions to have custom working directories #9366

Feature hasn't been suggested before.

Describe the enhancement you want to request