openplexer 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,195 @@
+# openplexer
+
+Track every coding session across your team in a Notion board. Automatically.
+
+```
+npm install -g openplexer
+```
+
+## The problem
+
+AI coding agents are everywhere now. OpenCode, Claude Code, Codex — you run them in worktrees, in different repos, on different branches. You start a session to fix a bug, another to refactor auth, another to explore an idea. Some finish, some don't. Some need your attention, some are fine.
+
+After a week you have 40+ sessions scattered across your machine with no way to tell which ones matter.
+
+**For solo developers**, it's hard to keep track. You forget about sessions. You don't know which worktree has unfinished work. You resume the wrong one. You lose context.
+
+**For teams**, it's worse. You have no idea what your teammates are working on right now. You can't see if someone already started a session on the bug you're about to fix. There's no shared view of who's doing what, on which branch, in which repo. No way to flag a session as "needs review" or "blocked" or "done — merge it."
+
+## The solution
+
+openplexer runs as a background daemon on your machine. It connects to your coding agents via ACP (Agent Client Protocol), discovers all your sessions, and syncs them to a Notion kanban board — automatically, every 5 seconds.
+
+```
+┌──────────────┐                     ┌──────────────────┐
+│  OpenCode    │◄── ACP (stdio) ────►│                  │
+│  Claude Code │◄── ACP (stdio) ────►│   openplexer     │
+│  Codex       │◄── ACP (stdio) ────►│   (background)   │
+└──────────────┘                     │                  │
+                                     │  syncs every 5s  │
+                                     └────────┬─────────┘
+                                              │
+                                              │ Notion API
+                                              ▼
+                                     ┌──────────────────┐
+                                     │  Notion Board    │
+                                     │  (shared kanban) │
+                                     └──────────────────┘
+```
+
+Each session becomes a card on the board. You can see at a glance:
+
+- **What's in progress** — sessions that are still running or were never finished
+- **What's done** — completed sessions you can archive or review
+- **What needs attention** — sessions you manually flag for follow-up
+- **Who's working on what** — every card is assigned to the person who started it
+- **Which repo and branch** — direct links to the GitHub branch
+- **How to resume** — a ready-to-paste CLI command to pick up where you left off
+
+## Collaborative by default
+
+The board is a shared Notion page. Multiple team members can connect their machines to the same board. Each person's sessions show up automatically, assigned to them.
+
+This means your team gets a single view of all active coding work:
+
+- Alice is refactoring the auth module on `feature/auth-v2` in `acme/backend` — **In Progress**
+- Bob finished the migration script on `fix/db-migrate` in `acme/infra` — **Done**
+- Charlie's session on `acme/frontend` needs review — **Needs Attention**
+
+No standups needed to know what's happening. No Slack messages asking "are you still working on that?" The board is always current because every machine syncs continuously.
+
+Each user controls which repos they sync to the shared board. If you're also hacking on personal side projects, those sessions stay off the shared board — only repos you explicitly select are tracked. This keeps the shared view clean and focused on team work.
+
+## Getting started
+
+Run `openplexer` for the first time and the setup wizard walks you through everything:
+
+**1. Pick your agents**
+
+```
+◆  Which coding agents do you use?
+│  ◼ OpenCode
+│  ◼ Claude Code
+│  ◻ Codex
+```
+
+Select one or more. openplexer connects to each via ACP and merges all sessions into a single board.
+
+**2. Auto-discover repos**
+
+openplexer spawns the ACP server, lists all your sessions, and extracts the git repos from their working directories. No manual configuration needed.
+
+**3. Select repos to track**
+
+```
+◆  Which repos to track?
+│  ◼ * All repos
+│  ◻ acme/backend
+│  ◻ acme/frontend
+│  ◻ acme/infra
+```
+
+Pick specific repos for shared boards (recommended — keeps personal projects off the team board). Or select all if you want everything tracked.
+
+**4. Connect Notion**
+
+Your browser opens to authorize the Notion integration. Select the page where the board should live. No manual API tokens, no copying secrets — just click authorize and you're done.
+
+**5. Board created**
+
+openplexer creates a database inside your selected Notion page with a kanban Board view grouped by status. An example card explains what each field means. Real sessions start appearing within seconds.
+
+**6. Run on login (optional)**
+
+```
+◆  Register openplexer to run on login?
+│  Yes
+```
+
+openplexer registers itself as a startup service so it runs in the background every time you log in. The board stays current without you having to think about it.
+
+## Board properties
+
+Every session card in Notion has these fields:
+
+| Property | Type | Description |
+|---|---|---|
+| **Name** | Title | Session title from the agent |
+| **Status** | Select | `In Progress`, `Done`, `Needs Attention`, `Ignored`, `Not Started` |
+| **Repo** | Select | GitHub repo as `owner/repo` |
+| **Branch** | URL | Link to the branch on GitHub |
+| **Share URL** | URL | Public share link (OpenCode `/share`) |
+| **Resume** | Text | CLI command to resume the session |
+| **Assignee** | People | Notion user who authorized the integration |
+| **Folder** | Text | Local filesystem path |
+| **Discord** | URL | Discord thread link (if using kimaki) |
+| **Updated** | Date | Last update timestamp from the agent |
+| **Session ID** | Text | Internal ACP session identifier |
+
+**Status** is the only field you manage manually. Everything else is synced automatically. Move cards between columns as you triage — mark sessions as done when you're finished, flag ones that need attention, ignore ones you don't care about.
+
+**Resume** gives you the exact command to pick up a session:
+
+```bash
+# OpenCode sessions
+opencode --session ses_abc123
+
+# Claude Code sessions
+claude --resume ses_abc123
+
+# Codex sessions
+codex resume ses_abc123
+```
+
+## CLI commands
+
+```bash
+openplexer              # Start daemon (first run triggers setup wizard)
+openplexer connect      # Add another board
+openplexer status       # Show sync state and session counts
+openplexer boards       # List all configured boards with URLs
+openplexer stop         # Kill the running daemon
+openplexer startup      # Show startup registration status
+openplexer startup enable   # Register to run on login
+openplexer startup disable  # Unregister from login
+```
+
+## Multiple boards
+
+You can connect as many boards as you want. Each board is a separate Notion database with its own repo filter and assignee.
+
+```bash
+openplexer connect
+```
+
+Use cases:
+- **Team board** — shared page, filtered to company repos, everyone connects to it
+- **Personal board** — private page, all repos, just for you
+- **Project board** — scoped to a single repo for focused tracking
+
+## How it works
+
+**ACP protocol** — openplexer spawns each agent's ACP server as a child process and communicates over stdio using the Agent Client Protocol. It lists all sessions with pagination and extracts git repo info from each session's working directory.
+
+**Sync loop** — every 5 seconds, openplexer polls all connected agents for sessions. New sessions get a Notion page created. Existing sessions get their title and timestamp updated. Only sessions created or updated after the board was connected are synced (no backfilling old sessions).
+
+**Single instance** — a lock port (default `29990`) ensures only one daemon runs at a time. Starting a new instance cleanly terminates the old one via SIGTERM, then SIGKILL if needed.
+
+**Notion OAuth** — authentication goes through `openplexer.com` (a Cloudflare Worker). The CLI opens your browser, you authorize, the worker exchanges the code for tokens and stores them in KV with a 5-minute TTL. The CLI polls for the result. No secrets to manage.
+
+**Startup service** — cross-platform registration so openplexer starts automatically:
+- **macOS**: launchd plist at `~/Library/LaunchAgents/com.openplexer.plist`
+- **Linux**: XDG autostart at `~/.config/autostart/openplexer.desktop`
+- **Windows**: registry key at `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`
+
+**Config** — stored at `~/.openplexer/config.json`. Contains the list of agents, board configurations (Notion tokens, database IDs, tracked repos), and a map of synced session IDs to Notion page IDs.
+
+**Rate limiting** — Notion API calls are throttled to ~3/second to stay within rate limits.
+
+## Discord integration
+
+If you use [kimaki](https://kimaki.xyz) to run coding sessions from Discord, openplexer automatically detects the kimaki CLI and adds a Discord thread URL to each session card. This links the Notion board directly to the Discord conversation where the work is happening.
+
+## License
+
+MIT

package/dist/acp-client.d.ts

@@ -1,13 +1,18 @@
-import { ClientSideConnection, type SessionInfo } from '@agentclientprotocol/sdk';
-export type AcpConnection = {
-    connection: ClientSideConnection;
-    client: 'opencode' | 'claude';
+import { type SessionInfo } from '@agentclientprotocol/sdk';
+import type { AcpClient } from './config.ts';
+export type AgentConnection = {
+    client: AcpClient;
+    listSessions: () => Promise<SessionInfo[]>;
     kill: () => void;
 };
-export declare function connectAcp({ client, }: {
-    client: 'opencode' | 'claude';
-}): Promise<AcpConnection>;
+export type AcpConnection = AgentConnection;
+export declare function connectAgent({ client }: {
+    client: AcpClient;
+}): Promise<AgentConnection>;
+export declare function connectAcp({ client }: {
+    client: AcpClient;
+}): Promise<AgentConnection>;
 export declare function listAllSessions({ connection, }: {
-    connection: ClientSideConnection;
+    connection: AgentConnection;
 }): Promise<SessionInfo[]>;
 //# sourceMappingURL=acp-client.d.ts.map

package/dist/acp-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../src/acp-client.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,oBAAoB,EAIpB,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAA;AAkDjC,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,oBAAoB,CAAA;IAChC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAAM,GACP,EAAE;IACD,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAA;CAC9B,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BzB;AAED,wBAAsB,eAAe,CAAC,EACpC,UAAU,GACX,EAAE;IACD,UAAU,EAAE,oBAAoB,CAAA;CACjC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBzB"}
+{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../src/acp-client.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAM5C,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1C,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AAGD,MAAM,MAAM,aAAa,GAAG,eAAe,CAAA;AAiM3C,wBAAsB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAK9F;AAGD,wBAAsB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5F;AAED,wBAAsB,eAAe,CAAC,EACpC,UAAU,GACX,EAAE;IACD,UAAU,EAAE,eAAe,CAAA;CAC5B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAEzB"}

package/dist/acp-client.js

@@ -1,7 +1,88 @@
-// Spawn an ACP agent (opencode or claude) as a child process and connect
-// as a client via stdio. Uses @agentclientprotocol/sdk for the protocol.
+// Connect to coding agents and list their sessions.
+//
+// opencode: spawns `opencode serve` and uses the HTTP API's
+//   /experimental/session endpoint which returns sessions across ALL
+//   projects (Session.listGlobal). The ACP protocol's listSessions
+//   calls Session.list which is scoped to a single project — that's
+//   why we bypass ACP for opencode.
+//
+// claude / codex: uses ACP over stdio (unchanged).
 import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import path from 'node:path';
 import { ClientSideConnection, ndJsonStream, } from '@agentclientprotocol/sdk';
+import { createOpencodeClient } from '@opencode-ai/sdk/v2';
+// ---------------------------------------------------------------------------
+// opencode — HTTP server with /experimental/session (global, all projects)
+// ---------------------------------------------------------------------------
+async function connectOpencode() {
+    const PORT = 18_923;
+    const baseUrl = `http://127.0.0.1:${PORT}`;
+    // Spawn `opencode serve` on a known port. cwd doesn't matter since
+    // we use the global endpoint.
+    const child = spawn('opencode', ['serve', '--port', String(PORT)], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        cwd: '/',
+    });
+    const sdk = createOpencodeClient({ baseUrl });
+    // Wait for the server to be ready (poll until it responds)
+    const deadline = Date.now() + 15_000;
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetch(`${baseUrl}/session?limit=1`);
+            if (res.ok)
+                break;
+        }
+        catch {
+            // server not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    // Verify it's actually up
+    const check = await fetch(`${baseUrl}/session?limit=1`).catch(() => null);
+    if (!check?.ok) {
+        child.kill();
+        throw new Error('opencode serve failed to start');
+    }
+    return {
+        client: 'opencode',
+        listSessions: async () => {
+            const sessions = [];
+            let cursor;
+            // Paginate through /experimental/session which uses Session.listGlobal()
+            // (returns sessions across ALL projects, not scoped to one)
+            while (true) {
+                const result = await sdk.experimental.session.list({
+                    roots: true,
+                    ...(cursor !== undefined && { cursor }),
+                });
+                if (result.error || !result.data) {
+                    throw new Error(`opencode API error: ${result.error}`);
+                }
+                for (const s of result.data) {
+                    sessions.push({
+                        sessionId: s.id,
+                        cwd: s.directory,
+                        title: s.title,
+                        updatedAt: new Date(s.time.updated).toISOString(),
+                    });
+                }
+                // Pagination cursor is in the x-next-cursor response header
+                const nextCursor = result.response.headers.get('x-next-cursor');
+                if (!nextCursor)
+                    break;
+                cursor = Number(nextCursor);
+            }
+            return sessions;
+        },
+        kill: () => {
+            child.kill();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// claude / codex — ACP over stdio
+// ---------------------------------------------------------------------------
 function nodeToWebWritable(nodeStream) {
     return new WritableStream({
         write(chunk) {
@@ -33,9 +114,6 @@ function nodeToWebReadable(nodeStream) {
         },
     });
 }
-// Minimal Client implementation — we only need session listing,
-// not file ops or permissions. requestPermission and sessionUpdate
-// are required by the Client interface.
 class MinimalClient {
     async requestPermission() {
         return { outcome: { outcome: 'cancelled' } };
@@ -48,11 +126,24 @@ class MinimalClient {
         return {};
     }
 }
-export async function connectAcp({ client, }) {
-    const cmd = client === 'opencode' ? 'opencode' : 'claude';
-    const args = ['acp'];
+function resolveAcpBinary(client) {
+    const require = createRequire(import.meta.url);
+    const packageName = client === 'claude'
+        ? '@zed-industries/claude-agent-acp'
+        : '@zed-industries/codex-acp';
+    const binName = client === 'claude' ? 'claude-agent-acp' : 'codex-acp';
+    const pkgJsonPath = require.resolve(`${packageName}/package.json`);
+    const pkgDir = path.dirname(pkgJsonPath);
+    const pkg = require(pkgJsonPath);
+    const binRelative = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin[binName];
+    const binPath = path.resolve(pkgDir, binRelative);
+    return { cmd: process.execPath, args: [binPath] };
+}
+async function connectAcpAgent(client) {
+    const { cmd, args } = resolveAcpBinary(client);
     const child = spawn(cmd, args, {
         stdio: ['pipe', 'pipe', 'inherit'],
+        cwd: '/',
     });
     const stream = ndJsonStream(nodeToWebWritable(child.stdin), nodeToWebReadable(child.stdout));
     const connection = new ClientSideConnection((_agent) => {
@@ -63,26 +154,39 @@ export async function connectAcp({ client, }) {
         clientCapabilities: {},
     });
     return {
-        connection,
         client,
+        listSessions: async () => {
+            const sessions = [];
+            let cursor;
+            while (true) {
+                const response = await connection.listSessions({
+                    ...(cursor ? { cursor } : {}),
+                });
+                sessions.push(...response.sessions);
+                if (!response.nextCursor)
+                    break;
+                cursor = response.nextCursor;
+            }
+            return sessions;
+        },
         kill: () => {
             child.kill();
         },
     };
 }
-export async function listAllSessions({ connection, }) {
-    const sessions = [];
-    let cursor;
-    // Paginate through all sessions
-    while (true) {
-        const response = await connection.listSessions({
-            ...(cursor ? { cursor } : {}),
-        });
-        sessions.push(...response.sessions);
-        if (!response.nextCursor) {
-            break;
-        }
-        cursor = response.nextCursor;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function connectAgent({ client }) {
+    if (client === 'opencode') {
+        return connectOpencode();
     }
-    return sessions;
+    return connectAcpAgent(client);
+}
+// Legacy exports for backwards compat
+export async function connectAcp({ client }) {
+    return connectAgent({ client });
+}
+export async function listAllSessions({ connection, }) {
+    return connection.listSessions();
 }

package/dist/acp-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acp-client.test.d.ts.map

package/dist/acp-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.test.d.ts","sourceRoot":"","sources":["../src/acp-client.test.ts"],"names":[],"mappings":""}

package/dist/acp-client.test.js

@@ -0,0 +1,91 @@
+// Integration test: verifies that opencode returns sessions from
+// multiple different project directories, not just one.
+// This test only runs on machines with opencode installed and real sessions.
+import { describe, it, expect } from 'vitest';
+import { connectAgent } from "./acp-client.js";
+import { getRepoInfo } from "./git.js";
+describe('agent-client', () => {
+    it('listSessions returns sessions from at least 2 different projects', async () => {
+        const agent = await connectAgent({ client: 'opencode' });
+        try {
+            const sessions = await agent.listSessions();
+            // Collect unique cwd values
+            const cwds = [...new Set(sessions.map((s) => s.cwd).filter(Boolean))];
+            console.log(`Found ${sessions.length} sessions across ${cwds.length} directories:`);
+            for (const cwd of cwds) {
+                const count = sessions.filter((s) => s.cwd === cwd).length;
+                console.log(`  ${cwd}: ${count} sessions`);
+            }
+            expect(sessions.length).toBeGreaterThan(0);
+            expect(cwds.length).toBeGreaterThanOrEqual(2);
+        }
+        finally {
+            agent.kill();
+        }
+    }, 30_000);
+    it('debug: show which sessions would pass sync filters', async () => {
+        const connectedAt = '2026-03-21T23:03:40.127Z';
+        const connectedAtMs = new Date(connectedAt).getTime();
+        console.log(`connectedAt: ${connectedAt} (${connectedAtMs})`);
+        console.log(`now:         ${new Date().toISOString()} (${Date.now()})`);
+        console.log();
+        const agent = await connectAgent({ client: 'opencode' });
+        try {
+            const sessions = await agent.listSessions();
+            // Sort by updatedAt descending (most recent first)
+            const sorted = [...sessions].sort((a, b) => {
+                const aMs = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+                const bMs = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+                return bMs - aMs;
+            });
+            // Show the 10 most recent sessions with all their timestamps and filter results
+            console.log('=== 10 most recent sessions ===');
+            for (const session of sorted.slice(0, 10)) {
+                const updatedAt = session.updatedAt || '(none)';
+                const updatedAtMs = session.updatedAt ? new Date(session.updatedAt).getTime() : 0;
+                const passesTimeFilter = updatedAtMs >= connectedAtMs;
+                const hasCwd = !!session.cwd;
+                const repo = hasCwd ? await getRepoInfo({ cwd: session.cwd }) : undefined;
+                console.log(`  session: ${session.sessionId.slice(0, 12)}`);
+                console.log(`    title:     ${(session.title || '(none)').slice(0, 80)}`);
+                console.log(`    cwd:       ${session.cwd || '(none)'}`);
+                console.log(`    updatedAt: ${updatedAt}`);
+                console.log(`    passTime:  ${passesTimeFilter}`);
+                console.log(`    repo:      ${repo ? repo.slug : '(no repo)'}`);
+                console.log();
+            }
+            // Summary: how many pass each filter
+            let noCwd = 0;
+            let tooOld = 0;
+            let noRepo = 0;
+            let wouldSync = 0;
+            for (const session of sessions) {
+                if (!session.cwd) {
+                    noCwd++;
+                    continue;
+                }
+                const updatedAtMs = session.updatedAt ? new Date(session.updatedAt).getTime() : 0;
+                if (updatedAtMs < connectedAtMs) {
+                    tooOld++;
+                    continue;
+                }
+                const repo = await getRepoInfo({ cwd: session.cwd });
+                if (!repo) {
+                    noRepo++;
+                    continue;
+                }
+                wouldSync++;
+            }
+            console.log('=== Summary ===');
+            console.log(`  Total sessions:    ${sessions.length}`);
+            console.log(`  No cwd:            ${noCwd}`);
+            console.log(`  Too old:           ${tooOld}`);
+            console.log(`  No git repo:       ${noRepo}`);
+            console.log(`  Would sync:        ${wouldSync}`);
+            expect(sessions.length).toBeGreaterThan(0);
+        }
+        finally {
+            agent.kill();
+        }
+    }, 120_000);
+});

package/dist/cli.js

@@ -8,9 +8,9 @@ import crypto from 'node:crypto';
 import path from 'node:path';
 import { exec } from 'node:child_process';
 import { readConfig, writeConfig } from "./config.js";
-import { connectAcp, listAllSessions } from "./acp-client.js";
+import { connectAgent } from "./acp-client.js";
 import { getRepoInfo } from "./git.js";
-import { createNotionClient, createBoardDatabase, getRootPages } from "./notion.js";
+import { createNotionClient, createBoardDatabase, createExamplePage, getRootPages } from "./notion.js";
 import { evictExistingInstance, getLockPort, startLockServer } from "./lock.js";
 import { startSyncLoop } from "./sync.js";
 import { enableStartupService, disableStartupService, isStartupServiceEnabled, getServiceLocationDescription, } from "./startup-service.js";
@@ -112,6 +112,7 @@ async function connectFlow() {
             options: [
                 { value: 'opencode', label: 'OpenCode' },
                 { value: 'claude', label: 'Claude Code' },
+                { value: 'codex', label: 'Codex' },
             ],
             required: true,
         });
@@ -129,8 +130,8 @@ async function connectFlow() {
     const connectedClients = [];
     for (const client of config.clients) {
         try {
-            const acp = await connectAcp({ client });
-            const sessions = await listAllSessions({ connection: acp.connection });
+            const acp = await connectAgent({ client });
+            const sessions = await acp.listSessions();
             // Extract unique repos from session cwds
             const cwds = [...new Set(sessions.map((sess) => sess.cwd).filter(Boolean))];
             const repoInfos = await Promise.all(cwds.map((cwd) => getRepoInfo({ cwd })));
@@ -237,11 +238,14 @@ async function connectFlow() {
         }
         return pageChoice;
     })();
-    // Step 6: Create database
+    // Step 6: Create database and seed with an example page
     s.start('Creating board database...');
     const { databaseId } = await createBoardDatabase({ notion, pageId });
+    await createExamplePage({ notion, databaseId });
     s.stop('Board database created');
-    log.success('Open the database in Notion and click "+ Add a view" → Board, grouped by Status.');
+    // Show link to the Notion page so user can open it directly
+    const notionPageUrl = `https://notion.so/${pageId.replace(/-/g, '')}`;
+    log.success(`Board created: ${notionPageUrl}`);
     // Step 7: Save to config
     const board = {
         notionToken: authResult.accessToken,
@@ -274,14 +278,9 @@ async function connectFlow() {
     else {
         log.info(`Already registered at ${getServiceLocationDescription()}`);
     }
-    // Step 9: Spawn daemon in background so syncing starts immediately
-    const { spawn: spawnProcess } = await import('node:child_process');
-    const child = spawnProcess(process.execPath, [openplexerBin], {
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    outro('Board connected! Sync daemon started in background.');
+    outro('Board connected! Starting sync, keep this process running.');
+    // Transition directly into the sync daemon instead of spawning a child
+    await startDaemon(config);
 }
 // --- Daemon ---
 async function startDaemon(config) {
@@ -292,7 +291,7 @@ async function startDaemon(config) {
     const connections = [];
     for (const client of config.clients) {
         try {
-            const acp = await connectAcp({ client });
+            const acp = await connectAgent({ client });
             connections.push(acp);
             console.log(`Connected to ${client} via ACP`);
         }

package/dist/config.d.ts

@@ -21,7 +21,7 @@ export type OpenplexerBoard = {
      *  created or last updated after this time are synced. */
     connectedAt: string;
 };
-export type AcpClient = 'opencode' | 'claude';
+export type AcpClient = 'opencode' | 'claude' | 'codex';
 export type OpenplexerConfig = {
     /** ACP clients to connect to (user may use both opencode and claude) */
     clients: AcpClient[];

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC5B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC;8DAC0D;IAC1D,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAA;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wEAAwE;IACxE,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAKD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,gBAAgB,GAAG,SAAS,CAOzD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAK1D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC5B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC;8DAC0D;IAC1D,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEvD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wEAAwE;IACxE,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,wCAAwC;IACxC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAKD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,gBAAgB,GAAG,SAAS,CAOzD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAK1D"}

package/dist/notion.d.ts

@@ -8,12 +8,6 @@ export declare const STATUS_OPTIONS: ({
 } | {
     name: string;
     color: "green";
-} | {
-    name: string;
-    color: "red";
-} | {
-    name: string;
-    color: "gray";
 })[];
 export type CreateDatabaseResult = {
     databaseId: string;
@@ -34,6 +28,10 @@ export declare function createBoardDatabase({ notion, pageId, }: {
     notion: Client;
     pageId: string;
 }): Promise<CreateDatabaseResult>;
+export declare function createExamplePage({ notion, databaseId, }: {
+    notion: Client;
+    databaseId: string;
+}): Promise<string>;
 export declare function createSessionPage({ notion, databaseId, title, sessionId, status, repoSlug, branchUrl, shareUrl, resumeCommand, assigneeId, folder, discordUrl, updatedAt, }: {
     notion: Client;
     databaseId: string;

package/dist/notion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notion.d.ts","sourceRoot":"","sources":["../src/notion.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;IAM1B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAMD,wBAAsB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6CtF;AAED,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EACN,MAAM,GACP,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuChC;AAED,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,UAAU,EACV,KAAK,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,UAAU,EACV,MAAM,EACN,UAAU,EACV,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgClB;AAED,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAMD,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUzE"}
+{"version":3,"file":"notion.d.ts","sourceRoot":"","sources":["../src/notion.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,eAAO,MAAM,cAAc;;;;;;;;;IAI1B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAMD,wBAAsB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiDtF;AAED,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EACN,MAAM,GACP,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuEhC;AAGD,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,UAAU,GACX,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8GlB;AAED,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,UAAU,EACV,KAAK,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,UAAU,EACV,MAAM,EACN,UAAU,EACV,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgClB;AAED,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAMD,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUzE"}