feat(projects): multi-repo projects (port of pingdotgg/t3code#26254)

apps/mobile/modules/t3-native-controls/android/src/main/java/expo/modules/t3nativecontrols/T3WorkspaceNavigationModule.kt

@@ -415,6 +415,7 @@ class T3WorkspaceNavigationView(
   private fun tabTitle(tab: String) = when (tab) {
     "threads" -> "Chats"
     "pullRequests" -> "Pulls"
+    "linear" -> "Linear"
     "usage" -> "Usage"
     else -> "Settings"
   }
@@ -427,6 +428,7 @@ class T3WorkspaceNavigationView(
     when (tab) {
       "threads" -> R.drawable.t3_chats
       "pullRequests" -> R.drawable.t3_pull_requests
+      "linear" -> R.drawable.t3_linear
       "usage" -> R.drawable.t3_usage
       else -> R.drawable.t3_settings
     }

apps/mobile/modules/t3-native-controls/android/src/main/res/drawable/t3_linear.xml

@@ -0,0 +1,3 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:width="24dp" android:height="24dp" android:viewportWidth="24" android:viewportHeight="24">
+  <path android:fillColor="#000000" android:fillType="evenOdd" android:pathData="M12,2A10,10 0 1,0 12,22A10,10 0 1,0 12,2ZM12,4A8,8 0 1,1 12,20A8,8 0 1,1 12,4ZM12,7A5,5 0 1,0 12,17A5,5 0 1,0 12,7Z" />
+</vector>

apps/mobile/modules/t3-native-controls/ios/T3SidebarTabBarView.swift

@@ -99,8 +99,8 @@ final class T3SidebarTabBarView: ExpoView, UITabBarDelegate {
   private func prepareItems() {
     let iconBundle = Bundle(for: Self.self).url(forResource: "T3NativeControlIcons", withExtension: "bundle").flatMap(Bundle.init(url:))
     let pullRequestIcon = UIImage(named: "pull-request", in: iconBundle, compatibleWith: nil)?.withRenderingMode(.alwaysTemplate)
-    let labels = ["threads": "Chats", "pullRequests": "PRs", "usage": "Usage", "settings": "Settings"]
-    let symbols = ["threads": "text.bubble", "usage": "chart.bar.xaxis", "settings": "gearshape"]
+    let labels = ["threads": "Chats", "pullRequests": "PRs", "linear": "Linear", "usage": "Usage", "settings": "Settings"]
+    let symbols = ["threads": "text.bubble", "linear": "circle.inset.filled", "usage": "chart.bar.xaxis", "settings": "gearshape"]
     for (tab, label) in labels {
       let icon = tab == "pullRequests" ? pullRequestIcon : UIImage(systemName: symbols[tab] ?? "circle")
       let item = UITabBarItem(title: nil, image: tabIcon(icon), tag: 0)

apps/mobile/scripts/sync-context-chip-icons.mjs

@@ -32,6 +32,20 @@ if (!skillSvg) {
   );
 }
 
+const linearIconSource = NodeFS.readFileSync(
+  NodePath.join(repositoryRoot, "apps/web/src/components/linear/linearIcons.tsx"),
+  "utf8",
+);
+const linearLogoPath = linearIconSource.match(/LINEAR_LOGO_PATH =\s*"([^"]*)"/)?.[1];
+
+if (!linearLogoPath) {
+  throw new Error(
+    "Could not read LINEAR_LOGO_PATH from apps/web/src/components/linear/linearIcons.tsx",
+  );
+}
+
+const linearSvg = `<svg viewBox="0 0 100 100" fill="currentColor"><path d="${linearLogoPath}"/></svg>`;
+
 const lucideIcons = [
   "circle-dashed",
   "film",
@@ -83,8 +97,9 @@ for (const name of lucideIcons) {
   await renderIcon(name, await lucideSvg(name));
 }
 await renderIcon("skill", skillSvg);
+await renderIcon("linear", linearSvg);
 
-const tokens = [...lucideIcons, "skill"].sort();
+const tokens = [...lucideIcons, "skill", "linear"].sort();
 const generatedSource = `import type { ImageSourcePropType } from "react-native";\n\nexport const CONTEXT_CHIP_ICON_SOURCES = {\n${tokens
   .map(
     (token) =>

apps/mobile/src/App.tsx

@@ -21,6 +21,7 @@ import { pipe } from "effect/Function";
 
 import { RegistryContext } from "@effect/atom-react";
 import { ProjectChipIconRasterizer } from "./native/ProjectChipIconImages";
+import { LinearStatusKeepAlive } from "./features/linear/LinearStatusKeepAlive";
 import { ThreadArrangementHost } from "./features/threads/ThreadArrangementSheet";
 import * as Dialog from "./components/ui/Dialog";
 import { CloudAuthProvider } from "./features/cloud/CloudAuthProvider";
@@ -226,6 +227,7 @@ function AppContent() {
     <>
       <SplashScreenCoordinator />
       <SubscriptionUsageCoordinator />
+      <LinearStatusKeepAlive />
       <GestureHandlerRootView className="flex-1">
         <KeyboardProvider statusBarTranslucent>
           <SafeAreaProvider>

apps/mobile/src/Stack.tsx

@@ -66,6 +66,18 @@ import { GitConfirmSheet } from "./features/threads/git/GitConfirmSheet";
 import { GitOverviewSheet } from "./features/threads/git/GitOverviewSheet";
 import { ThreadPullRequestsSheet } from "./features/threads/ThreadPullRequestsSheet";
 import { ThreadAgentsSheet } from "./features/threads/ThreadAgentsSheet";
+import { PipelineCoordinatorRouteScreen } from "./features/threads/PipelineCoordinatorSheet";
+import { PipelineFeedbackSheet } from "./features/threads/PipelineFeedbackSheet";
+import { LinearIssueRouteScreen } from "./features/linear/LinearIssueRouteScreen";
+import {
+  LinearMilestoneScreen,
+  LinearProjectScreen,
+  LinearTeamScreen,
+} from "./features/linear/LinearLevelScreens";
+import { LinearWorkspaceLinkScreen } from "./features/linear/LinearWorkspaceLinkScreen";
+import { LINEAR_LINK_PATHS } from "./features/linear/linearRoutes";
+import { LinearPipelineSheet } from "./features/linear/LinearPipelineSheet";
+import { LinearProjectPickerSheet } from "./features/linear/LinearProjectPickerSheet";
 import { ThreadBackgroundWorkSheet } from "./features/threads/ThreadBackgroundWorkSheet";
 import { ThreadQueueSheet } from "./features/threads/ThreadQueueControl";
 import {
@@ -111,6 +123,12 @@ import {
   SettingsScheduledTaskNewRouteScreen,
   SettingsScheduledTaskEditRouteScreen,
 } from "./features/settings/SettingsScheduledTasksRouteScreen";
+import {
+  SettingsPipelinesRouteScreen,
+  SettingsPipelineNewRouteScreen,
+  SettingsPipelineEditRouteScreen,
+} from "./features/settings/SettingsPipelinesRouteScreen";
+import { PipelineStepModelPickerRouteScreen } from "./features/settings/PipelinePickerScreens";
 import {
   ScheduledTaskModelPickerRouteScreen,
   ScheduledTaskBranchPickerRouteScreen,
@@ -415,6 +433,35 @@ const SETTINGS_SCREENS = {
           }),
     },
   }),
+  SettingsPipelines: createNativeStackScreen({
+    screen: SettingsPipelinesRouteScreen,
+    linking: "settings/pipelines",
+    options: {
+      ...SETTINGS_PAGE_OPTIONS,
+      title: "Pipelines",
+      headerTitleStyle: { fontSize: 16, fontWeight: "800" },
+    },
+  }),
+  SettingsPipelineNew: createNativeStackScreen({
+    screen: SettingsPipelineNewRouteScreen,
+    options: { ...SETTINGS_PAGE_OPTIONS, title: "New pipeline" },
+  }),
+  SettingsPipelineEdit: createNativeStackScreen({
+    screen: SettingsPipelineEditRouteScreen,
+    options: { ...SETTINGS_PAGE_OPTIONS, title: "Edit pipeline" },
+  }),
+  SettingsPipelineStepModel: createNativeStackScreen({
+    screen: PipelineStepModelPickerRouteScreen,
+    options: {
+      ...SETTINGS_PAGE_OPTIONS,
+      headerShown: false,
+      ...(Platform.OS === "android"
+        ? { presentation: "card" as const }
+        : {
+            ...THREAD_SETTINGS_SHEET_OPTIONS,
+          }),
+    },
+  }),
   SettingsClientStorage: createNativeStackScreen({
     screen: SettingsClientStorageRouteScreen,
     linking: "settings/client-storage",
@@ -721,6 +768,31 @@ const RootStackConfig = createWorkspaceStackNavigator({
         sheetGrabberVisible: true,
       },
     }),
+    LinearWorkspace: createNativeStackScreen({
+      screen: LinearWorkspaceLinkScreen,
+      linking: LINEAR_LINK_PATHS.LinearWorkspace,
+      options: { headerShown: false },
+    }),
+    LinearTeam: createNativeStackScreen({
+      screen: LinearTeamScreen,
+      linking: LINEAR_LINK_PATHS.LinearTeam,
+      options: DETAIL_HEADER_OPTIONS,
+    }),
+    LinearProject: createNativeStackScreen({
+      screen: LinearProjectScreen,
+      linking: LINEAR_LINK_PATHS.LinearProject,
+      options: DETAIL_HEADER_OPTIONS,
+    }),
+    LinearMilestone: createNativeStackScreen({
+      screen: LinearMilestoneScreen,
+      linking: LINEAR_LINK_PATHS.LinearMilestone,
+      options: DETAIL_HEADER_OPTIONS,
+    }),
+    LinearIssue: createNativeStackScreen({
+      screen: LinearIssueRouteScreen,
+      linking: LINEAR_LINK_PATHS.LinearIssue,
+      options: DETAIL_HEADER_OPTIONS,
+    }),
     Thread: createNativeStackScreen({
       screen: ThreadRouteScreen,
       linking: { path: "threads/:environmentId?/:threadId?", alias: ["new/draft"] },
@@ -911,6 +983,41 @@ const RootStackConfig = createWorkspaceStackNavigator({
         sheetGrabberVisible: true,
       },
     }),
+    PipelineCoordinator: createNativeStackScreen({
+      screen: PipelineCoordinatorRouteScreen,
+      options: {
+        ...HORIZONTAL_FORM_SHEET_OPTIONS,
+        headerShown: false,
+        sheetAllowedDetents: formSheetDetents(0.9),
+        sheetGrabberVisible: true,
+      },
+    }),
+    PipelineFeedback: createNativeStackScreen({
+      screen: PipelineFeedbackSheet,
+      options: {
+        ...HORIZONTAL_FORM_SHEET_OPTIONS,
+        sheetAllowedDetents: formSheetDetents(0.7),
+        sheetGrabberVisible: true,
+      },
+    }),
+    LinearProjectPicker: createNativeStackScreen({
+      screen: LinearProjectPickerSheet,
+      options: {
+        ...(Platform.OS === "ios" ? SHEET_GLASS_HEADER_OPTIONS : undefined),
+        ...HORIZONTAL_FORM_SHEET_OPTIONS,
+        sheetAllowedDetents: formSheetDetents(0.6),
+        sheetGrabberVisible: true,
+      },
+    }),
+    LinearPipeline: createNativeStackScreen({
+      screen: LinearPipelineSheet,
+      options: {
+        ...(Platform.OS === "ios" ? SHEET_GLASS_HEADER_OPTIONS : undefined),
+        ...HORIZONTAL_FORM_SHEET_OPTIONS,
+        sheetAllowedDetents: formSheetDetents(0.9),
+        sheetGrabberVisible: true,
+      },
+    }),
     GitOverview: createNativeStackScreen({
       screen: GitOverviewSheet,
       linking: `${THREAD_LINKING_PREFIX}/git`,

apps/mobile/src/components/ComposerContextSheet.tsx

@@ -13,6 +13,7 @@ import type {
 import { formatAttachmentSize } from "@t3tools/client-runtime/state/attachments";
 import { sourceControlClients } from "@t3tools/client-runtime/source-control-clients";
 import { videoMimeType } from "@t3tools/shared/video";
+import type { LinearIssueContextRecord } from "@t3tools/contracts";
 import { Platform, Pressable, ScrollView, View } from "react-native";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
 import { REVIEW_MONO_FONT_FAMILY } from "../features/review/reviewDiffRendering";
@@ -23,6 +24,7 @@ import {
   type DraftComposerAttachment,
 } from "../lib/composerImages";
 import { contextImageGallery } from "../lib/contextImageGallery";
+import { tryOpenWebLink } from "../lib/openExternalUrl";
 import { FilePreviewModal } from "./FilePreviewModal";
 import { VideoPreviewModal } from "./VideoPreviewModal";
 import { ComposerContextAttachment } from "./ComposerContextAttachment";
@@ -75,6 +77,60 @@ function ContextSource(props: { source: ElementContextSource | null }) {
   );
 }
 
+function LinearIssueSnapshot(props: { readonly record: LinearIssueContextRecord }) {
+  const { record } = props;
+  const breadcrumb = [record.teamName, record.projectName, record.milestoneName].filter(
+    (part): part is string => part !== null && part.length > 0,
+  );
+  const meta = [record.stateName, record.priorityLabel, record.assigneeName].filter(
+    (part): part is string => part !== null && part.length > 0,
+  );
+  const excerpt = record.description.trim().slice(0, 600);
+  return (
+    <View className="gap-4">
+      <ContextField label={breadcrumb.join(" › ")} value={`${record.identifier} ${record.title}`} />
+      <ContextField label="Status" value={meta.join(" · ")} />
+      <ContextField label="Labels" value={record.labels.join(", ")} />
+      <ContextField
+        label="Description"
+        value={excerpt.length < record.description.trim().length ? `${excerpt}…` : excerpt}
+      />
+      {record.subIssues.length > 0 ? (
+        <ContextField
+          label={`Sub-issues (${record.subIssues.length})`}
+          value={record.subIssues
+            .slice(0, 5)
+            .map((sub) => `${sub.identifier} ${sub.title}`)
+            .concat(record.subIssues.length > 5 ? [`and ${record.subIssues.length - 5} more`] : [])
+            .join("\n")}
+        />
+      ) : null}
+      {record.comments.length > 0 ? (
+        <ContextField
+          label={`Comments (${record.comments.length})`}
+          value={record.comments
+            .slice(-2)
+            .map(
+              (comment) => `${comment.author ?? "Unknown"}: ${comment.body.trim().slice(0, 200)}`,
+            )
+            .join("\n")}
+        />
+      ) : null}
+      <Text className="text-xs text-foreground-muted">
+        Snapshot taken when attached; later edits in Linear are not included.
+      </Text>
+      {/^https?:\/\//i.test(record.url) ? (
+        <Button
+          label="Open in Linear"
+          tone="secondary"
+          onPress={() => void tryOpenWebLink(record.url, "markdown-link")}
+          fullWidth
+        />
+      ) : null}
+    </View>
+  );
+}
+
 export function ComposerContextSheet(props: {
   readonly label: string;
   readonly record: ComposerContextRecord | undefined;
@@ -324,6 +380,7 @@ export function ComposerContextSheet(props: {
                 ) : null}
               </View>
             ) : null}
+            {record.kind === "linear-issue" ? <LinearIssueSnapshot record={record} /> : null}
             {record.kind === "environment" ? (
               <ContextField label="Machine" value={record.label} />
             ) : null}

apps/mobile/src/connection/environment-cache-store.test.ts

@@ -45,6 +45,7 @@ const SHELL_SNAPSHOT: OrchestrationV2ShellSnapshot = {
       repositoryIdentity: null,
       defaultModelSelection: null,
       scripts: [],
+      trackedFolders: [],
       createdAt: "2026-07-29T12:00:00.000Z",
       updatedAt: "2026-07-29T12:00:00.000Z",
     },

apps/mobile/src/features/home/HomeScreen.tsx

@@ -431,9 +431,11 @@ export function HomeScreen(props: HomeScreenProps) {
     snoozedShelfExpanded,
     workingShelfEnabled,
     workingShelfExpanded,
+    expandedPipelineKeys,
     toggleSettledShelf,
     toggleSnoozedShelf,
     toggleWorkingShelf,
+    togglePipelineExpanded,
   } = useThreadListV2ShelfPreferences();
   const now = useThreadListNow(props.threads);
   const listEnvironments = useAtomValue(threadListEnvironmentsAtom);
@@ -442,6 +444,7 @@ export function HomeScreen(props: HomeScreenProps) {
     machineByEnvironmentId,
     settlementEnvironmentIds,
     snoozeEnvironmentIds,
+    pipelineEnvironmentIds,
     snoozePresetsByEnvironmentId,
     pinningEnvironmentIds,
     autoSettleOptOutEnvironmentIds,
@@ -464,6 +467,7 @@ export function HomeScreen(props: HomeScreenProps) {
     searchQuery: props.searchQuery,
     searchMatches: threadSearchMatchByKey,
     settlementEnvironmentIds,
+    pipelineEnvironmentIds,
     snoozeEnvironmentIds,
     pinReorderEnvironmentIds,
     activeReorderEnvironmentIds,
@@ -476,6 +480,7 @@ export function HomeScreen(props: HomeScreenProps) {
     workingShelfExpanded,
     snoozedShelfExpanded,
     settledShelfExpanded,
+    expandedPipelineKeys,
     selectedThreadKey,
   });
   // Called as `props.onSelectThread(...)`, the compiler would cache this handler on the whole
@@ -575,6 +580,13 @@ export function HomeScreen(props: HomeScreenProps) {
         onNewThreadOnBranch={props.onNewThreadOnBranch}
         thread={thread}
         variant={item.item.variant}
+        nested={item.item.nested}
+        isLastStep={item.item.isLastStep}
+        stepStatus={item.item.stepStatus}
+        stepLabel={item.item.stepLabel}
+        pipelineProgress={item.item.pipelineProgress}
+        pipelineExpanded={item.item.pipelineExpanded}
+        onTogglePipelineSteps={togglePipelineExpanded}
         hasQueuedMessages={item.hasQueuedMessages}
         snoozed={item.item.snoozed}
         pinned={item.item.pinned}

apps/mobile/src/features/home/homeThreadList.test.ts

@@ -17,6 +17,7 @@ function makeProject(
     repositoryIdentity: null,
     defaultModelSelection: null,
     scripts: [],
+    trackedFolders: [],
     createdAt: "2026-06-01T00:00:00.000Z",
     updatedAt: "2026-06-01T00:00:00.000Z",
     ...input,

apps/mobile/src/features/keyboard/CommandPalette.tsx

@@ -332,6 +332,13 @@ export function CommandPalette(props: {
         searchTerms: ["schedule", "automations", "recurring"],
         run: () => openSettings(navigation, "SettingsScheduledTasks"),
       },
+      {
+        key: "pipelines",
+        kind: "action",
+        title: "Pipelines",
+        searchTerms: ["workflow", "steps", "chain"],
+        run: () => openSettings(navigation, "SettingsPipelines"),
+      },
       {
         key: "usage",
         kind: "action",