Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { normalizeRuntimePathSeparators } from './cross-platform-path'
import {
normalizeCustomWorktreeVisibilitySources,
normalizeWorktreeVisibilitySourcePreferences
} from './worktree/visibility-sources'
import type { WorktreeVisibilityDefaults } from './global-settings-types'
import type { ExternalWorktreeVisibility, Repo } from './repo-types'
export const EXTERNAL_WORKTREE_VISIBILITY_ROLLOUT_AT = Date.UTC(2026, 4, 23)
export const UNKNOWN_EXTERNAL_WORKTREE_PARENT_PATH = 'Unknown location'
function trimRuntimePathTrailingSlash(value: string): string {
if (value === '/' || /^[A-Za-z]:\/$/.test(value)) {
return value
}
return value.replace(/\/+$/, '')
}
export function getExternalWorktreeParentPath(worktreePath: string | undefined): string {
if (!worktreePath) {
return UNKNOWN_EXTERNAL_WORKTREE_PARENT_PATH
}
const normalized = trimRuntimePathTrailingSlash(normalizeRuntimePathSeparators(worktreePath))
if (!normalized) {
return UNKNOWN_EXTERNAL_WORKTREE_PARENT_PATH
}
if (normalized.startsWith('//')) {
const parts = normalized.slice(2).split('/').filter(Boolean)
if (parts.length < 2) {
return UNKNOWN_EXTERNAL_WORKTREE_PARENT_PATH
}
if (parts.length === 2) {
return `//${parts[0]}/${parts[1]}`
}
return `//${parts.slice(0, -1).join('/')}`
}
const lastSeparatorIndex = normalized.lastIndexOf('/')
if (lastSeparatorIndex === -1) {
return UNKNOWN_EXTERNAL_WORKTREE_PARENT_PATH
}
if (lastSeparatorIndex === 0) {
return '/'
}
if (/^[A-Za-z]:\/$/.test(normalized)) {
return normalized
}
if (/^[A-Za-z]:\/[^/]+$/.test(normalized)) {
return `${normalized.slice(0, 2)}/`
}
return normalized.slice(0, lastSeparatorIndex)
}
export function isLegacyRepoForExternalWorktreeVisibility(repo: Repo): boolean {
if (typeof repo.externalWorktreeVisibilityLegacy === 'boolean') {
return repo.externalWorktreeVisibilityLegacy
}
if (repo.externalWorktreeVisibility === undefined) {
return true
}
if (!Number.isFinite(repo.addedAt)) {
return true
}
return repo.addedAt < EXTERNAL_WORKTREE_VISIBILITY_ROLLOUT_AT
}
export function effectiveExternalWorktreeVisibility(
repo: Pick<Repo, 'externalWorktreeVisibility'>,
isLegacyRepoForVisibility: boolean,
defaults?: WorktreeVisibilityDefaults
): ExternalWorktreeVisibility {
if (repo.externalWorktreeVisibility) {
return repo.externalWorktreeVisibility
}
if (defaults?.external === 'show' || defaults?.external === 'hide') {
return defaults.external
}
return isLegacyRepoForVisibility ? 'show' : 'hide'
}
export function normalizeWorktreeVisibilityDefaults(
value: unknown
): WorktreeVisibilityDefaults | undefined {
if (!value || typeof value !== 'object' || Array.isArray(value)) {
return undefined
}
const {
external,
customSources: rawCustomSources,
sourcePreferences: rawSourcePreferences,
...futureDefaults
} = value as WorktreeVisibilityDefaults & Record<string, unknown>
if (external !== 'show' && external !== 'hide') {
return undefined
}
const customSources = normalizeCustomWorktreeVisibilitySources(rawCustomSources)
const sourcePreferences = normalizeWorktreeVisibilitySourcePreferences(rawSourcePreferences)
return {
...futureDefaults,
external,
...(customSources !== undefined ? { customSources } : {}),
...(sourcePreferences !== undefined ? { sourcePreferences } : {})
}
}
export function migrateExternalWorktreeVisibilityDefaults(
repos: readonly Repo[],
value: unknown
): {
repos: Repo[]
defaults: WorktreeVisibilityDefaults
changed: boolean
} {
const defaults = normalizeWorktreeVisibilityDefaults(value)
if (defaults) {
return { repos: [...repos], defaults, changed: false }
}
const migratedRepos = repos.map((repo) => {
if (
repo.kind === 'folder' ||
repo.externalWorktreeVisibility !== undefined ||
!isLegacyRepoForExternalWorktreeVisibility(repo)
) {
return repo
}
return {
...repo,
externalWorktreeVisibility: 'show' as const,
externalWorktreeVisibilityLegacy: true
}
})
return { repos: migratedRepos, defaults: { external: 'hide' }, changed: true }
}
export function effectiveAgentWorktreeVisibility(
repo: Pick<Repo, 'agentWorktreeVisibility'>
): ExternalWorktreeVisibility {
// Legacy repos also default scratch worktrees to hidden.
return repo.agentWorktreeVisibility === 'show' ? 'show' : 'hide'
}