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 type { GlobalSettings } from './global-settings-types'
import { isNativeChatProviderDisplayedOn } from './native-chat/native-chat-providers'
import {
isNativeChatEnabled,
type NativeChatDefaultSettings
} from './structured-native-chat-launch-route'
import type { ExecutionHostId } from './execution-host'
import type { TuiAgent } from './tui-agent'
import { filterEnabledTuiAgents, TUI_AGENT_AUTO_PICK_ORDER } from './tui-agent-selection'
import type { AgentSessionChatProgram } from './agent-session-agent-availability'
export type HostChatAnswer =
| 'yes'
| 'not-yet-known'
| 'ssh'
| 'wsl'
| 'subfolder'
| 'not-on-host'
| 'no-chats'
export type ChatProgramObservation = AgentSessionChatProgram | 'unlearned'
const chatProgramOffered = (program: ChatProgramObservation) =>
program === 'available' || program === 'installable'
export function orderAgentLaunchPickerAgents(
defaultAgent: TuiAgent | 'blank' | null | undefined,
detected: readonly TuiAgent[],
disabled?: Iterable<unknown> | null
): TuiAgent[] {
const enabled = filterEnabledTuiAgents(detected, disabled)
const ordered = TUI_AGENT_AUTO_PICK_ORDER.filter((agent) => enabled.includes(agent))
return defaultAgent && defaultAgent !== 'blank' && ordered.includes(defaultAgent)
? [defaultAgent, ...ordered.filter((agent) => agent !== defaultAgent)]
: ordered
}
export type ChatUnavailableReason =
| 'check-failed'
| 'not-installed'
| 'ssh'
| 'wsl'
| 'subfolder'
| 'not-on-host'
export type NewTabAgentMenuRow = (
| { kind: 'chat'; agent: TuiAgent }
| { kind: 'chat-unavailable'; agent: TuiAgent; reason: ChatUnavailableReason }
| { kind: 'cli'; agent: TuiAgent; chat?: true }
| { kind: 'terminal'; agent: TuiAgent }
) & { executionHostId?: ExecutionHostId }
export type NewTabAgentMenuSettings = NativeChatDefaultSettings &
Partial<Pick<GlobalSettings, 'defaultTuiAgent' | 'disabledTuiAgents'>>
export function buildNewTabAgentMenuRows(args: {
settings: NewTabAgentMenuSettings | null | undefined
detectedOnHost: readonly TuiAgent[] | null
chatAgents: readonly TuiAgent[]
hostChatAnswer: (agent: TuiAgent) => HostChatAnswer
/** Whether the chat's own program runs there, which for some agents is not their CLI. */
chatProgram: (agent: TuiAgent) => ChatProgramObservation
}): NewTabAgentMenuRow[] {
const { settings } = args
const defaultAgent = settings?.defaultTuiAgent
const installed = filterEnabledTuiAgents(args.detectedOnHost ?? [], settings?.disabledTuiAgents)
if (!isNativeChatEnabled(settings) || args.hostChatAnswer('claude') === 'no-chats') {
return orderAgentLaunchPickerAgents(defaultAgent, installed).map((agent) => ({
kind: 'terminal',
agent
}))
}
const runnable: TuiAgent[] = []
const unavailable = new Map<TuiAgent, ChatUnavailableReason>()
const chatAgents = filterEnabledTuiAgents(args.chatAgents, settings?.disabledTuiAgents)
// An unchosen provider is on wherever its chat program is, whether or not its CLI is.
const canOpen = (agent: TuiAgent): boolean =>
chatProgramOffered(args.chatProgram(agent)) ||
(args.chatProgram(agent) === 'unknown' && installed.includes(agent))
const providedHere = chatAgents.filter(canOpen)
const chatToo = new Set<TuiAgent>()
for (const agent of chatAgents) {
const displayed = isNativeChatProviderDisplayedOn(settings, agent, providedHere)
if (!displayed && (!installed.includes(agent) || !canOpen(agent))) {
continue
}
const answer = args.hostChatAnswer(agent)
if (!displayed) {
if (answer === 'yes') {
chatToo.add(agent)
}
continue
}
const program = args.chatProgram(agent)
if (answer === 'yes' && canOpen(agent)) {
runnable.push(agent)
} else {
unavailable.set(
agent,
answer === 'yes'
? program === 'missing'
? 'not-installed'
: 'check-failed'
: args.detectedOnHost === null
? 'check-failed'
: answer === 'not-yet-known'
? 'check-failed'
: answer === 'no-chats'
? 'not-on-host'
: answer
)
}
}
return [
...orderAgentLaunchPickerAgents(defaultAgent, runnable).map((agent) => ({
kind: 'chat' as const,
agent
})),
...orderAgentLaunchPickerAgents(defaultAgent, [...unavailable.keys()]).map((agent) => ({
kind: 'chat-unavailable' as const,
agent,
reason: unavailable.get(agent) ?? 'not-on-host'
})),
...orderAgentLaunchPickerAgents(
defaultAgent,
installed.filter((agent) => !runnable.includes(agent))
).map((agent) => ({
kind: 'cli' as const,
agent,
...(chatToo.has(agent) ? { chat: true as const } : {})
}))
]
}