@orderful/droid 0.41.0 → 0.42.0

package/dist/tools/meeting/skills/meeting/references/export-workflow.md

@@ -0,0 +1,87 @@
+# Export Workflow
+
+Full procedure for `/meeting export {title}`.
+
+## E1. Resolve Meeting
+
+1. Use `ToolSearch` to load `mcp__granola__list_meetings`
+2. Call with `time_range: "last_30_days"` to get recent meetings
+3. Fuzzy-match `{title}` against meeting titles
+4. If multiple matches, present list and ask user to pick
+5. If no match, show recent meetings and ask user to clarify
+
+## E2. Get Meeting Data
+
+1. Use `ToolSearch` to load `mcp__granola__get_meetings`
+2. Call with the resolved meeting ID
+3. Extract: title, date, participants, summary
+
+## E3. Resolve Destination
+
+If codex is in current context (user has loaded a codex repo this session):
+- Export to `{codex_repo}/meetings/{date}-{slugified-title}.md`
+- Confirm with user: "Export to codex at meetings/{filename}?"
+
+If no codex in context:
+- Ask: "Where should I export this meeting?"
+- Codex — "Which codex repo?" (list available via `droid config --get repos`)
+- Brain — Export to brain vault as a meeting doc
+- Clipboard — Copy formatted markdown to clipboard
+- Terminal — Just print it here
+
+## E4. Format Document
+
+Generate markdown with this exact frontmatter structure:
+
+    ---
+    title: "{meeting title}"
+    type: meeting
+    source: granola
+    source_url: "https://notes.granola.ai/d/{meeting_id}"
+    date: {YYYY-MM-DD}
+    participants: [{comma-separated names}]
+    exported: {YYYY-MM-DD}
+    ---
+
+    # {meeting title}
+
+    **Date:** {full date and time}
+    **Participants:** {names with roles/orgs if available}
+
+    ## Summary
+
+    {Granola's structured summary from get_meetings}
+
+    ## Key Decisions
+
+    {Extract decisions from the summary, or note "No explicit decisions captured"}
+
+    ## Action Items
+
+    {Extract action items from the summary, or note "No action items captured"}
+
+## E5. Slugification Rules
+
+Convert title to filename slug:
+- Lowercase
+- Replace spaces with hyphens
+- Remove special characters except hyphens
+- Strip leading/trailing hyphens
+- Collapse multiple hyphens
+
+Examples:
+- "[Tech Design Review] Automated Partner Testing" → `automated-partner-testing`
+- "Tyler / Bosun - Partner Testing" → `tyler-bosun-partner-testing`
+- "🌅 Horizon Daily" → `horizon-daily`
+
+Final filename: `{YYYY-MM-DD}-{slug}.md`
+
+## E6. Write File
+
+Write the formatted document to the resolved destination path.
+
+## E7. Confirm
+
+Tell the user:
+- "Exported to: {path}"
+- If codex: suggest committing the new file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/commands/integrations.ts

@@ -399,6 +399,36 @@ export async function integrationsStatusCommand(): Promise<void> {
   }
 
   console.log('');
+
+  // GitHub
+  console.log(chalk.bold('  GitHub'));
+
+  const githubConfigured = getConfigValue('integrations.github.configured');
+
+  if (githubConfigured) {
+    console.log(chalk.green('    CLI: Installed'));
+    console.log(chalk.green('    Status: configured'));
+  } else {
+    console.log(chalk.yellow('    CLI: Not verified'));
+    console.log(chalk.gray('    Run: gh auth login'));
+  }
+
+  console.log('');
+
+  // Granola
+  console.log(chalk.bold('  Granola'));
+
+  const granolaConfigured = getConfigValue('integrations.granola.configured');
+
+  if (granolaConfigured) {
+    console.log(chalk.green('    MCP: Connected'));
+    console.log(chalk.green('    Status: configured'));
+  } else {
+    console.log(chalk.yellow('    MCP: Not yet verified'));
+    console.log(chalk.gray('    Use /mcp to add the Granola server, then verify with a meeting query'));
+  }
+
+  console.log('');
 }
 
 /**

package/src/commands/tui/components/IntegrationsDetails.tsx

@@ -148,6 +148,112 @@ function AtlassianDetails({ isFocused, selectedAction, connected }: { isFocused:
   );
 }
 
+function GithubDetails({ isFocused, selectedAction, connected }: { isFocused: boolean; selectedAction: number; connected: boolean }) {
+  return (
+    <Box flexDirection="column" paddingLeft={2} flexGrow={1}>
+      <Text color={colors.text} bold>GitHub CLI</Text>
+
+      <Box flexDirection="column" marginTop={1}>
+        <Text color={colors.textDim} bold>Status</Text>
+        <Text>
+          <Text color={colors.textDim}>  CLI         </Text>
+          {connected
+            ? <Text color={colors.success}>Installed ✓</Text>
+            : <Text color="#fbbf24">Not detected</Text>}
+        </Text>
+        <Text>
+          <Text color={colors.textDim}>  Auth        </Text>
+          {connected
+            ? <Text color={colors.success}>Authenticated ✓</Text>
+            : <Text color="#fbbf24">Not yet verified</Text>}
+        </Text>
+      </Box>
+
+      <Box flexDirection="column" marginTop={1}>
+        <Text color={colors.textDim}>
+          {connected
+            ? 'Used by codex, tech-design, code-review, share'
+            : 'Run `gh auth login` to connect'}
+        </Text>
+      </Box>
+
+      {isFocused && (
+        <Box marginTop={2} flexDirection="row" gap={2}>
+          <Text
+            backgroundColor={selectedAction === 0 ? colors.primary : undefined}
+            color={selectedAction === 0 ? '#ffffff' : colors.textDim}
+            bold={selectedAction === 0}
+          >
+            {' '}Setup Guide{' '}
+          </Text>
+        </Box>
+      )}
+
+      {isFocused && (
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>enter confirm {'·'} esc back</Text>
+        </Box>
+      )}
+
+      {!isFocused && (
+        <Box marginTop={2}>
+          <Text color={colors.textDim}>press enter for options</Text>
+        </Box>
+      )}
+    </Box>
+  );
+}
+
+function GranolaDetails({ isFocused, selectedAction, connected }: { isFocused: boolean; selectedAction: number; connected: boolean }) {
+  return (
+    <Box flexDirection="column" paddingLeft={2} flexGrow={1}>
+      <Text color={colors.text} bold>Granola</Text>
+
+      <Box flexDirection="column" marginTop={1}>
+        <Text color={colors.textDim} bold>MCP Server</Text>
+        <Text>
+          <Text color={colors.textDim}>  Status  </Text>
+          {connected
+            ? <Text color={colors.success}>Connected ✓</Text>
+            : <Text color="#fbbf24">Not yet verified</Text>}
+        </Text>
+      </Box>
+
+      <Box flexDirection="column" marginTop={1}>
+        <Text color={colors.textDim}>
+          {connected
+            ? 'Meeting notes and transcripts available via MCP'
+            : 'Use /mcp to add the Granola server'}
+        </Text>
+      </Box>
+
+      {isFocused && (
+        <Box marginTop={2} flexDirection="row" gap={2}>
+          <Text
+            backgroundColor={selectedAction === 0 ? colors.primary : undefined}
+            color={selectedAction === 0 ? '#ffffff' : colors.textDim}
+            bold={selectedAction === 0}
+          >
+            {' '}Setup Guide{' '}
+          </Text>
+        </Box>
+      )}
+
+      {isFocused && (
+        <Box marginTop={1}>
+          <Text color={colors.textDim}>enter confirm {'·'} esc back</Text>
+        </Box>
+      )}
+
+      {!isFocused && (
+        <Box marginTop={2}>
+          <Text color={colors.textDim}>press enter for options</Text>
+        </Box>
+      )}
+    </Box>
+  );
+}
+
 export function IntegrationsDetails({
   isFocused,
   selectedAction,
@@ -157,6 +263,14 @@ export function IntegrationsDetails({
     return <AtlassianDetails isFocused={isFocused} selectedAction={selectedAction} connected={integration.connected} />;
   }
 
+  if (integration.id === 'github') {
+    return <GithubDetails isFocused={isFocused} selectedAction={selectedAction} connected={integration.connected} />;
+  }
+
+  if (integration.id === 'granola') {
+    return <GranolaDetails isFocused={isFocused} selectedAction={selectedAction} connected={integration.connected} />;
+  }
+
   // Default: Slack
   return <SlackDetails isFocused={isFocused} selectedAction={selectedAction} />;
 }

package/src/commands/tui.tsx

@@ -15,7 +15,7 @@ import {
   isToolInstalled,
   getToolUpdateStatus,
 } from '../lib/tools';
-import { configExists, loadConfig, getAutoUpdateConfig, getConfigValue } from '../lib/config';
+import { configExists, loadConfig, getAutoUpdateConfig, getConfigValue, setConfigValue } from '../lib/config';
 import { type ConfigOption, type ToolManifest } from '../lib/types';
 import { detectAllPlatforms } from '../lib/platforms';
 import { getVersion } from '../lib/version';
@@ -38,12 +38,20 @@ import { ReposManagementScreen } from './tui/views/ReposManagementScreen';
 import { ReposViewerScreen } from './tui/views/ReposViewerScreen';
 import { useAppUpdate } from './tui/hooks/useAppUpdate';
 import { useToolUpdates } from './tui/hooks/useToolUpdates';
+import { checkGhAuth } from '../integrations/github';
 
 // Module-level variable to store exit message (printed after leaving alternate screen)
 let exitMessage: string | null = null;
 // Module-level variable to store a CLI command to run after TUI exits
 let exitCommand: string[] | null = null;
 
+const INTEGRATION_GUIDE_TITLES: Record<string, string> = {
+  slack: 'Slack Integration Setup',
+  atlassian: 'Atlassian Integration Setup',
+  github: 'GitHub CLI Setup',
+  granola: 'Granola Integration Setup',
+};
+
 // Resolve path to bundled integrations (dist/integrations/ at runtime)
 const __tui_dirname = dirname(fileURLToPath(import.meta.url));
 const INTEGRATIONS_DIR = join(__tui_dirname, '../integrations');
@@ -181,8 +189,20 @@ function App() {
   const integrations = [
     { id: 'slack', name: 'Slack', connected: !!process.env.SLACK_USER_TOKEN },
     { id: 'atlassian', name: 'Atlassian', connected: !!getConfigValue('integrations.atlassian.configured') },
+    { id: 'github', name: 'GitHub', connected: !!getConfigValue('integrations.github.configured') },
+    { id: 'granola', name: 'Granola', connected: !!getConfigValue('integrations.granola.configured') },
   ];
 
+  // Detect GitHub CLI auth on first mount (async, caches to config)
+  useEffect(() => {
+    if (!getConfigValue('integrations.github.configured')) {
+      const isAuthed = checkGhAuth();
+      if (isAuthed) {
+        setConfigValue('integrations.github.configured', true);
+      }
+    }
+  }, []);
+
   useInput(
     (input, key) => {
       if (message) setMessage(null);
@@ -257,6 +277,10 @@ function App() {
             ];
           } else if (currentIntegration?.id === 'atlassian') {
             intActions = [{ id: 'guide' }];
+          } else if (currentIntegration?.id === 'github') {
+            intActions = [{ id: 'guide' }];
+          } else if (currentIntegration?.id === 'granola') {
+            intActions = [{ id: 'guide' }];
           }
 
           const maxIntAction = intActions.length - 1;
@@ -273,9 +297,7 @@ function App() {
               exit();
             } else if (actionId === 'guide') {
               const integrationId = currentIntegration?.id ?? 'slack';
-              const guideTitle = currentIntegration?.id === 'atlassian'
-                ? 'Atlassian Integration Setup'
-                : 'Slack Integration Setup';
+              const guideTitle = INTEGRATION_GUIDE_TITLES[integrationId] ?? `${currentIntegration?.name} Setup`;
               const content = loadIntegrationReference(integrationId, 'setup.md');
               if (content) {
                 setPreviousView('detail');

package/src/integrations/github/index.ts

@@ -0,0 +1,17 @@
+import { spawnSync } from 'child_process';
+
+/**
+ * Check if the GitHub CLI (gh) is installed and authenticated.
+ * Returns true if `gh auth status` exits with code 0.
+ */
+export function checkGhAuth(): boolean {
+  try {
+    const result = spawnSync('gh', ['auth', 'status'], {
+      stdio: 'ignore',
+      timeout: 5000,
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}

package/src/integrations/github/references/setup.md

@@ -0,0 +1,61 @@
+# GitHub CLI Setup
+
+## Overview
+
+The GitHub CLI (`gh`) integration connects droid to GitHub for PR creation, issue management, and repository operations. Several skills depend on it: **codex**, **tech-design**, **code-review**, and **share**.
+
+## Setup
+
+### 1. Install the GitHub CLI
+
+```bash
+brew install gh
+```
+
+### 2. Authenticate
+
+```bash
+gh auth login
+```
+
+Follow the interactive prompts to authenticate with your GitHub account. Choose HTTPS as the preferred protocol.
+
+### 3. Verify
+
+```bash
+gh auth status
+```
+
+You should see your GitHub username and the scopes available. The TUI Integrations tab will show `GitHub ✓` once detection runs.
+
+## How It Works
+
+Unlike Slack (which uses environment variables and OAuth) or Atlassian (which uses MCP), GitHub uses a locally installed CLI binary:
+
+| Aspect | Slack | Atlassian | GitHub |
+|--------|-------|-----------|--------|
+| Auth method | OAuth + env vars | MCP server (managed by Claude Code) | `gh auth login` (local CLI) |
+| Setup | `droid integrations setup slack` | `/mcp` in Claude Code | `brew install gh && gh auth login` |
+| API access | `@slack/web-api` SDK | MCP tool calls (`mcp__claude_ai_Atlassian__*`) | `gh` CLI via Bash |
+| Config flag | `integrations.slack.configured` | `integrations.atlassian.configured` | `integrations.github.configured` |
+
+The `configured` flag is set automatically when the TUI detects a working `gh auth status` — no manual configuration needed.
+
+## Troubleshooting
+
+| Issue | Resolution |
+|-------|------------|
+| `gh: command not found` | Install with `brew install gh` |
+| Not authenticated | Run `gh auth login` and follow prompts |
+| Wrong account | Run `gh auth logout` then `gh auth login` |
+| Scopes missing | Run `gh auth refresh -s <scope>` to add scopes |
+| "Not configured" in TUI | Relaunch the TUI — detection runs on startup |
+
+## Dependent Skills
+
+These skills use `gh` and will fail without it:
+
+- **codex** — Fetches PR metadata and diffs for context
+- **tech-design** — Creates PRs for tech design documents
+- **code-review** — Reads PR details, checks, and comments
+- **share** — Creates PRs and interacts with GitHub APIs

package/src/integrations/granola/references/setup.md

@@ -0,0 +1,54 @@
+# Granola Integration Setup
+
+## Overview
+
+The Granola integration connects droid to your meeting notes, summaries, and transcripts through the Granola MCP server in Claude Code.
+
+## Setup
+
+### 1. Install Granola
+
+Install and sign in to the Granola app first if you have not already.
+
+### 2. Add the Granola MCP Server
+
+In Claude Code, run:
+
+```bash
+/mcp
+```
+
+Select **Granola** and complete the auth flow.
+
+### 3. Verify Connection
+
+Ask Claude to list recent meetings. If successful, droid can use Granola MCP tools and the Integrations tab should show `Granola ✓`.
+
+## Available MCP Tools
+
+Depending on your Granola MCP version, tools may include:
+
+- `list_meetings`
+- `get_meetings`
+- `get_meeting_transcript`
+- `query_granola_meetings`
+
+## How It Works
+
+Granola follows the same integration model as Atlassian: MCP is managed by Claude Code, not by a local CLI.
+
+| Aspect | Granola |
+|--------|---------|
+| Auth method | MCP server via Claude Code |
+| Setup command | `/mcp` |
+| Config flag | `integrations.granola.configured` |
+
+No `droid integrations setup granola` command is required.
+
+## Troubleshooting
+
+| Issue | Resolution |
+|-------|------------|
+| Granola not shown in `/mcp` | Update Claude Code and try again |
+| Not connected in TUI | Re-run `/mcp` and verify with a meeting query |
+| No meetings returned | Confirm the Granola app has synced meetings |

package/src/lib/types.ts

@@ -67,9 +67,19 @@ export interface IntegrationAtlassianConfig {
   configured?: boolean;
 }
 
+export interface IntegrationGithubConfig {
+  configured?: boolean;
+}
+
+export interface IntegrationGranolaConfig {
+  configured?: boolean;
+}
+
 export interface IntegrationsConfig {
   slack?: IntegrationSlackConfig;
   atlassian?: IntegrationAtlassianConfig;
+  github?: IntegrationGithubConfig;
+  granola?: IntegrationGranolaConfig;
 }
 
 export interface DroidConfig {

package/src/tools/meeting/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "droid-meeting",
+  "version": "0.1.0",
+  "description": "Work with meeting notes, summaries, and transcripts. List recent meetings, search content, generate context-aware summaries, export to codex. Backed by Granola MCP.",
+  "author": {
+    "name": "Orderful",
+    "url": "https://github.com/orderful"
+  },
+  "repository": "https://github.com/orderful/droid",
+  "license": "MIT",
+  "keywords": [
+    "droid",
+    "ai",
+    "meeting"
+  ],
+  "skills": [
+    "./skills/meeting/SKILL.md"
+  ],
+  "commands": [
+    "./commands/meeting.md"
+  ]
+}

package/src/tools/meeting/TOOL.yaml

@@ -0,0 +1,15 @@
+name: meeting
+description: "Work with meeting notes, summaries, and transcripts. List recent meetings, search content, generate context-aware summaries, export to codex. Backed by Granola MCP."
+version: 0.1.0
+status: beta
+
+includes:
+  skills:
+    - name: meeting
+      required: true
+  commands:
+    - name: meeting
+      is_alias: false
+  agents: []
+
+dependencies: []

package/src/tools/meeting/commands/meeting.md

@@ -0,0 +1,35 @@
+---
+name: meeting
+description: "Work with meeting notes, summaries, and transcripts"
+argument-hint: "[search {query} | summary {title} | summarize {title} | export {title} | decisions | last week]"
+---
+
+# /meeting
+
+**User invoked:** `/meeting $ARGUMENTS`
+
+**Your task:** Invoke the **meeting skill** with these arguments.
+
+## Examples
+
+- `/meeting` → List recent meetings (this week)
+- `/meeting last week` → List meetings from last week
+- `/meeting search auth decisions` → Search meetings for auth-related decisions
+- `/meeting summary standup` → Quick Granola summary of the standup
+- `/meeting summarize tech design review` → Context-aware summary using transcript
+- `/meeting export partner testing review` → Export meeting to codex
+- `/meeting decisions` → Pull decisions from recent meetings
+
+## Quick Reference
+
+```
+/meeting                        # List this week's meetings
+/meeting last week              # List last week's meetings
+/meeting search {query}         # Natural language search
+/meeting summary {title}        # Quick summary (Granola)
+/meeting summarize {title}      # Deep summary (transcript + context)
+/meeting export {title}         # Export to codex
+/meeting decisions              # Decisions from recent meetings
+```
+
+See the **meeting skill** for complete documentation.

package/src/tools/meeting/skills/meeting/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: meeting
+description: "Work with meeting notes, summaries, and transcripts. Use when user asks about meetings, wants to review notes, search decisions, or export to codex. User prompts like 'what did we discuss today', 'summarise the tech design review', 'export my meeting with Thea to codex'."
+argument-hint: "[search {query} | summary {title} | summarize {title} | export {title} | decisions | last week]"
+allowed-tools: [Read, Write, Edit, Glob, Grep, Bash(droid:*)]
+---
+
+# Meeting Skill
+
+Work with meeting notes, summaries, and transcripts via Granola MCP.
+
+## When to Use
+
+- User asks about what was discussed in a meeting
+- User wants a summary of a specific meeting
+- User wants to search across meeting content for decisions/action items
+- User asks to export meeting notes to codex
+- Natural language like "what did we decide in the partner testing review?", "summarise my meeting with Thea", "what were the action items from today?"
+
+## When NOT to Use
+
+- Calendar scheduling or upcoming events (this is about past meeting content)
+- User is explicitly asking for Granola app features (this skill does not control Granola)
+
+## Prerequisites
+
+Check if Granola MCP is available. Run:
+
+```bash
+droid config --get integrations.granola.configured
+```
+
+If not configured, tell user:
+> "Granola MCP is not connected. Run `/mcp` in Claude Code to add the Granola integration, then try again."
+
+If connected, proceed.
+
+## Commands
+
+| Command | Action |
+|---------|--------|
+| `/meeting` | List recent meetings (this week) |
+| `/meeting last week` | List meetings from last week |
+| `/meeting search {query}` | Natural language search across all meetings |
+| `/meeting summary {title}` | Quick summary from Granola (fast, no context cost) |
+| `/meeting summarize {title}` | Context-aware summary using transcript + loaded project/codex context |
+| `/meeting export {title}` | Export meeting to codex |
+| `/meeting decisions` | Pull decisions from recent meetings |
+
+Natural language is the primary interface. Users should not need these commands. Recognise meeting intent and route accordingly:
+- "what did Calvin say about Mosaic?" → search
+- "summarise the partner testing review" → summary or summarize
+- "export today's standup to codex" → export
+- "what decisions were made this week?" → decisions
+
+## Procedures
+
+### List meetings (`/meeting`, `/meeting last week`)
+
+1. Use `ToolSearch` to load `mcp__granola__list_meetings`
+2. Call with `time_range`: `"this_week"` (default) or `"last_week"`
+3. Present results as a table: title, date, participants
+
+### Search (`/meeting search {query}`)
+
+1. Use `ToolSearch` to load `mcp__granola__query_granola_meetings`
+2. Call with user's query
+3. Preserve citation links in the response
+4. Present the response to the user
+
+### Quick summary (`/meeting summary {title}`)
+
+1. First, list recent meetings to find the meeting ID matching `{title}` (fuzzy match)
+2. Use `ToolSearch` to load `mcp__granola__get_meetings`
+3. Call with the meeting ID
+4. Present the structured summary to the user
+
+### Context-aware summary (`/meeting summarize {title}`)
+
+1. First, list recent meetings to find the meeting ID matching `{title}` (fuzzy match)
+2. Warn user: "This will load the full transcript into context. The meeting was ~{duration}. Proceed, or use `/meeting summary` for a quicker Granola summary?"
+3. If user confirms, use `ToolSearch` to load `mcp__granola__get_meeting_transcript`
+4. Call with the meeting ID
+5. Generate a summary that incorporates any loaded project context, codex knowledge, or brain docs
+6. Alternative: use the Task tool with a subagent to process the transcript in a separate context window, then return a summary
+
+### Decisions (`/meeting decisions`)
+
+1. Use `ToolSearch` to load `mcp__granola__query_granola_meetings`
+2. Call with query: "What decisions were made and what are the action items from recent meetings?"
+3. Preserve citation links in the response
+
+### Export (`/meeting export {title}`)
+
+See `references/export-workflow.md` for the full procedure.
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| Granola MCP not available | Suggest `/mcp` to connect Granola |
+| No meetings found for time range | Suggest a different time range |
+| Meeting title not found | Show recent meetings, ask user to pick |
+| Transcript too large for context | Offer subagent approach or fall back to Granola summary |
+| Codex not in current context (export) | Prompt for destination (see export workflow) |