Skip to content

Commit 52a7b85

Browse files
docs(server): Claude launch-arg paths read from the thread's project folder
Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent c8fb431 commit 52a7b85

2 files changed

Lines changed: 10 additions & 5 deletions

File tree

‎apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.ts‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1914,10 +1914,10 @@ export function makeClaudeQueryOptions(input: {
19141914
}
19151915

19161916
/**
1917-
* Checks the append launch arguments the way the Claude CLI would and reads
1918-
* the file relative to the process cwd, expanding a leading ~.
1919-
* makeClaudeQueryOptions folds these flags out of extraArgs, so a value the CLI
1920-
* would have rejected has to be rejected here or it silently disappears.
1917+
* Checks the append launch arguments the way the Claude CLI would and reads the
1918+
* file (leading ~ expanded) relative to the thread's cwd. makeClaudeQueryOptions
1919+
* folds these flags out of extraArgs, so a value the CLI would have rejected has
1920+
* to be rejected here or it silently disappears.
19211921
*/
19221922
const readClaudeAppendSystemPromptFile = Effect.fnUntraced(function* (input: {
19231923
readonly settings: ClaudeSettings | undefined;
@@ -1959,7 +1959,8 @@ const decodeClaudeLaunchArgSettings = Schema.decodeUnknownEffect(
19591959

19601960
/**
19611961
* Reads the --settings launch argument: a value starting with a brace is inline
1962-
* JSON, anything else is a file path relative to the cwd, expanding a leading ~.
1962+
* JSON, anything else is a file path that expands a leading ~ and is otherwise
1963+
* relative to the thread's cwd (the project or its worktree).
19631964
* makeClaudeQueryOptions merges the result beneath T3's own settings.
19641965
*/
19651966
const readClaudeLaunchArgSettings = Effect.fn("ClaudeAdapterV2.readLaunchArgSettings")(

‎docs/user/providers-claude.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,10 @@ state. Claude does not have Codex's shared-home and shadow-home arrangement.
4040
For presets that differ only in API keys or endpoints, use the instance's
4141
**Environment variables**. Variable assignments do not belong in **Launch arguments**.
4242

43+
File paths in the `--settings` and `--append-system-prompt-file` launch arguments
44+
can start with `~` for the home directory of the machine running T3 Code. Any
45+
other relative path is read from the thread's project folder, or its worktree.
46+
4347
Claude Code's verbose mode can stay enabled when you use Claude for text generation, including
4448
thread titles, branch names, commit messages, and pull request descriptions. On a remote connection,
4549
T3 Code uses the Claude configuration on the connected server.

0 commit comments

Comments
 (0)