trackly-cli 0.1.5 → 0.1.7

package/README.md

@@ -105,37 +105,55 @@ Then use natural language in Claude Code or Cursor:
 | trackly_update_status | Mark jobs as applied, saved, or dismissed |
 | trackly_ask | Natural language job search (20/day) |
 
-## API Key
+## Authentication
 
-For programmatic access without OAuth:
+### Option 1: Google OAuth (recommended)
 
 ```bash
-trackly api-key create --name "my-script"
+trackly login
 ```
 
-Use the generated key with any of these flows:
+Opens your browser for Google sign-in. Tokens are stored locally at `~/.trackly/config.json`.
+
+### Option 2: API Key
+
+If OAuth doesn't work (firewalls, headless servers, CI), use an API key instead:
+
+1. Sign in at [usetrackly.app](https://usetrackly.app)
+2. Go to **Settings → API Keys → Create**
+3. Save the key:
 
 ```bash
-# Save it locally for future commands
 trackly config --api-key trk_xxxxxxxxxxxxxxxxxxxx
+```
+
+Or pass it per-command:
 
-# Use it for one command
+```bash
 trackly --api-key trk_xxxxxxxxxxxxxxxxxxxx jobs --json
+```
+
+Or set it as an environment variable:
 
-# Or use an environment variable
-TRACKLY_API_KEY=trk_xxxxxxxxxxxxxxxxxxxx trackly jobs --json
+```bash
+export TRACKLY_API_KEY=trk_xxxxxxxxxxxxxxxxxxxx
+trackly jobs
 ```
 
-To clear a stored key:
+### Generate a key from the CLI
+
+If you're already logged in via OAuth, you can create a key without visiting the web app:
 
 ```bash
-trackly config --clear-api-key
+trackly api-key create --name "my-script"
+trackly api-key list
 ```
 
-To point the CLI at a different backend:
+### Other config
 
 ```bash
-trackly config --base-url http://127.0.0.1:3000
+trackly config --clear-api-key           # Clear stored API key
+trackly config --base-url http://127.0.0.1:3000  # Point at a different backend
 ```
 
 ## Comparison

package/bin/trackly

@@ -13,13 +13,13 @@ const {
   loadConfig,
   saveConfig,
 } = require('../lib/client');
-const { color, isJSON, outputJobs, outputCompanies, outputStats, outputError } = require('../lib/formatters');
+const { color, isJSON, outputJobs, outputCompanies, outputStats, outputContacts, outputReferralCampaign, outputNetworkBrief, outputCompanyBrief, outputCompanyWorkspace, outputError } = require('../lib/formatters');
 const http = require('http');
 const crypto = require('crypto');
 const { spawnSync } = require('child_process');
 const { version: VERSION } = require('../package.json');
 
-const BOOLEAN_FLAGS = new Set(['help', 'h', 'json', 'version', 'v', 'clear-api-key', 'clear-base-url']);
+const BOOLEAN_FLAGS = new Set(['help', 'h', 'json', 'version', 'v', 'clear-api-key', 'clear-base-url', 'refresh']);
 const VALUE_FLAGS = new Set([
   'api-key',
   'base-url',
@@ -30,11 +30,14 @@ const VALUE_FLAGS = new Set([
   'modality',
   'name',
   'offset',
+  'search',
   'sort',
   'status',
 ]);
-const AUTH_HELP_TEXT =
-  'Not authenticated. Run: trackly login or configure an API key with `trackly config --api-key <key>`';
+const AUTH_HELP_TEXT = `Not authenticated.
+  Option 1: trackly login                        (Google OAuth)
+  Option 2: trackly config --api-key trk_xxx     (get key at usetrackly.app)
+  Option 3: TRACKLY_API_KEY=trk_xxx trackly ...  (environment variable)`;
 const STATUS_LABELS = {
   applied: 'applied',
   saved: 'saved',
@@ -183,76 +186,111 @@ function getPublicConfig() {
 // -- Commands --
 
 async function cmdLogin() {
-  const port = 19847 + Math.floor(Math.random() * 1000);
   const baseUrl = getBaseUrl();
   const state = crypto.randomBytes(16).toString('hex');
 
   console.log(color('cyan', 'Opening browser for Google login...'));
-  console.log(color('dim', `Callback server on port ${port}`));
-
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    let timeoutId = null;
-
-    const server = http.createServer((req, res) => {
-      const url = new URL(req.url, `http://localhost:${port}`);
-      if (url.pathname === '/callback') {
-        const returnedState = url.searchParams.get('state');
-        if (returnedState !== state) {
-          res.writeHead(403, { 'Content-Type': 'text/html' });
-          res.end('<html><body><h2>Login failed. Invalid state parameter (possible CSRF).</h2></body></html>');
-          settle(new Error('CSRF state mismatch'));
-          return;
-        }
 
-        const token = url.searchParams.get('token');
-        const refreshToken = url.searchParams.get('refreshToken');
-        if (token) {
-          saveConfig({ ...loadConfig(), token, refreshToken, baseUrl });
-          res.writeHead(200, { 'Content-Type': 'text/html' });
-          res.end('<html><body><h2>Logged in! You can close this tab.</h2><script>window.close()</script></body></html>');
-          console.log(color('green', 'Login successful!'));
-          settle();
+  function tryLogin(port) {
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      let timeoutId = null;
+
+      const server = http.createServer((req, res) => {
+        const url = new URL(req.url, `http://localhost:${port}`);
+        if (url.pathname === '/callback') {
+          const returnedState = url.searchParams.get('state');
+          if (returnedState !== state) {
+            res.writeHead(403, { 'Content-Type': 'text/html' });
+            res.end('<html><body><h2>Login failed. Invalid state parameter (possible CSRF).</h2></body></html>');
+            settle(new Error('CSRF state mismatch'));
+            return;
+          }
+
+          const token = url.searchParams.get('token');
+          const refreshToken = url.searchParams.get('refreshToken');
+          if (token) {
+            const config = loadConfig();
+            const hadApiKey = Boolean(config.apiKey);
+            delete config.apiKey;
+            saveConfig({ ...config, token, refreshToken, baseUrl });
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end('<html><body><h2>Logged in! You can close this tab.</h2><script>window.close()</script></body></html>');
+            console.log(color('green', 'Login successful!'));
+            if (hadApiKey) {
+              console.log('Switched to OAuth. Stored API key cleared.');
+            }
+            settle();
+          } else {
+            res.writeHead(400, { 'Content-Type': 'text/html' });
+            res.end('<html><body><h2>Login failed. No token received.</h2></body></html>');
+            settle(new Error('No token received'));
+          }
         } else {
-          res.writeHead(400, { 'Content-Type': 'text/html' });
-          res.end('<html><body><h2>Login failed. No token received.</h2></body></html>');
-          settle(new Error('No token received'));
+          res.writeHead(404);
+          res.end();
+        }
+      });
+
+      const settle = (error = null) => {
+        if (settled) return;
+        settled = true;
+        if (timeoutId) clearTimeout(timeoutId);
+
+        const finish = () => {
+          if (error) {
+            console.log('\nLogin failed. Try API key auth instead:');
+            console.log('  1. Sign in at https://usetrackly.app');
+            console.log('  2. Go to Settings → API Keys → Create');
+            console.log('  3. Run: trackly config --api-key <your-key>');
+            reject(error);
+          } else {
+            resolve();
+          }
+        };
+
+        if (server.listening) {
+          server.close(finish);
+        } else {
+          finish();
         }
-      } else {
-        res.writeHead(404);
-        res.end();
-      }
-    });
-
-    const settle = (error = null) => {
-      if (settled) return;
-      settled = true;
-      if (timeoutId) clearTimeout(timeoutId);
-
-      const finish = () => {
-        if (error) reject(error);
-        else resolve();
       };
 
-      if (server.listening) {
-        server.close(finish);
-      } else {
-        finish();
-      }
-    };
+      server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+          reject(err);
+        } else {
+          settle(err);
+        }
+      });
 
-    server.on('error', settle);
-    server.listen(port, '127.0.0.1', () => {
-      const loginUrl = `${baseUrl}/auth/google/cli?port=${port}&state=${state}`;
-      if (!openExternalUrl(loginUrl)) {
-        console.log(`Open this URL in your browser:\n${loginUrl}`);
-      }
+      server.listen(port, '127.0.0.1', () => {
+        console.log(color('dim', `Callback server on port ${port}`));
+        const loginUrl = `${baseUrl}/auth/google/cli?port=${port}&state=${state}`;
+        if (!openExternalUrl(loginUrl)) {
+          console.log(`Open this URL in your browser:\n${loginUrl}`);
+        }
+      });
+
+      timeoutId = setTimeout(() => {
+        settle(new Error('Login timed out'));
+      }, 300000);
     });
+  }
 
-    timeoutId = setTimeout(() => {
-      settle(new Error('Login timed out'));
-    }, 120000);
-  });
+  const MAX_PORT_RETRIES = 3;
+  for (let attempt = 0; attempt < MAX_PORT_RETRIES; attempt++) {
+    const port = 19847 + Math.floor(Math.random() * 1000);
+    try {
+      return await tryLogin(port);
+    } catch (err) {
+      if (err.code === 'EADDRINUSE' && attempt < MAX_PORT_RETRIES - 1) {
+        console.log(color('dim', `Port ${port} in use, trying another...`));
+        continue;
+      }
+      throw err;
+    }
+  }
 }
 
 async function cmdLogout() {
@@ -447,6 +485,109 @@ async function cmdApiKey(args) {
   }
 }
 
+async function cmdContacts(args) {
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  const params = new URLSearchParams();
+  const searchQuery = args.search || args._.join(' ').trim();
+  if (searchQuery) params.set('search', searchQuery);
+  if (args.limit) params.set('limit', args.limit);
+  if (args.offset) params.set('offset', args.offset);
+
+  const qs = params.toString();
+  try {
+    const result = await apiRequest('GET', `/api/network/people${qs ? '?' + qs : ''}`);
+    outputContacts(result.contacts || result.people || result.data || []);
+    if (!isJSON() && result.total) {
+      console.log(color('dim', `Showing ${(result.contacts || result.people || result.data || []).length} of ${result.total} contacts`));
+    }
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to fetch contacts');
+  }
+}
+
+async function cmdReferralStart(args) {
+  const id = parseJobId(args._[0]);
+  if (id === null) failNow('Job ID must be a positive integer. Usage: trackly referral start <id>');
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  try {
+    const result = await apiRequest('POST', `/api/network/jobs/${id}/referral-campaign`);
+    if (isJSON()) return printJson(result);
+    outputReferralCampaign(result.campaign || result);
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to start referral campaign');
+  }
+}
+
+async function cmdReferralStatus(args) {
+  const id = parseJobId(args._[0]);
+  if (id === null) failNow('Job ID must be a positive integer. Usage: trackly referral status <id>');
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  try {
+    const result = await apiRequest('GET', `/api/network/jobs/${id}/referral-campaign`);
+    if (isJSON()) return printJson(result);
+    outputReferralCampaign(result.campaign || result);
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to fetch referral campaign status');
+  }
+}
+
+async function cmdBrief(args) {
+  const id = parseJobId(args._[0]);
+  if (id === null) failNow('Job ID must be a positive integer. Usage: trackly brief <id>');
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  try {
+    const result = await apiRequest('GET', `/api/jobscout/jobs/${id}/network-brief`);
+    if (isJSON()) return printJson(result);
+    outputNetworkBrief(result.brief || result);
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to fetch network brief');
+  }
+}
+
+async function cmdCompanyBrief(args) {
+  const id = parseJobId(args._[0]);
+  if (id === null) failNow('Company ID must be a positive integer. Usage: trackly company-brief <companyId> [--refresh]');
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  try {
+    if (args.refresh) {
+      const result = await apiRequest('POST', `/api/network/companies/${id}/brief/refresh`);
+      if (isJSON()) return printJson(result);
+      console.log(color('green', 'Company brief refresh triggered.'));
+      outputCompanyBrief(result.brief || result);
+    } else {
+      const result = await apiRequest('GET', `/api/network/companies/${id}/brief`);
+      if (isJSON()) return printJson(result);
+      const brief = result.brief || result;
+      if (!brief || (typeof brief === 'object' && Object.keys(brief).length === 0)) {
+        console.log(color('dim', 'No brief available. Use --refresh to generate.'));
+      } else {
+        outputCompanyBrief(brief);
+      }
+    }
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to fetch company brief');
+  }
+}
+
+async function cmdCompanyWorkspace(args) {
+  const id = parseJobId(args._[0]);
+  if (id === null) failNow('Company ID must be a positive integer. Usage: trackly company-workspace <companyId>');
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  try {
+    const result = await apiRequest('GET', `/api/network/companies/${id}/workspace`);
+    if (isJSON()) return printJson(result);
+    outputCompanyWorkspace(result.workspace || result);
+  } catch (e) {
+    setErrorExit(e.error || e.message || 'Failed to fetch company workspace');
+  }
+}
+
 async function cmdConfig(args) {
   if (args['api-key'] === null) failNow('API key value required. Usage: trackly config --api-key <key>');
   if (args['base-url'] === null) failNow('Base URL value required. Usage: trackly config --base-url <url>');
@@ -467,9 +608,19 @@ async function cmdConfig(args) {
   }
 
   if (args['api-key'] !== undefined) {
-    config.apiKey = String(args['api-key']).trim();
+    const keyValue = String(args['api-key']).trim();
+    if (!keyValue.startsWith('trk_') || keyValue.length < 10) {
+      console.log(color('yellow', 'Warning: API key does not look like a Trackly key (expected trk_... prefix). Saving anyway.'));
+    }
+    const hadToken = Boolean(config.token);
+    config.apiKey = keyValue;
+    delete config.token;
+    delete config.refreshToken;
     updated = true;
-    console.log(color('green', 'API key saved. It will take precedence over OAuth tokens.'));
+    console.log(color('green', 'API key saved.'));
+    if (hadToken) {
+      console.log('Switched to API key auth. OAuth token cleared.');
+    }
   }
 
   if (args['base-url'] !== undefined) {
@@ -528,6 +679,13 @@ ${color('bold', 'Commands:')}
   ${color('cyan', 'save <id>')}            Save a job
   ${color('cyan', 'dismiss <id>')}         Dismiss a job
   ${color('cyan', 'ask "query"')}          Natural language job search (20/day)
+  ${color('cyan', 'contacts')}             List your contacts (--search, --limit, --offset)
+  ${color('cyan', 'contacts search <q>')} Search contacts by name, company, or title
+  ${color('cyan', 'referral start <id>')} Start a referral campaign for a job
+  ${color('cyan', 'referral status <id>')} Check referral campaign progress
+  ${color('cyan', 'brief <id>')}           Get network brief for a job
+  ${color('cyan', 'company-brief <id>')}   Get company brief (--refresh to generate)
+  ${color('cyan', 'company-workspace <id>')} Show company workspace (jobs, contacts, campaigns)
   ${color('cyan', 'api-key create')}       Generate an API key
   ${color('cyan', 'api-key list')}         List your API keys
   ${color('cyan', 'config')}               Show or update CLI config (--api-key, --base-url)
@@ -624,6 +782,31 @@ async function main() {
     case 'ask':
       await cmdAsk(args);
       break;
+    case 'contacts':
+      if (args._[0] === 'search') {
+        await cmdContacts({ ...args, _: [], search: args._.slice(1).join(' ') });
+      } else {
+        await cmdContacts(args);
+      }
+      break;
+    case 'referral':
+      if (args._[0] === 'start') {
+        await cmdReferralStart({ ...args, _: args._.slice(1) });
+      } else if (args._[0] === 'status') {
+        await cmdReferralStatus({ ...args, _: args._.slice(1) });
+      } else {
+        failNow('Unknown referral subcommand. Use: trackly referral start <id> | trackly referral status <id>');
+      }
+      break;
+    case 'brief':
+      await cmdBrief(args);
+      break;
+    case 'company-brief':
+      await cmdCompanyBrief(args);
+      break;
+    case 'company-workspace':
+      await cmdCompanyWorkspace(args);
+      break;
     case 'api-key':
       await cmdApiKey(args);
       break;

package/docs/trackly-tools.md

@@ -59,6 +59,9 @@ You can also pass `TRACKLY_API_KEY` as an environment variable for one-off runs.
 - **trackly_get_stats** — Job tracker metrics dashboard
 - **trackly_update_status** — Mark a job as applied, saved, or dismissed
 - **trackly_ask** — Natural language job search (20/day limit)
+- **trackly_get_job_brief** — Get network brief for a job (company signal, top contact, actions)
+- **trackly_contacts_at_company** — Search contacts at a specific company
+- **trackly_get_company_workspace** — Get full company workspace (jobs, contacts, hiring managers, campaigns)
 
 ### Example Prompts
 

package/lib/client.js

@@ -68,7 +68,7 @@ function getBaseUrl() {
 }
 
 function getApiKey() {
-  return process.env.TRACKLY_API_KEY || loadConfig().apiKey || null;
+  return (process.env.TRACKLY_API_KEY || loadConfig().apiKey || '').trim() || null;
 }
 
 function getToken() {

package/lib/formatters.js

@@ -14,6 +14,24 @@ function isJSON() {
   return !process.stdout.isTTY || process.argv.includes('--json');
 }
 
+function formatFundingLine(company) {
+  if (!company) return null;
+  const parts = [];
+  const series = company.fundingSeries || company.fundingStage;
+  if (series) {
+    let badge = series;
+    if (company.valuationMillions) {
+      const val = company.valuationMillions;
+      badge += ` · ${val >= 1000 ? `$${(val / 1000).toFixed(val >= 10000 ? 0 : 1)}B` : `$${val.toFixed(0)}M`}`;
+    }
+    parts.push(badge);
+  }
+  if (company.fundingStage && company.fundingSeries) {
+    parts.push(company.fundingStage);
+  }
+  return parts.length > 0 ? parts.join(' | ') : null;
+}
+
 function outputJobs(jobs) {
   if (isJSON()) return console.log(JSON.stringify(jobs, null, 2));
   if (!jobs || jobs.length === 0) {
@@ -25,6 +43,8 @@ function outputJobs(jobs) {
     const location = job.location ? color('dim', job.location) : '';
     console.log(`${color('bold', job.title)} ${modality}`);
     console.log(`  ${color('blue', job.company_name)} | ${location}`);
+    const fundingLine = formatFundingLine(job.company);
+    if (fundingLine) console.log(`  ${color('magenta', fundingLine)}`);
     console.log(`  ID: ${color('dim', job.id)} | Posted: ${color('dim', job.posted_at || job.first_seen_at || 'unknown')}`);
     if (job.url) console.log(`  ${color('dim', job.url)}`);
     console.log();
@@ -61,8 +81,240 @@ function outputStats(stats) {
   }
 }
 
+function outputContacts(contacts) {
+  if (isJSON()) return console.log(JSON.stringify(contacts, null, 2));
+  if (!contacts || contacts.length === 0) {
+    console.log(color('dim', 'No contacts found.'));
+    return;
+  }
+  // Header
+  console.log(
+    color('bold', padRight('Name', 24)) + ' ' +
+    color('bold', padRight('Title', 28)) + ' ' +
+    color('bold', padRight('Company', 20)) + ' ' +
+    color('bold', padRight('Email', 28)) + ' ' +
+    color('bold', 'Status')
+  );
+  console.log(color('dim', '-'.repeat(110)));
+  for (const contact of contacts) {
+    const name = padRight(contact.name || '', 24);
+    const title = padRight(contact.title || '', 28);
+    const company = padRight(contact.company || '', 20);
+    const email = padRight(contact.email || '', 28);
+    const status = contact.status || '';
+    const statusColor = status === 'active' ? 'green' : status === 'pending' ? 'yellow' : 'dim';
+    console.log(
+      `${name} ${title} ${company} ${email} ${color(statusColor, status)}`
+    );
+  }
+}
+
+function outputReferralCampaign(campaign) {
+  if (isJSON()) return console.log(JSON.stringify(campaign, null, 2));
+  if (!campaign) {
+    console.log(color('dim', 'No campaign data.'));
+    return;
+  }
+  console.log(color('bold', 'Referral Campaign'));
+  console.log();
+  if (campaign.id) console.log(`Campaign ID: ${color('cyan', campaign.id)}`);
+  if (campaign.jobId) console.log(`Job ID: ${color('dim', campaign.jobId)}`);
+  if (campaign.status) {
+    const statusColor = campaign.status === 'active' ? 'green' : campaign.status === 'completed' ? 'blue' : 'yellow';
+    console.log(`Status: ${color(statusColor, campaign.status)}`);
+  }
+  if (campaign.createdAt) console.log(`Created: ${color('dim', campaign.createdAt)}`);
+  if (campaign.company) console.log(`Company: ${color('blue', campaign.company)}`);
+  if (campaign.jobTitle) console.log(`Job: ${color('bold', campaign.jobTitle)}`);
+
+  if (campaign.contacts && campaign.contacts.length > 0) {
+    console.log();
+    console.log(color('bold', 'Outreach Progress:'));
+    for (const c of campaign.contacts) {
+      const icon = c.status === 'sent' ? color('green', '[sent]') :
+                   c.status === 'replied' ? color('cyan', '[replied]') :
+                   c.status === 'pending' ? color('yellow', '[pending]') :
+                   color('dim', `[${c.status || 'unknown'}]`);
+      console.log(`  ${icon} ${c.name || 'Unknown'}${c.title ? ' — ' + color('dim', c.title) : ''}`);
+    }
+  }
+
+  // Print any other top-level keys
+  for (const [k, v] of Object.entries(campaign)) {
+    if (!['id', 'jobId', 'status', 'createdAt', 'company', 'jobTitle', 'contacts'].includes(k)) {
+      console.log(`${k}: ${color('dim', JSON.stringify(v))}`);
+    }
+  }
+}
+
+function outputNetworkBrief(brief) {
+  if (isJSON()) return console.log(JSON.stringify(brief, null, 2));
+  if (!brief) {
+    console.log(color('dim', 'No network brief available.'));
+    return;
+  }
+  console.log(color('bold', 'Network Brief'));
+  console.log();
+
+  if (brief.companySignal) {
+    console.log(color('bold', 'Company Signal:'));
+    console.log(`  ${brief.companySignal}`);
+    console.log();
+  }
+
+  if (brief.recommendedMotion) {
+    console.log(color('bold', 'Recommended Motion:'));
+    console.log(`  ${color('cyan', brief.recommendedMotion)}`);
+    console.log();
+  }
+
+  if (brief.topContact) {
+    console.log(color('bold', 'Top Contact:'));
+    const tc = brief.topContact;
+    if (tc.name) console.log(`  Name: ${tc.name}`);
+    if (tc.title) console.log(`  Title: ${color('dim', tc.title)}`);
+    if (tc.company) console.log(`  Company: ${color('blue', tc.company)}`);
+    if (tc.email) console.log(`  Email: ${color('cyan', tc.email)}`);
+    if (tc.reason) console.log(`  Why: ${color('dim', tc.reason)}`);
+    console.log();
+  }
+
+  if (brief.actions && brief.actions.length > 0) {
+    console.log(color('bold', 'Actions:'));
+    for (let i = 0; i < brief.actions.length; i++) {
+      const action = brief.actions[i];
+      if (typeof action === 'string') {
+        console.log(`  ${color('green', (i + 1) + '.')} ${action}`);
+      } else {
+        console.log(`  ${color('green', (i + 1) + '.')} ${action.description || JSON.stringify(action)}`);
+      }
+    }
+    console.log();
+  }
+
+  // Print any other top-level keys
+  for (const [k, v] of Object.entries(brief)) {
+    if (!['companySignal', 'recommendedMotion', 'topContact', 'actions'].includes(k)) {
+      console.log(`${k}: ${color('dim', JSON.stringify(v))}`);
+    }
+  }
+}
+
+function outputCompanyBrief(brief) {
+  if (isJSON()) return console.log(JSON.stringify(brief, null, 2));
+  if (!brief) {
+    console.log(color('dim', 'No brief available. Use --refresh to generate.'));
+    return;
+  }
+  console.log(color('bold', 'Company Brief'));
+  console.log();
+
+  if (brief.companyName) console.log(`Company: ${color('blue', brief.companyName)}`);
+  if (brief.summary) {
+    console.log();
+    console.log(color('bold', 'Summary:'));
+    console.log(`  ${brief.summary}`);
+  }
+  if (brief.hiringTrends) {
+    console.log();
+    console.log(color('bold', 'Hiring Trends:'));
+    console.log(`  ${brief.hiringTrends}`);
+  }
+  if (brief.recentNews) {
+    console.log();
+    console.log(color('bold', 'Recent News:'));
+    if (Array.isArray(brief.recentNews)) {
+      for (const item of brief.recentNews) {
+        console.log(`  - ${typeof item === 'string' ? item : item.headline || JSON.stringify(item)}`);
+      }
+    } else {
+      console.log(`  ${brief.recentNews}`);
+    }
+  }
+  if (brief.keyPeople && brief.keyPeople.length > 0) {
+    console.log();
+    console.log(color('bold', 'Key People:'));
+    for (const person of brief.keyPeople) {
+      console.log(`  ${person.name || 'Unknown'}${person.title ? ' — ' + color('dim', person.title) : ''}`);
+    }
+  }
+  if (brief.generatedAt) console.log(color('dim', `\nGenerated: ${brief.generatedAt}`));
+
+  // Print any other top-level keys
+  for (const [k, v] of Object.entries(brief)) {
+    if (!['companyName', 'summary', 'hiringTrends', 'recentNews', 'keyPeople', 'generatedAt'].includes(k)) {
+      console.log(`${k}: ${color('dim', JSON.stringify(v))}`);
+    }
+  }
+}
+
+function outputCompanyWorkspace(workspace) {
+  if (isJSON()) return console.log(JSON.stringify(workspace, null, 2));
+  if (!workspace) {
+    console.log(color('dim', 'No workspace data available.'));
+    return;
+  }
+  console.log(color('bold', 'Company Workspace'));
+  console.log();
+
+  if (workspace.companyName) console.log(`Company: ${color('blue', workspace.companyName)}`);
+  if (workspace.activeJobsCount !== undefined) console.log(`Active Jobs: ${color('cyan', workspace.activeJobsCount)}`);
+  if (workspace.contactsCount !== undefined) console.log(`Contacts: ${color('cyan', workspace.contactsCount)}`);
+
+  if (workspace.hiringManagers && workspace.hiringManagers.length > 0) {
+    console.log();
+    console.log(color('bold', 'Hiring Managers:'));
+    for (const hm of workspace.hiringManagers) {
+      console.log(`  ${hm.name || 'Unknown'}${hm.title ? ' — ' + color('dim', hm.title) : ''}`);
+      if (hm.email) console.log(`    ${color('cyan', hm.email)}`);
+    }
+  }
+
+  if (workspace.coverageGap !== undefined) {
+    console.log();
+    console.log(color('bold', 'Coverage Gap:'));
+    if (typeof workspace.coverageGap === 'string') {
+      console.log(`  ${workspace.coverageGap}`);
+    } else {
+      console.log(`  ${JSON.stringify(workspace.coverageGap)}`);
+    }
+  }
+
+  if (workspace.campaignStatus) {
+    console.log();
+    console.log(color('bold', 'Campaign Status:'));
+    if (typeof workspace.campaignStatus === 'string') {
+      const statusColor = workspace.campaignStatus === 'active' ? 'green' : workspace.campaignStatus === 'completed' ? 'blue' : 'yellow';
+      console.log(`  ${color(statusColor, workspace.campaignStatus)}`);
+    } else {
+      console.log(`  ${JSON.stringify(workspace.campaignStatus)}`);
+    }
+  }
+
+  if (workspace.contacts && workspace.contacts.length > 0) {
+    console.log();
+    console.log(color('bold', 'Contacts:'));
+    for (const contact of workspace.contacts) {
+      const statusColor = contact.status === 'active' ? 'green' : contact.status === 'pending' ? 'yellow' : 'dim';
+      console.log(`  ${contact.name || 'Unknown'}${contact.title ? ' — ' + color('dim', contact.title) : ''} ${color(statusColor, contact.status || '')}`);
+    }
+  }
+
+  // Print any other top-level keys
+  for (const [k, v] of Object.entries(workspace)) {
+    if (!['companyName', 'activeJobsCount', 'contactsCount', 'hiringManagers', 'coverageGap', 'campaignStatus', 'contacts'].includes(k)) {
+      console.log(`${k}: ${color('dim', JSON.stringify(v))}`);
+    }
+  }
+}
+
+function padRight(str, len) {
+  if (str.length >= len) return str.slice(0, len);
+  return str + ' '.repeat(len - str.length);
+}
+
 function outputError(msg) {
   console.error(color('red', `Error: ${msg}`));
 }
 
-module.exports = { color, isJSON, outputJobs, outputCompanies, outputStats, outputError };
+module.exports = { color, isJSON, outputJobs, outputCompanies, outputStats, outputContacts, outputReferralCampaign, outputNetworkBrief, outputCompanyBrief, outputCompanyWorkspace, outputError };

package/mcp/server.js

@@ -7,7 +7,7 @@ const { apiRequest, hasAuth } = require('../lib/client');
 const { version: PACKAGE_VERSION } = require('../package.json');
 
 const MCP_USER_AGENT = `trackly-mcp/${PACKAGE_VERSION}`;
-const AUTH_HINT = 'Run `trackly login` or configure an API key with `trackly config --api-key <key>`.';
+const AUTH_HINT = 'Run `trackly login` or set TRACKLY_API_KEY. Get a key at https://usetrackly.app (sign in → Settings → API Keys).';
 
 function createErrorResult(error, fallbackMessage, extra = {}) {
   const payload = {
@@ -66,9 +66,10 @@ function createServer() {
 
   server.tool(
     'trackly_search_jobs',
-    'Search and filter job postings. Returns matching jobs with title, company, location, modality.',
+    'Search and filter job postings. Returns matching jobs with title, company, location, modality. Use companyId to filter jobs at a specific company (get companyId from trackly_search_companies first).',
     {
       function: z.enum(['product_management', 'engineering', 'design', 'data_science', 'marketing', 'sales', 'finance', 'operations', 'legal', 'hr', 'other']).optional().describe('Job function filter: product_management, engineering, design, data_science, marketing, sales, finance, operations, legal, hr, other'),
+      companyId: z.number().optional().describe('Filter jobs by company ID (get from trackly_search_companies)'),
       location: z.string().optional().describe('Location filter (city or state)'),
       modality: z.enum(['remote', 'hybrid', 'onsite']).optional().describe('Work modality: remote, hybrid, onsite'),
       status: z.enum(['new', 'saved', 'applied', 'dismissed']).optional().describe('Application status: new, saved, applied, dismissed'),
@@ -78,9 +79,17 @@ function createServer() {
       keywords: z.string().max(500).optional().describe('Keyword search in title/description'),
     },
     wrapTool(async (params) => {
+      // Map MCP param names to backend query param names
+      const paramMap = {
+        function: 'jobFunction',
+        keywords: 'search',
+      };
       const qs = new URLSearchParams();
       for (const [key, value] of Object.entries(params)) {
-        if (value !== undefined && value !== null) qs.set(key, String(value));
+        if (value !== undefined && value !== null) {
+          const backendKey = paramMap[key] || key;
+          qs.set(backendKey, String(value));
+        }
       }
       return apiRequest('GET', `/api/jobscout/jobs?${qs.toString()}`, null, false, false, MCP_USER_AGENT);
     }, 'Failed to search jobs')
@@ -166,6 +175,42 @@ function createServer() {
     }, 'Failed to process natural language query')
   );
 
+  server.tool(
+    'trackly_get_job_brief',
+    'Get a network brief for a specific job. Returns company signal, recommended motion, top contact, and suggested actions.',
+    {
+      jobId: z.number().describe('Job posting ID'),
+    },
+    wrapTool(async ({ jobId }) => {
+      return apiRequest('GET', `/api/jobscout/jobs/${jobId}/network-brief`, null, false, false, MCP_USER_AGENT);
+    }, 'Failed to fetch network brief')
+  );
+
+  server.tool(
+    'trackly_contacts_at_company',
+    'Search contacts at a specific company. Returns matching contacts with name, title, email, and status.',
+    {
+      company: z.string().max(200).describe('Company name to search contacts for'),
+      limit: z.number().max(50).optional().describe('Max results (default 20)'),
+    },
+    wrapTool(async ({ company, limit }) => {
+      const qs = new URLSearchParams({ search: company });
+      if (limit) qs.set('limit', String(limit));
+      return apiRequest('GET', `/api/network/people?${qs.toString()}`, null, false, false, MCP_USER_AGENT);
+    }, 'Failed to search contacts at company')
+  );
+
+  server.tool(
+    'trackly_get_company_workspace',
+    'Get the full workspace view for a company: active jobs, contacts, hiring managers, coverage gap, and campaign status.',
+    {
+      companyId: z.number().describe('Company ID'),
+    },
+    wrapTool(async ({ companyId }) => {
+      return apiRequest('GET', `/api/network/companies/${companyId}/workspace`, null, false, false, MCP_USER_AGENT);
+    }, 'Failed to fetch company workspace')
+  );
+
   return server;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackly-cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "mcpName": "io.github.kevinastuhuaman/trackly",
   "description": "CLI + MCP server for job tracking — search, apply, and manage applications from terminal or AI agents",
   "bin": {

package/server.json

@@ -15,12 +15,12 @@
       "sizes": ["512x512"]
     }
   ],
-  "version": "0.1.5",
+  "version": "0.1.7",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "trackly-cli",
-      "version": "0.1.5",
+      "version": "0.1.7",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {