Migrate or flag Array usage to Twig

charlesvien · charlesvien · commit 65c30a86c547 · 2026-01-23T22:08:00.000-08:00
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -1 +1 @@
-* @PostHog/array
+* @PostHog/twig
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -2,7 +2,7 @@
   "version": "0.2.0",
   "configurations": [
     {
-      "name": "Debug Array (Main Process)",
+      "name": "Debug Twig (Main Process)",
       "type": "node",
       "request": "attach",
       "port": 5858,
@@ -15,11 +15,11 @@
       "remoteRoot": "${workspaceFolder}"
     },
     {
-      "name": "Debug Array (Renderer Process)",
+      "name": "Debug Twig (Renderer Process)",
       "type": "chrome",
       "request": "attach",
       "port": 9222,
-      "webRoot": "${workspaceFolder}/apps/array",
+      "webRoot": "${workspaceFolder}/apps/twig",
       "timeout": 60000,
       "sourceMaps": true,
       "sourceMapPathOverrides": {
@@ -32,10 +32,10 @@
   ],
   "compounds": [
     {
-      "name": "Debug Array (Main + Renderer)",
+      "name": "Debug Twig (Main + Renderer)",
       "configurations": [
-        "Debug Array (Main Process)",
-        "Debug Array (Renderer Process)"
+        "Debug Twig (Main Process)",
+        "Debug Twig (Renderer Process)"
       ],
       "preLaunchTask": "start-dev-with-debug",
       "stopAll": true
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
@@ -38,7 +38,7 @@
     {
       "label": "start-electron-with-debug",
       "type": "shell",
-      "command": "pnpm --filter array start:debug",
+      "command": "pnpm --filter twig start:debug",
       "isBackground": true,
       "problemMatcher": {
         "pattern": {
@@ -56,7 +56,7 @@
       "presentation": {
         "reveal": "always",
         "panel": "dedicated",
-        "group": "array"
+        "group": "twig"
       },
       "options": {
         "env": {
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
@@ -1,8 +1,8 @@
-# Contributing to Array
+# Contributing to Twig
 
 ## Architecture Overview
 
-Array is an Electron app with a React renderer. The main process handles system operations (stateless), while the renderer owns all application state.
+Twig is an Electron app with a React renderer. The main process handles system operations (stateless), while the renderer owns all application state.
 
 ```
 Main Process (Node.js)                      Renderer Process (React)
diff --git a/LICENSE b/LICENSE
@@ -3,7 +3,7 @@ Business Source License 1.1
 Parameters
 
 Licensor: PostHog Inc.
-Licensed Work: Array & Posthog Agent package
+Licensed Work: Twig & Posthog Agent package
 The Licensed Work is © 2025 PostHog Inc.
 
 Change Date: None (the Licensed Work will remain under this License indefinitely unless Licensor specifies otherwise)
diff --git a/README.md b/README.md
@@ -35,12 +35,12 @@ pnpm --filter agent build
 ### Running in Development
 
 ```bash
-# Run both agent (watch mode) and array app in parallel
+# Run both agent (watch mode) and twig app in parallel
 pnpm dev
 
 # Or run them separately:
-pnpm dev:agent   # Run agent in watch mode
-pnpm dev:array   # Run array app
+pnpm dev:agent  # Run agent in watch mode
+pnpm dev:twig   # Run twig app
 ```
 
 ### Mobile App
@@ -80,9 +80,9 @@ pnpm test
 ## Project Structure
 
 ```
-array-monorepo/
+twig-monorepo/
 ├── apps/
-│   ├── array/          # Electron desktop app
+│   ├── twig/          # Electron desktop app
 │   └── mobile/         # React Native mobile app (Expo)
 ├── packages/
 │   └── agent/          # Agent framework
diff --git a/apps/cli/src/commands/auth.ts b/apps/cli/src/commands/auth.ts
@@ -54,7 +54,7 @@ export async function auth(): Promise<void> {
     return;
   }
 
-  message("To submit PRs, Array needs access to GitHub.");
+  message("To submit PRs, Twig needs access to GitHub.");
   blank();
 
   const method = await select("Authenticate via:", [
diff --git a/apps/twig/README.md b/apps/twig/README.md
@@ -1,4 +1,4 @@
-# PostHog - Array
+# PostHog - Twig
 
 The PostHog desktop task manager
 
@@ -70,7 +70,7 @@ You can set these environment variables instead of entering credentials in the a
 ## Project Structure
 
 ```
-array/
+twig/
 ├── src/
 │   ├── main/           # Electron main process
 │   ├── renderer/       # React app
@@ -102,8 +102,8 @@ pnpm make
 
 Output will be in:
 
-- `out/Array-darwin-arm64/Array.app` - Packaged app
-- `out/make/Array-*.dmg` - macOS installer
+- `out/Twig-darwin-arm64/Twig.app` - Packaged app
+- `out/make/Twig-*.dmg` - macOS installer
 - `out/make/zip/` - ZIP archives
 
 **Note:** Native modules for the DMG maker are automatically compiled via the `prePackage` hook. If you need to manually rebuild them, run:
diff --git a/apps/twig/forge.config.ts b/apps/twig/forge.config.ts
@@ -134,7 +134,7 @@ const config: ForgeConfig = {
     name: "Twig",
     executableName: "Twig",
     icon: "./build/app-icon", // Forge adds .icns/.ico/.png based on platform
-    appBundleId: "com.posthog.array",
+    appBundleId: "com.posthog.array", // TODO: Migrate to twig
     appCategoryType: "public.app-category.productivity",
     extraResource: existsSync("build/Assets.car") ? ["build/Assets.car"] : [],
     extendInfo: existsSync("build/Assets.car")
@@ -162,7 +162,7 @@ const config: ForgeConfig = {
         ? {
             "code-sign": {
               "signing-identity": appleCodesignIdentity,
-              identifier: "com.posthog.array",
+              identifier: "com.posthog.array", // TODO: Migrate to twig
             },
           }
         : {}),
diff --git a/apps/twig/index.html b/apps/twig/index.html
@@ -5,7 +5,7 @@
   <meta charset="UTF-8" />
   <link rel="icon" type="image/svg+xml" href="/vite.svg" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Array</title>
+  <title>Twig</title>
 </head>
 
 <body class="bg-dark-bg text-dark-text">
diff --git a/apps/twig/src/constants/oauth.ts b/apps/twig/src/constants/oauth.ts
@@ -5,7 +5,7 @@ export const POSTHOG_EU_CLIENT_ID = "AIvijgMS0dxKEmr5z6odvRd8Pkh5vts3nPTzgzU9";
 export const POSTHOG_DEV_CLIENT_ID = "DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ";
 
 export const OAUTH_SCOPES = [
-  // Array app needs
+  // Twig app needs
   "user:read",
   "project:read",
   "task:write",
diff --git a/apps/twig/src/main/services/transcription-prompts.ts b/apps/twig/src/main/services/transcription-prompts.ts
@@ -5,7 +5,7 @@
  * - Generating concise summaries of transcribed audio
  * - Extracting actionable tasks from conversations
  *
- * Future: Move to user-editable config file (~/.array/prompts.json)
+ * Future: Move to user-editable config file (~/.twig/prompts.json)
  */
 
 export const SUMMARY_PROMPT = `Create a very brief (3-7 words) title that summarizes what this conversation is about.
diff --git a/apps/twig/src/main/trpc/routers/deep-link.ts b/apps/twig/src/main/trpc/routers/deep-link.ts
@@ -13,8 +13,8 @@ const getService = () =>
 export const deepLinkRouter = router({
   /**
    * Subscribe to task link deep link events.
-   * Emits task ID (and optional task run ID) when array://task/{taskId} or
-   * array://task/{taskId}/run/{taskRunId} is opened.
+   * Emits task ID (and optional task run ID) when twig://task/{taskId} or
+   * twig://task/{taskId}/run/{taskRunId} is opened.
    */
   onOpenTask: publicProcedure.subscription(async function* (opts) {
     const service = getService();
diff --git a/apps/twig/src/main/utils/encryption.ts b/apps/twig/src/main/utils/encryption.ts
@@ -4,6 +4,7 @@ import { machineIdSync } from "node-machine-id";
 
 // Key derived from hardware UUID - data only decryptable on this machine
 // No keychain prompts, prevents token theft via cloud sync/backups
+// TODO: Migrate to twig
 const APP_SALT = "array-v1";
 const ENCRYPTION_VERSION = 1;
 
diff --git a/apps/twig/src/renderer/components/ConnectivityPrompt.tsx b/apps/twig/src/renderer/components/ConnectivityPrompt.tsx
@@ -28,7 +28,7 @@ export function ConnectivityPrompt({
           </Flex>
           <Dialog.Description>
             <Text size="2" color="gray">
-              Array requires an internet connection to use AI features. Check
+              Twig requires an internet connection to use AI features. Check
               your connection and try again.
             </Text>
           </Dialog.Description>
diff --git a/apps/twig/src/renderer/components/UpdatePrompt.tsx b/apps/twig/src/renderer/components/UpdatePrompt.tsx
@@ -38,7 +38,7 @@ export function UpdatePrompt() {
       } else if (status.checking === false && status.upToDate) {
         setCheckingForUpdates(false);
         const versionSuffix = status.version ? ` (v${status.version})` : "";
-        setCheckResultMessage(`Array is up to date${versionSuffix}`);
+        setCheckResultMessage(`Twig is up to date${versionSuffix}`);
       } else if (status.checking === false) {
         setCheckingForUpdates(false);
       } else if (status.checking === true) {
@@ -105,7 +105,7 @@ export function UpdatePrompt() {
             <Flex direction="column" gap="3">
               <Dialog.Title className="mb-0">Update ready</Dialog.Title>
               <Dialog.Description>
-                A new version of Array has finished downloading. Restart now to
+                A new version of Twig has finished downloading. Restart now to
                 install it or choose Later to keep working and update next time.
               </Dialog.Description>
               {errorMessage ? (
diff --git a/apps/twig/src/renderer/features/auth/stores/authStore.ts b/apps/twig/src/renderer/features/auth/stores/authStore.ts
@@ -502,6 +502,7 @@ export const useAuthStore = create<AuthState>()(
         },
       }),
       {
+        // TODO: Migrate to twig
         name: "array-auth",
         storage: electronStorage,
         partialize: (state) => ({
diff --git a/apps/twig/src/renderer/features/sessions/stores/sessionStore.ts b/apps/twig/src/renderer/features/sessions/stores/sessionStore.ts
@@ -237,6 +237,7 @@ function subscribeToChannel(taskRunId: string) {
                 type: "notification",
                 timestamp: new Date().toISOString(),
                 notification: {
+                   // TODO: Migrate to twig
                   method: "_array/permission_request",
                   params: {
                     toolCallId: payload.toolCallId,
@@ -333,6 +334,7 @@ function createUserShellExecuteEvent(
     ts: Date.now(),
     message: {
       jsonrpc: "2.0",
+      // TODO: Migrate to twig
       method: "_array/user_shell_execute",
       params: { command, cwd, result },
     },
@@ -358,6 +360,7 @@ function getUserShellExecutesSinceLastPrompt(
 
     if (isJsonRpcRequest(msg) && msg.method === "session/prompt") break;
 
+    // TODO: Migrate to twig
     if (
       isJsonRpcNotification(msg) &&
       msg.method === "_array/user_shell_execute"
@@ -1046,6 +1049,7 @@ const useStore = create<SessionStore>()(
             type: "notification",
             timestamp: new Date().toISOString(),
             notification: {
+              // TODO: Migrate to twig
               method: "_array/user_shell_execute",
               params: { command, cwd, result },
             },
@@ -1107,6 +1111,7 @@ const useStore = create<SessionStore>()(
                 type: "notification",
                 timestamp: new Date().toISOString(),
                 notification: {
+                  // TODO: Migrate to twig
                   method: "_array/permission_response",
                   params: {
                     toolCallId,
@@ -1177,6 +1182,7 @@ const useStore = create<SessionStore>()(
                 type: "notification",
                 timestamp: new Date().toISOString(),
                 notification: {
+                  // TODO: Migrate to twig
                   method: "_array/permission_response",
                   params: {
                     toolCallId,
diff --git a/apps/twig/src/renderer/features/sessions/utils/parseSessionLogs.ts b/apps/twig/src/renderer/features/sessions/utils/parseSessionLogs.ts
@@ -130,9 +130,12 @@ export function findPendingPermissions(
       | Record<string, unknown>
       | undefined;
 
+    // TODO: Migrate to twig
     if (method === "_array/permission_request" && params?.toolCallId) {
       requests.set(params.toolCallId as string, entry);
     }
+
+    // TODO: Migrate to twig
     if (method === "_array/permission_response" && params?.toolCallId) {
       responses.add(params.toolCallId as string);
     }
diff --git a/apps/twig/src/renderer/stores/navigationStore.test.ts b/apps/twig/src/renderer/stores/navigationStore.test.ts
@@ -29,7 +29,7 @@ const mockTask: Task = {
   slug: "test-task",
   title: "Test task",
   description: "Test task description",
-  origin_product: "array",
+  origin_product: "twig",
   created_at: "2024-01-01T00:00:00Z",
   updated_at: "2024-01-01T00:00:00Z",
 };
diff --git a/biome.jsonc b/biome.jsonc
@@ -76,7 +76,7 @@
       }
     },
     {
-      // Disallow console.* in array and agent source code - use logger instead
+      // Disallow console.* in twig and agent source code - use logger instead
       "includes": [
         "apps/twig/src/**/*.ts",
         "apps/twig/src/**/*.tsx",
diff --git a/notes/CLOUD_ARCHITECTURE.md b/notes/CLOUD_ARCHITECTURE.md
@@ -24,7 +24,7 @@ Most cloud agent implementations force you to choose one or the other. The goal
 
 ### Key Goals
 
-1. **Local-first feel** — Edit in Array or your IDE, changes sync automatically
+1. **Local-first feel** — Edit in Twig or your IDE, changes sync automatically
 2. **Survive disconnection** — Close your laptop, agent keeps working
 3. **Seamless resume** — Reconnect and catch up instantly
 4. **Multiple clients** — Laptop, phone, Slack, API—all work
@@ -37,7 +37,7 @@ Most cloud agent implementations force you to choose one or the other. The goal
 ```
 ┌─────────────────────────────────────────────────────────────────────────┐
 │                              CLIENTS                                     │
-│    Array Desktop    │    Slack Bot    │    API    │    Mobile App       │
+│    Twig Desktop    │    Slack Bot    │    API    │    Mobile App       │
 └─────────────────────────────────────────────────────────────────────────┘
                                    │
                                    │ Streamable HTTP (SSE + POST)
@@ -308,9 +308,9 @@ class CloudSessionWorkflow:
 
 ---
 
-## Array Integration
+## Twig Integration
 
-In Array, the `AgentService` (main process) talks to agents through a connection. For cloud mode, we swap the transport without changing the rest of the app.
+In Twig, the `AgentService` (main process) talks to agents through a connection. For cloud mode, we swap the transport without changing the rest of the app.
 
 ```
 Renderer ──tRPC──► AgentService ──► Connection
@@ -335,9 +335,9 @@ interface AgentConnection {
 
 **Key files:**
 
-- `apps/array/src/main/services/agent/service.ts` — AgentService, picks connection type
-- `apps/array/src/main/services/agent/local-connection.ts` — Current ACP/SDK logic (extract)
-- `apps/array/src/main/services/agent/cloud-connection.ts` — New, ~200 lines
+- `apps/twig/src/main/services/agent/service.ts` — AgentService, picks connection type
+- `apps/twig/src/main/services/agent/local-connection.ts` — Current ACP/SDK logic (extract)
+- `apps/twig/src/main/services/agent/cloud-connection.ts` — New, ~200 lines
 
 ---
 
diff --git a/packages/agent/src/posthog-api.ts b/packages/agent/src/posthog-api.ts
@@ -12,13 +12,13 @@ export function getLlmGatewayUrl(posthogHost: string): string {
   const hostname = url.hostname;
 
   if (hostname === "localhost" || hostname === "127.0.0.1") {
-    return `${url.protocol}//localhost:3308/array`;
+    return `${url.protocol}//localhost:3308/twig`;
   }
 
   const regionMatch = hostname.match(/^(us|eu)\.posthog\.com$/);
   const region = regionMatch ? regionMatch[1] : "us";
 
-  return `https://gateway.${region}.posthog.com/array`;
+  return `https://gateway.${region}.posthog.com/twig`;
 }
 
 export class PostHogAPIClient {
diff --git a/packages/agent/src/types.ts b/packages/agent/src/types.ts
@@ -20,7 +20,7 @@ export interface StoredNotification {
  */
 export type StoredEntry = StoredNotification;
 
-// PostHog Task model (matches Array's OpenAPI schema)
+// PostHog Task model (matches Twig's OpenAPI schema)
 export interface Task {
   id: string;
   task_number?: number;
diff --git a/packages/core/src/auth.ts b/packages/core/src/auth.ts
@@ -12,6 +12,7 @@ const AuthStateSchema = z.object({
 
 type AuthState = z.infer<typeof AuthStateSchema>;
 
+// TODO: Migrate to twig
 const AUTH_CONFIG_DIR = ".config/array";
 const AUTH_FILE = "auth.json";
 

Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,7 @@ export async function auth(): Promise<void> {`
`54`	`54`	`return;`
`55`	`55`	`}`
`56`	`56`
`57`		`- message("To submit PRs, Array needs access to GitHub.");`
	`57`	`+ message("To submit PRs, Twig needs access to GitHub.");`
`58`	`58`	`blank();`
`59`	`59`
`60`	`60`	`const method = await select("Authenticate via:", [`