@orderful/droid 0.40.1 → 0.42.0

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

@@ -1,15 +1,19 @@
 import { Box, Text } from 'ink';
 import { colors } from '../constants';
 
+export interface Integration {
+  id: string;
+  name: string;
+  connected: boolean;
+}
+
 export interface IntegrationsDetailsProps {
   isFocused: boolean;
   selectedAction: number;
+  integration: Integration;
 }
 
-export function IntegrationsDetails({
-  isFocused,
-  selectedAction,
-}: IntegrationsDetailsProps) {
+function SlackDetails({ isFocused, selectedAction }: { isFocused: boolean; selectedAction: number }) {
   const hasToken = !!process.env.SLACK_USER_TOKEN;
   const hasClientId = !!process.env.SLACK_CLIENT_ID;
   const hasClientSecret = !!process.env.SLACK_CLIENT_SECRET;
@@ -93,3 +97,180 @@ export function IntegrationsDetails({
     </Box>
   );
 }
+
+function AtlassianDetails({ isFocused, selectedAction, connected }: { isFocused: boolean; selectedAction: number; connected: boolean }) {
+  return (
+    <Box flexDirection="column" paddingLeft={2} flexGrow={1}>
+      <Text color={colors.text} bold>Atlassian</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
+            ? 'Confluence and Jira available via MCP'
+            : 'Use /share confluence to verify connection'}
+        </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 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,
+  integration,
+}: IntegrationsDetailsProps) {
+  if (integration.id === 'atlassian') {
+    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 } 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');
@@ -177,6 +185,24 @@ function App() {
   // Keep skills for configure view (tools configure via their primary skill)
   const skills = getBundledSkills();
 
+  // Dynamic integrations list
+  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);
@@ -213,7 +239,7 @@ function App() {
           setSelectedAction(0);
         }
         if (key.downArrow) {
-          const maxIndex = activeTab === 'tools' ? tools.length - 1 : activeTab === 'integrations' ? 0 : 0;
+          const maxIndex = activeTab === 'tools' ? tools.length - 1 : activeTab === 'integrations' ? integrations.length - 1 : 0;
           setSelectedIndex((prev) => {
             const newIndex = Math.min(maxIndex, prev + 1);
             // Scroll down if needed
@@ -239,12 +265,24 @@ function App() {
           setSelectedAction(0);
         }
         if (activeTab === 'integrations') {
-          const hasClientCreds = !!process.env.SLACK_CLIENT_ID && !!process.env.SLACK_CLIENT_SECRET;
-          const canRunSetup = hasClientCreds && !process.env.SLACK_USER_TOKEN;
-          const intActions = [
-            ...(canRunSetup ? [{ id: 'setup' }] : []),
-            { id: 'guide' },
-          ];
+          const currentIntegration = integrations[selectedIndex];
+          let intActions: { id: string }[] = [];
+
+          if (currentIntegration?.id === 'slack') {
+            const hasClientCreds = !!process.env.SLACK_CLIENT_ID && !!process.env.SLACK_CLIENT_SECRET;
+            const canRunSetup = hasClientCreds && !process.env.SLACK_USER_TOKEN;
+            intActions = [
+              ...(canRunSetup ? [{ id: 'setup' }] : []),
+              { id: 'guide' },
+            ];
+          } 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;
           if (key.leftArrow) {
             setSelectedAction((prev) => Math.max(0, prev - 1));
@@ -254,14 +292,16 @@ function App() {
           }
           if (key.return) {
             const actionId = intActions[selectedAction]?.id;
-            if (actionId === 'setup') {
+            if (actionId === 'setup' && currentIntegration?.id === 'slack') {
               exitCommand = ['droid', 'integrations', 'setup', 'slack'];
               exit();
             } else if (actionId === 'guide') {
-              const content = loadIntegrationReference('slack', 'setup.md');
+              const integrationId = currentIntegration?.id ?? 'slack';
+              const guideTitle = INTEGRATION_GUIDE_TITLES[integrationId] ?? `${currentIntegration?.name} Setup`;
+              const content = loadIntegrationReference(integrationId, 'setup.md');
               if (content) {
                 setPreviousView('detail');
-                setReadmeContent({ title: 'Slack Integration Setup', content });
+                setReadmeContent({ title: guideTitle, content });
                 setView('readme');
               } else {
                 setMessage({ text: 'Could not load setup guide', type: 'error' });
@@ -612,14 +652,16 @@ function App() {
           )}
 
           {activeTab === 'integrations' && (
-            <Box paddingX={1}>
-              <Text>
-                {selectedIndex === 0 ? <Text color={colors.primary}>{'>'}</Text> : <Text> </Text>}
-                <Text> Slack</Text>
-                {process.env.SLACK_USER_TOKEN
-                  ? <Text color={colors.success}> ✓</Text>
-                  : <Text color={colors.textDim}> ✗</Text>}
-              </Text>
+            <Box flexDirection="column" paddingX={1}>
+              {integrations.map((integration, index) => (
+                <Text key={integration.id}>
+                  {selectedIndex === index ? <Text color={colors.primary}>{'>'}</Text> : <Text> </Text>}
+                  <Text> {integration.name}</Text>
+                  {integration.connected
+                    ? <Text color={colors.success}> ✓</Text>
+                    : <Text color={colors.textDim}> ✗</Text>}
+                </Text>
+              ))}
             </Box>
           )}
 
@@ -658,10 +700,11 @@ function App() {
         />
       )}
 
-      {activeTab === 'integrations' && (
+      {activeTab === 'integrations' && integrations[selectedIndex] && (
         <IntegrationsDetails
           isFocused={view === 'detail'}
           selectedAction={selectedAction}
+          integration={integrations[selectedIndex]}
         />
       )}
 

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

@@ -0,0 +1,59 @@
+# Atlassian Integration Setup
+
+## Overview
+
+The Atlassian integration connects droid to Confluence (and Jira) via the official Atlassian MCP server. This enables the `/share` tool to publish markdown files directly to Confluence pages.
+
+## Setup
+
+### 1. Add the Atlassian MCP Server
+
+In Claude Code, run:
+
+```
+/mcp
+```
+
+Select **Atlassian** from the available MCP servers and follow the authentication prompts. This connects your Atlassian account (Confluence + Jira) to Claude Code.
+
+### 2. Verify Connection
+
+Run `/share confluence` in a Claude Code session. If the connection is working, you'll see a list of available Confluence spaces.
+
+Alternatively, the TUI Integrations tab will show `Atlassian ✓` once the MCP has been used successfully.
+
+## How It Works
+
+Unlike Slack (which uses environment variables and OAuth), Atlassian uses Claude Code's built-in MCP server system:
+
+| Aspect | Slack | Atlassian |
+|--------|-------|-----------|
+| Auth method | OAuth + env vars | MCP server (managed by Claude Code) |
+| Setup | `droid integrations setup slack` | `/mcp` in Claude Code |
+| API access | `@slack/web-api` SDK | MCP tool calls (`mcp__claude_ai_Atlassian__*`) |
+| Config flag | `integrations.slack.configured` | `integrations.atlassian.configured` |
+
+The `configured` flag is set automatically on first successful MCP call — no manual configuration needed.
+
+## Troubleshooting
+
+| Issue | Resolution |
+|-------|------------|
+| MCP not available | Run `/mcp` in Claude Code to add the Atlassian server |
+| No Confluence spaces listed | Check your Atlassian account has Confluence access |
+| Permission errors | Verify your account has edit permissions in the target space |
+| "Not configured" in TUI | Use `/share confluence` once — the flag is set on first success |
+
+## Usage
+
+Once connected, use the `/share` command:
+
+```
+/share confluence                   # Interactive - prompts for file
+/share confluence path/to/file.md   # Share specific file
+```
+
+The share skill handles:
+- Choosing a Confluence space and parent page
+- Creating new pages or updating existing ones
+- Storing the page ID in the file's frontmatter for future updates

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

@@ -63,8 +63,23 @@ export interface IntegrationSlackConfig {
   crosspost_channel?: string;
 }
 
+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.