Skip to content

Personal AI, On Personal Devices

Python

fix: improve Channels tab UX — larger fonts, per-source labels, detailed setup instructions

Jon Saad-Falcon175a13492f7c
diff --git a/frontend/src/pages/AgentsPage.tsx b/frontend/src/pages/AgentsPage.tsx
index c8adeb19..b260ecbb 100644
--- a/frontend/src/pages/AgentsPage.tsx
+++ b/frontend/src/pages/AgentsPage.tsx
@@ -1070,30 +1070,34 @@ function ChannelsTab({ agentId }: { agentId: string }) {
<div style={{
display: 'grid',
gridTemplateColumns: '1fr 1fr',
- gap: 8, marginBottom: 12,
+ gap: 6, marginBottom: 12,
}}>
- {connected.map((c) => (
+ {connected.map((c) => {
+ const meta = SOURCE_CATALOG.find(s => s.connector_id === c.connector_id);
+ const unit = meta?.unitLabel || 'items';
+ return (
<div
key={c.connector_id}
style={{
background: 'var(--color-bg-secondary)',
border: '1px solid #2a5a3a',
- borderRadius: 6, padding: '10px 12px',
+ borderRadius: 6, padding: '12px 14px',
display: 'flex', alignItems: 'center', gap: 8,
}}
>
- <span>{iconMap[c.connector_id] || '\uD83D\uDD17'}</span>
+ <span style={{ fontSize: 20 }}>{iconMap[c.connector_id] || '\uD83D\uDD17'}</span>
<div style={{ flex: 1 }}>
- <div style={{ fontSize: 12, fontWeight: 500 }}>
+ <div style={{ fontSize: 14, fontWeight: 600 }}>
{c.display_name}
</div>
- <div style={{ fontSize: 10, color: '#4ade80' }}>
- {c.chunks.toLocaleString()} chunks
+ <div style={{ fontSize: 12, color: '#4ade80' }}>
+ {c.chunks.toLocaleString()} {unit}
</div>
</div>
<span style={{ color: '#4ade80', fontSize: 12 }}>{'\u2713'}</span>
</div>
- ))}
+ );
+ })}
</div>
)}
@@ -1102,7 +1106,7 @@ function ChannelsTab({ agentId }: { agentId: string }) {
<div style={{
display: 'grid',
gridTemplateColumns: '1fr 1fr',
- gap: 8,
+ gap: 6,
}}>
{notConnected.map((c) => {
const meta = getMeta(c.connector_id);
@@ -1121,7 +1125,7 @@ function ChannelsTab({ agentId }: { agentId: string }) {
>
<div
style={{
- padding: '10px 12px', display: 'flex',
+ padding: '12px 14px', display: 'flex',
alignItems: 'center', gap: 8,
cursor: 'pointer',
}}
@@ -1129,13 +1133,13 @@ function ChannelsTab({ agentId }: { agentId: string }) {
setExpandedId(isExpanded ? null : c.connector_id)
}
>
- <span>{iconMap[c.connector_id] || '\uD83D\uDD17'}</span>
+ <span style={{ fontSize: 20 }}>{iconMap[c.connector_id] || '\uD83D\uDD17'}</span>
<div style={{ flex: 1 }}>
- <div style={{ fontSize: 12, fontWeight: 500,
+ <div style={{ fontSize: 14, fontWeight: 600,
color: 'var(--color-text-secondary)' }}>
{c.display_name}
</div>
- <div style={{ fontSize: 10,
+ <div style={{ fontSize: 12,
color: 'var(--color-text-secondary)' }}>
Not connected
</div>
diff --git a/frontend/src/types/connectors.ts b/frontend/src/types/connectors.ts
index 375f8751..5fadf0fc 100644
--- a/frontend/src/types/connectors.ts
+++ b/frontend/src/types/connectors.ts
@@ -12,6 +12,7 @@ export interface ConnectorMeta {
icon: string;
color: string;
description: string;
+ unitLabel?: string; // "emails", "messages", "meeting notes", "pages", "notes", etc.
steps?: SetupStep[];
inputFields?: Array<{
name: string;
@@ -60,6 +61,7 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Mail',
color: 'text-red-400',
description: 'Email via app password',
+ unitLabel: 'emails',
steps: [
{
label: 'Enable 2-Factor Authentication on your Google account',
@@ -86,6 +88,7 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Hash',
color: 'text-purple-400',
description: 'Channel messages and threads',
+ unitLabel: 'messages',
steps: [
{
label: 'Go to your Slack App settings and copy the Bot User OAuth Token',
@@ -106,6 +109,7 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'FileText',
color: 'text-gray-300',
description: 'Pages and databases',
+ unitLabel: 'pages',
steps: [
{
label: 'Create an internal integration and copy the secret',
@@ -127,6 +131,7 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Mic',
color: 'text-amber-400',
description: 'AI meeting notes',
+ unitLabel: 'meeting notes',
steps: [
{ label: 'Open the Granola desktop app → Settings → API' },
{ label: 'Copy your API key and paste below' },
@@ -143,9 +148,22 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Mail',
color: 'text-red-400',
description: 'Email messages and threads (OAuth)',
+ unitLabel: 'emails',
steps: [
- { label: 'Click "Authorize" to open Google consent screen' },
- { label: 'Grant read-only access to your Gmail' },
+ {
+ label: 'We recommend using Gmail (IMAP) instead — it\'s simpler. Select "Gmail (IMAP)" from the channels list.',
+ },
+ {
+ label: 'If you need OAuth: Go to Google Cloud Console → Enable Gmail API → Create OAuth Client ID',
+ url: 'https://console.cloud.google.com/apis/library/gmail.googleapis.com',
+ urlLabel: 'Enable Gmail API',
+ },
+ {
+ label: 'Copy the Client ID and Client Secret, then paste below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Client ID:Client Secret', type: 'password' },
],
},
{
@@ -156,9 +174,19 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'MessageSquare',
color: 'text-green-400',
description: 'macOS Messages history',
+ unitLabel: 'messages',
steps: [
- { label: 'Open System Settings → Privacy & Security → Full Disk Access' },
- { label: 'Enable access for your terminal app or OpenJarvis' },
+ {
+ label: 'Open System Settings → Privacy & Security → Full Disk Access',
+ url: 'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles',
+ urlLabel: 'Open System Settings',
+ },
+ {
+ label: 'Enable Full Disk Access for your terminal app (Terminal, iTerm, or Warp)',
+ },
+ {
+ label: 'iMessage history will be detected automatically once access is granted',
+ },
],
},
{
@@ -169,8 +197,14 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'FolderOpen',
color: 'text-purple-300',
description: 'Markdown vault',
+ unitLabel: 'notes',
steps: [
- { label: 'Enter the path to your Obsidian vault folder' },
+ {
+ label: 'Find your Obsidian vault folder on your computer. It\'s the folder containing the .obsidian directory.',
+ },
+ {
+ label: 'Paste the full path below (e.g. /Users/you/Documents/MyVault)',
+ },
],
inputFields: [
{ name: 'path', placeholder: '/Users/you/Documents/MyVault', type: 'text' },
@@ -184,8 +218,29 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'FolderOpen',
color: 'text-blue-400',
description: 'Docs, Sheets, and files',
+ unitLabel: 'files',
steps: [
- { label: 'Click "Authorize" to grant read-only access to Google Drive' },
+ {
+ label: 'Go to the Google Cloud Console and create a project (or use an existing one)',
+ url: 'https://console.cloud.google.com/projectcreate',
+ urlLabel: 'Open Google Cloud Console',
+ },
+ {
+ label: 'Enable the Google Drive API for your project',
+ url: 'https://console.cloud.google.com/apis/library/drive.googleapis.com',
+ urlLabel: 'Enable Drive API',
+ },
+ {
+ label: 'Go to Credentials → Create OAuth 2.0 Client ID (choose "Desktop app")',
+ url: 'https://console.cloud.google.com/apis/credentials',
+ urlLabel: 'Open Credentials',
+ },
+ {
+ label: 'Copy the Client ID and Client Secret, then paste them below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Client ID:Client Secret', type: 'password' },
],
},
{
@@ -196,8 +251,29 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Calendar',
color: 'text-blue-400',
description: 'Events and meetings',
+ unitLabel: 'events',
steps: [
- { label: 'Click "Authorize" to grant read-only access to Google Calendar' },
+ {
+ label: 'Go to the Google Cloud Console and create a project (or use an existing one)',
+ url: 'https://console.cloud.google.com/projectcreate',
+ urlLabel: 'Open Google Cloud Console',
+ },
+ {
+ label: 'Enable the Google Calendar API for your project',
+ url: 'https://console.cloud.google.com/apis/library/calendar-json.googleapis.com',
+ urlLabel: 'Enable Calendar API',
+ },
+ {
+ label: 'Go to Credentials → Create OAuth 2.0 Client ID (choose "Desktop app")',
+ url: 'https://console.cloud.google.com/apis/credentials',
+ urlLabel: 'Open Credentials',
+ },
+ {
+ label: 'Copy the Client ID and Client Secret, then paste them below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Client ID:Client Secret', type: 'password' },
],
},
{
@@ -208,8 +284,133 @@ export const SOURCE_CATALOG: ConnectorMeta[] = [
icon: 'Users',
color: 'text-blue-400',
description: 'People and contact info',
+ unitLabel: 'contacts',
+ steps: [
+ {
+ label: 'Go to the Google Cloud Console and create a project (or use an existing one)',
+ url: 'https://console.cloud.google.com/projectcreate',
+ urlLabel: 'Open Google Cloud Console',
+ },
+ {
+ label: 'Enable the People API for your project',
+ url: 'https://console.cloud.google.com/apis/library/people.googleapis.com',
+ urlLabel: 'Enable People API',
+ },
+ {
+ label: 'Go to Credentials → Create OAuth 2.0 Client ID (choose "Desktop app")',
+ url: 'https://console.cloud.google.com/apis/credentials',
+ urlLabel: 'Open Credentials',
+ },
+ {
+ label: 'Copy the Client ID and Client Secret, then paste them below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Client ID:Client Secret', type: 'password' },
+ ],
+ },
+ {
+ connector_id: 'apple_notes',
+ display_name: 'Apple Notes',
+ auth_type: 'local',
+ category: 'documents',
+ icon: 'FileText',
+ color: 'text-yellow-400',
+ description: 'macOS Notes app',
+ unitLabel: 'notes',
steps: [
- { label: 'Click "Authorize" to grant read-only access to Google Contacts' },
+ {
+ label: 'Open System Settings → Privacy & Security → Full Disk Access',
+ url: 'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles',
+ urlLabel: 'Open System Settings',
+ },
+ {
+ label: 'Enable Full Disk Access for your terminal app (Terminal, iTerm, or Warp)',
+ },
+ {
+ label: 'Apple Notes will be detected automatically once access is granted',
+ },
+ ],
+ },
+ {
+ connector_id: 'outlook',
+ display_name: 'Outlook',
+ auth_type: 'oauth',
+ category: 'communication',
+ icon: 'Mail',
+ color: 'text-blue-400',
+ description: 'Microsoft email and calendar',
+ unitLabel: 'emails',
+ steps: [
+ {
+ label: 'Go to the Azure Portal and register a new application',
+ url: 'https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade',
+ urlLabel: 'Open Azure App Registrations',
+ },
+ {
+ label: 'Under API Permissions, add Microsoft Graph → Mail.Read',
+ },
+ {
+ label: 'Create a client secret and paste the Application (client) ID and secret below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Client ID:Client Secret', type: 'password' },
+ ],
+ },
+ {
+ connector_id: 'dropbox',
+ display_name: 'Dropbox',
+ auth_type: 'oauth',
+ category: 'documents',
+ icon: 'FolderOpen',
+ color: 'text-blue-300',
+ description: 'Cloud file storage',
+ unitLabel: 'files',
+ steps: [
+ {
+ label: 'Go to the Dropbox App Console and create a new app',
+ url: 'https://www.dropbox.com/developers/apps/create',
+ urlLabel: 'Open Dropbox App Console',
+ },
+ {
+ label: 'Choose "Scoped access" → "Full Dropbox" → name your app',
+ },
+ {
+ label: 'Under Permissions, enable "files.metadata.read" and "files.content.read"',
+ },
+ {
+ label: 'Go to Settings → Generate an access token and paste it below',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Access token (sl.u...)', type: 'password' },
+ ],
+ },
+ {
+ connector_id: 'whatsapp',
+ display_name: 'WhatsApp',
+ auth_type: 'oauth',
+ category: 'communication',
+ icon: 'MessageSquare',
+ color: 'text-green-400',
+ description: 'WhatsApp messages',
+ unitLabel: 'messages',
+ steps: [
+ {
+ label: 'Go to Meta for Developers and create a WhatsApp Business app',
+ url: 'https://developers.facebook.com/apps/',
+ urlLabel: 'Open Meta Developer Portal',
+ },
+ {
+ label: 'Set up WhatsApp → Get a temporary access token from the API Setup page',
+ },
+ {
+ label: 'Copy your Phone Number ID and Access Token, paste below as "phone_id:token"',
+ },
+ ],
+ inputFields: [
+ { name: 'token', placeholder: 'Phone Number ID:Access Token', type: 'password' },
],
},
];