@jsonresume/jobs 0.10.0 → 0.11.0

package/README.md

@@ -118,11 +118,12 @@ The TUI has three main regions:
 - **Export** — press `e` to export your shortlist, applied, and maybe lists to a `job-hunt-YYYY-MM-DD.md` markdown file in the current directory
 - **Toast notifications** — instant feedback on every action (marking, exporting, refreshing)
 - **Help modal** — press `?` for a full keyboard reference organized by section
+- **Dossier research** — press `c` to spawn a Claude Code CLI session that researches the company, role, and generates a comprehensive dossier with fit assessment, talking points, interview prep, and compensation context. Results stream live and are cached server-side so you can revisit them anytime. Supports switching between multiple dossiers without restarting. Requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
 - **AI summaries** — press `Space` for a per-job AI summary, or `S` for a batch review of all visible jobs (requires `OPENAI_API_KEY`)
 - **Vim-style navigation** — `j`/`k` to move, `g`/`G` to jump to first/last, `Ctrl+U`/`Ctrl+D` to page up/down
 - **Responsive columns** — job list columns (score, title, company, location, salary) adapt to terminal width on resize
 - **Smart filtering** — passed and dismissed jobs are excluded server-side with 5x over-fetch, so you always get a full set of fresh results
-- **Cached results** — job data is cached locally for 24 hours to minimize API calls; press `R` to force a fresh fetch
+- **Cached results** — job data is cached locally for 2 hours to minimize API calls; press `R` to force a fresh fetch
 
 ### Keyboard Shortcuts
 
@@ -145,6 +146,7 @@ The TUI has three main regions:
 | `f` | Manage filters |
 | `/` | Search profiles |
 | `Space` | AI summary for current job |
+| `c` | Research dossier via Claude Code CLI |
 | `S` | AI batch review of visible jobs |
 | `e` | Export shortlist to markdown |
 | `R` | Force refresh (bypass cache) |
@@ -160,6 +162,7 @@ The TUI has three main regions:
 | `o` | Open HN post in browser |
 | `i` / `x` / `m` / `p` | Mark job state |
 | `Space` | AI summary |
+| `c` | Research dossier |
 | `Esc` / `q` | Back to full list |
 
 #### Filters Panel
@@ -262,6 +265,10 @@ npx @jsonresume/jobs help                                # All options
 | `not_interested` | ✗ | Not for you (hidden from future searches) |
 | `dismissed` | 👁 | Hide from results (hidden from future searches) |
 
+## Architecture
+
+![architecture](./architecture.svg)
+
 ## How Ranking Works
 
 The system uses a five-stage pipeline to match and rank jobs against your resume.
@@ -335,7 +342,7 @@ All local data is stored under `~/.jsonresume/`:
 |------|----------|
 | `~/.jsonresume/config.json` | API key and username (registry mode) |
 | `~/.jsonresume/filters.json` | Saved filter presets per search profile |
-| `~/.jsonresume/cache/` | Cached job results (auto-expires after 24 hours) |
+| `~/.jsonresume/cache/` | Cached job results (auto-expires after 2 hours) |
 | `~/.jsonresume/local-marks.json` | Job marks in local mode |
 
 The export command writes `job-hunt-YYYY-MM-DD.md` to your current working directory.
@@ -363,7 +370,8 @@ The TUI is built with [React Ink](https://github.com/vadimdemedes/ink) v6 using
 | `src/tui/JobDetail.js` | Full job detail view (standalone and split-pane) |
 | `src/tui/StatusBar.js` | Key hints, loading state, toasts |
 | `src/tui/useJobs.js` | Job fetching, caching, tab filtering |
-| `src/tui/useAI.js` | AI summary and batch review integration |
+| `src/tui/useAI.js` | AI summary, dossier research (Claude CLI), batch review |
+| `src/tui/AIPanel.js` | Dossier/AI split-pane panel with scroll and export |
 | `src/tui/useSearches.js` | Search profile CRUD |
 | `src/filters.js` | Persistent filter storage per search profile |
 | `src/export.js` | Markdown export |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonresume/jobs",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "Search Hacker News jobs matched against your JSON Resume",
   "bin": {

package/src/api.js

@@ -57,5 +57,13 @@ export function createApiClient({ baseUrl, apiKey }) {
         body: JSON.stringify(updates),
       }),
     deleteSearch: (id) => request(`/searches/${id}`, { method: 'DELETE' }),
+
+    // Dossiers
+    fetchDossier: (id) => request(`/jobs/${id}/dossier`),
+    saveDossier: (id, content) =>
+      request(`/jobs/${id}/dossier`, {
+        method: 'PUT',
+        body: JSON.stringify({ content }),
+      }),
   };
 }

package/src/cache.js

@@ -3,7 +3,7 @@ import { join } from 'path';
 import { homedir } from 'os';
 
 const CACHE_DIR = join(homedir(), '.jsonresume', 'cache');
-const CACHE_TTL = 24 * 60 * 60 * 1000; // 1 day
+const CACHE_TTL = 2 * 60 * 60 * 1000; // 2 hours
 
 function ensureDir() {
   try {
@@ -14,6 +14,7 @@ function ensureDir() {
 function cacheKey(params) {
   const parts = [`jobs_${params.days || 30}_${params.top || 100}`];
   if (params.searchId) parts.push(`s_${params.searchId.slice(0, 8)}`);
+  if (params.mode) parts.push(params.mode);
   return parts.join('_') + '.json';
 }
 

package/src/localApi.js

@@ -10,6 +10,7 @@ export function createLocalApiClient({ baseUrl, resume }) {
   const base = baseUrl || DEFAULT_BASE_URL;
 
   return {
+    mode: 'local',
     fetchJobs: async (params = {}) => {
       const body = {
         resume,
@@ -68,5 +69,9 @@ export function createLocalApiClient({ baseUrl, resume }) {
     deleteSearch: async () => {
       throw new Error('Search profiles require a registry account');
     },
+
+    // Dossiers — local mode stores in memory only
+    fetchDossier: async () => ({ content: null }),
+    saveDossier: async () => ({ saved: true }),
   };
 }

package/src/tui/AIPanel.js

@@ -1,37 +1,135 @@
+import { useState, useEffect, useRef } from 'react';
 import { Box, Text, useInput } from 'ink';
 import Spinner from 'ink-spinner';
 import { h } from './h.js';
 
-export default function AIPanel({ text, loading, error, onDismiss, isActive }) {
+export default function AIPanel({
+  text,
+  loading,
+  error,
+  onDismiss,
+  onExport,
+  onMark,
+  job,
+  isActive,
+  mode,
+}) {
+  const [scroll, setScroll] = useState(0);
+  const maxRows = Math.max((process.stdout.rows || 30) - 8, 10);
+  const exportMsg = useRef(null);
+
+  // Enable mouse reporting for scroll wheel
+  useEffect(() => {
+    if (!process.stdout.isTTY) return;
+    // Enable mouse wheel reporting (SGR mode)
+    process.stdout.write('\x1b[?1000h\x1b[?1006h');
+    const onData = (data) => {
+      const str = data.toString();
+      // SGR mouse: \x1b[<button;col;row(M|m)
+      const match = str.match(/\x1b\[<(\d+);(\d+);(\d+)([Mm])/);
+      if (match) {
+        const btn = parseInt(match[1], 10);
+        if (btn === 64) setScroll((s) => Math.max(0, s - 3));
+        if (btn === 65) setScroll((s) => s + 3);
+      }
+    };
+    process.stdin.on('data', onData);
+    return () => {
+      process.stdin.removeListener('data', onData);
+      if (process.stdout.isTTY) {
+        process.stdout.write('\x1b[?1000l\x1b[?1006l');
+      }
+    };
+  }, []);
+
   useInput(
-    (_input, key) => {
+    (input, key) => {
       if (key.escape) onDismiss();
+      if (input === 'e' && text && onExport) {
+        const filename = onExport();
+        if (filename) {
+          exportMsg.current = filename;
+          setTimeout(() => {
+            exportMsg.current = null;
+          }, 3000);
+        }
+      }
+      // Mark keys
+      if (job && onMark) {
+        if (input === 'i') onMark(job.id, 'interested');
+        if (input === 'x') onMark(job.id, 'applied');
+        if (input === 'm') onMark(job.id, 'maybe');
+        if (input === 'p') onMark(job.id, 'not_interested');
+      }
+      if (key.upArrow || input === 'k') setScroll((s) => Math.max(0, s - 1));
+      if (key.downArrow || input === 'j') setScroll((s) => s + 1);
+      if (key.pageUp || (key.ctrl && input === 'u'))
+        setScroll((s) => Math.max(0, s - 20));
+      if (key.pageDown || (key.ctrl && input === 'd')) setScroll((s) => s + 20);
+      if (input === 'g') setScroll(0);
+      if (input === 'G' && text) {
+        const lines = text.split('\n');
+        setScroll(Math.max(0, lines.length - maxRows));
+      }
     },
     { isActive }
   );
 
+  const isCover = mode === 'cover';
+  const title = isCover ? '📋 Job Dossier (via Claude Code)' : '🤖 AI Analysis';
+  const color = isCover ? 'green' : 'magenta';
+  const loadingMsg = isCover
+    ? ' Claude is researching… (streaming live)'
+    : ' Thinking...';
+
+  let displayText = text;
+  let totalLines = 0;
+  if (text) {
+    const lines = text.split('\n');
+    totalLines = lines.length;
+    if (loading) {
+      // While streaming, auto-scroll to bottom
+      displayText = lines.slice(Math.max(0, lines.length - maxRows)).join('\n');
+    } else {
+      // When done, allow manual scroll
+      const start = Math.min(scroll, Math.max(0, lines.length - maxRows));
+      displayText = lines.slice(start, start + maxRows).join('\n');
+    }
+  }
+
+  const scrollHint =
+    !loading && totalLines > maxRows
+      ? `j/k scroll · g/G top/bottom · ${scroll + 1}–${Math.min(
+          scroll + maxRows,
+          totalLines
+        )}/${totalLines}`
+      : '';
+
+  const exportHint = text ? ' · e export' : '';
+  const statusLine =
+    loading && text
+      ? 'Streaming… ESC to cancel'
+      : loading
+      ? 'ESC to cancel'
+      : scrollHint
+      ? `${scrollHint}${exportHint}  ·  ESC to dismiss`
+      : `ESC to dismiss${exportHint}`;
+
   return h(
     Box,
     {
       flexDirection: 'column',
-      borderStyle: 'double',
-      borderColor: 'magenta',
-      padding: 1,
-      marginX: 2,
+      flexGrow: 1,
+      paddingX: 1,
     },
-    h(Text, { bold: true, color: 'magenta' }, '🤖 AI Analysis'),
+    h(Text, { bold: true, color }, title),
     h(Text, null, ' '),
     loading
-      ? h(
-          Box,
-          null,
-          h(Spinner, { type: 'dots' }),
-          h(Text, null, ' Thinking...')
-        )
+      ? h(Box, null, h(Spinner, { type: 'dots' }), h(Text, null, loadingMsg))
       : null,
     error ? h(Text, { color: 'red' }, `Error: ${error}`) : null,
-    text ? h(Text, { wrap: 'wrap' }, text) : null,
+    displayText ? h(Text, { wrap: 'wrap' }, displayText) : null,
     h(Text, null, ' '),
-    h(Text, { dimColor: true }, 'Press ESC to dismiss')
+    h(Text, { dimColor: true }, statusLine)
   );
 }

package/src/tui/App.js

@@ -65,7 +65,9 @@ function App({ baseUrl, apiKey, apiClient }) {
   // Active search profile
   const [activeSearchId, setActiveSearchId] = useState(null);
 
-  // Persistent filters
+  const searchesHook = useSearches(api);
+
+  // Persistent filters (local + server sync for search profiles)
   const [filterStore, setFilterStore] = useState(() => loadFilters());
   const activeFilters = useMemo(
     () => getFiltersForSearch(filterStore, activeSearchId),
@@ -78,8 +80,12 @@ function App({ baseUrl, apiKey, apiClient }) {
         saveFilters(next);
         return next;
       });
+      // Sync to server for search profiles
+      if (activeSearchId) {
+        searchesHook.updateFilters(activeSearchId, newActive);
+      }
     },
-    [activeSearchId]
+    [activeSearchId, searchesHook]
   );
   const filterState = useMemo(
     () => ({ active: activeFilters }),
@@ -90,6 +96,21 @@ function App({ baseUrl, apiKey, apiClient }) {
     [updateFilters]
   );
 
+  // Sync server-side filters into local store when search profiles load
+  useEffect(() => {
+    if (!searchesHook.searches.length) return;
+    setFilterStore((prev) => {
+      let updated = prev;
+      for (const s of searchesHook.searches) {
+        if (s.filters?.length && !prev.searches?.[s.id]) {
+          updated = setFiltersForSearch(updated, s.id, s.filters);
+        }
+      }
+      if (updated !== prev) saveFilters(updated);
+      return updated;
+    });
+  }, [searchesHook.searches]);
+
   const {
     jobs: rawJobs,
     allJobs,
@@ -100,8 +121,19 @@ function App({ baseUrl, apiKey, apiClient }) {
     forceRefresh,
   } = useJobs(api, activeFilters, tab, activeSearchId);
   const ai = useAI(resume);
-  const searchesHook = useSearches(api);
   const { toast, show: showToast } = useToast();
+  const [confirmExit, setConfirmExit] = useState(false);
+
+  // Kill claude processes on exit (Ctrl+C)
+  useEffect(() => {
+    const cleanup = () => ai.cancel();
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    return () => {
+      process.removeListener('SIGINT', cleanup);
+      process.removeListener('SIGTERM', cleanup);
+    };
+  }, [ai]);
 
   // Apply inline search filter
   const jobs = useMemo(() => {
@@ -128,12 +160,12 @@ function App({ baseUrl, apiKey, apiClient }) {
       .catch(() => {});
   }, [api]);
 
-  // Update selectedJob when cursor moves in detail view
+  // Update selectedJob when cursor moves or jobs list changes in detail view
   useEffect(() => {
     if (view === 'detail' && jobs[cursor]) {
       setSelectedJob(jobs[cursor]);
     }
-  }, [cursor, view]);
+  }, [cursor, view, jobs]);
 
   // Inline search escape handler
   useInput(
@@ -153,7 +185,19 @@ function App({ baseUrl, apiKey, apiClient }) {
       if (view === 'filters' || view === 'searches' || view === 'help') return;
       if (inlineSearch) return;
 
-      if (input === 'q' && view === 'list') exit();
+      if (input === 'q' && view === 'list') {
+        if (ai.hasActiveProcess && !confirmExit) {
+          showToast(
+            'Claude dossier still running — press q again to quit',
+            'warning'
+          );
+          setConfirmExit(true);
+          return;
+        }
+        ai.cancel();
+        exit();
+      }
+      if (input !== 'q') setConfirmExit(false);
       if (input === 'q' && view === 'detail') setView('list');
       if (input === 'R' && (view === 'list' || view === 'detail')) {
         forceRefresh();
@@ -176,9 +220,12 @@ function App({ baseUrl, apiKey, apiClient }) {
         setView('detail');
       }
       if (key.escape && view === 'detail') setView('list');
+      if (input === 'c' && view === 'detail' && selectedJob) {
+        handleDossier(selectedJob);
+      }
 
       if (key.escape && view === 'ai') {
-        ai.clear();
+        // Don't kill running dossier — just hide the panel
         setView(selectedJob ? 'detail' : 'list');
       }
 
@@ -219,6 +266,11 @@ function App({ baseUrl, apiKey, apiClient }) {
     setView('ai');
     ai.summarizeJob(job);
   };
+  const handleDossier = (job) => {
+    setSelectedJob(job);
+    setView('ai');
+    ai.dossier(job, api);
+  };
   const handleAIBatch = (visibleJobs) => {
     setView('ai');
     ai.batchReview(visibleJobs);
@@ -312,6 +364,9 @@ function App({ baseUrl, apiKey, apiClient }) {
             onCursorChange: setCursor,
             onSelect: handleSelect,
             onMark: handleMark,
+            onAISummary: handleAISummary,
+            onDossier: handleDossier,
+            getDossierStatus: ai.getDossierStatus,
             isActive: true,
             compact: true,
             reservedRows: 8,
@@ -327,6 +382,8 @@ function App({ baseUrl, apiKey, apiClient }) {
             onBack: handleBack,
             onMark: handleMark,
             onAISummary: handleAISummary,
+            onDossier: handleDossier,
+            getDossierStatus: ai.getDossierStatus,
             isActive: false,
             isPanel: true,
           })
@@ -336,6 +393,70 @@ function App({ baseUrl, apiKey, apiClient }) {
     );
   }
 
+  // Split-pane: compact list on left, AI/dossier on right
+  if (view === 'ai' && selectedJob) {
+    return h(
+      Box,
+      { flexDirection: 'column', height: process.stdout.rows || 40 },
+      header,
+      h(
+        Box,
+        { flexGrow: 1, flexDirection: 'row' },
+        // Left pane: compact job list
+        h(
+          Box,
+          {
+            flexDirection: 'column',
+            width: '40%',
+            borderStyle: 'single',
+            borderColor: 'gray',
+            borderRight: true,
+            borderLeft: false,
+            borderTop: false,
+            borderBottom: false,
+          },
+          h(JobList, {
+            jobs,
+            cursor,
+            tab,
+            onCursorChange: setCursor,
+            onSelect: handleSelect,
+            onMark: handleMark,
+            onAISummary: handleAISummary,
+            onDossier: handleDossier,
+            getDossierStatus: ai.getDossierStatus,
+            isActive: false,
+            compact: true,
+            reservedRows: 8,
+          })
+        ),
+        // Right pane: AI/dossier panel
+        h(
+          Box,
+          { flexDirection: 'column', width: '60%' },
+          h(AIPanel, {
+            text: ai.text,
+            loading: ai.loading,
+            error: ai.error,
+            mode: ai.mode,
+            job: selectedJob,
+            onMark: handleMark,
+            onDismiss: () => {
+              setView(selectedJob ? 'detail' : 'list');
+            },
+            onExport: () => {
+              const f = ai.exportDossier(selectedJob);
+              if (f) showToast(`Saved ./${f}`, 'export');
+              return f;
+            },
+            isActive: true,
+          })
+        )
+      ),
+      statusBar
+    );
+  }
+
   // Full-width list view
   return h(
     Box,
@@ -350,6 +471,7 @@ function App({ baseUrl, apiKey, apiClient }) {
           onSelect: handleSelect,
           onMark: handleMark,
           onAISummary: handleAISummary,
+          onDossier: handleDossier,
           onAIBatch: handleAIBatch,
           onExport: handleExport,
           isActive: !inlineSearch,
@@ -384,14 +506,15 @@ function App({ baseUrl, apiKey, apiClient }) {
           onClose: () => setView('list'),
         })
       : null,
-    view === 'ai'
+    view === 'ai' && !selectedJob
       ? h(AIPanel, {
           text: ai.text,
           loading: ai.loading,
           error: ai.error,
+          mode: ai.mode,
           onDismiss: () => {
             ai.clear();
-            setView(selectedJob ? 'detail' : 'list');
+            setView('list');
           },
           isActive: true,
         })

package/src/tui/HelpModal.js

@@ -46,6 +46,7 @@ const SECTIONS = [
     title: 'AI Features (requires OPENAI_API_KEY)',
     keys: [
       ['Space', 'AI summary of current job'],
+      ['c', 'Research dossier (uses Claude Code CLI)'],
       ['S', 'AI batch review of visible jobs'],
     ],
   },

package/src/tui/JobDetail.js

@@ -10,6 +10,7 @@ export default function JobDetail({
   onBack,
   onMark,
   onAISummary,
+  onDossier,
   isActive,
   isPanel,
 }) {
@@ -45,6 +46,7 @@ export default function JobDetail({
       if (input === 'm') onMark(job.id, 'maybe');
       if (input === 'p') onMark(job.id, 'not_interested');
       if (input === ' ') onAISummary(job);
+      if (input === 'c' && onDossier) onDossier(job);
       if (input === 'o' && (detail?.url || job.url)) {
         import('child_process').then(({ exec }) => {
           const url = detail?.url || job.url;

package/src/tui/JobList.js

@@ -16,13 +16,26 @@ function useColumns(hasRerank, compact) {
   const cols = stdout?.columns || 120;
   const available = compact ? Math.floor(cols * 0.4) : cols;
 
+  const dossierW = 2;
+
   if (compact) {
-    // Compact mode: just score, title, status
+    // Compact mode: just score, title, dossier, status
     const scoreW = 5;
     const statusW = 2;
     const gaps = GAP * 2;
-    const titleW = Math.max(10, available - scoreW - statusW - gaps - 2);
-    return { cols: available, titleW, compW: 0, locW: 0, scoreW, statusW };
+    const titleW = Math.max(
+      10,
+      available - scoreW - dossierW - statusW - gaps - 2
+    );
+    return {
+      cols: available,
+      titleW,
+      compW: 0,
+      locW: 0,
+      scoreW,
+      statusW,
+      dossierW,
+    };
   }
 
   const scoreW = 5;
@@ -30,8 +43,9 @@ function useColumns(hasRerank, compact) {
   const salaryW = 12;
   const statusW = 2;
   const cursorW = 2;
-  const gaps = GAP * (hasRerank ? 6 : 5);
-  const fixed = cursorW + scoreW + aiW + salaryW + statusW + gaps + 2; // +2 paddingX
+  const gaps = GAP * (hasRerank ? 7 : 6);
+  const fixed =
+    cursorW + scoreW + aiW + salaryW + dossierW + statusW + gaps + 2;
   const flex = Math.max(30, available - fixed);
   const titleW = Math.max(12, Math.floor(flex * 0.35));
   const compW = Math.max(10, Math.floor(flex * 0.3));
@@ -44,6 +58,7 @@ function useColumns(hasRerank, compact) {
     scoreW,
     salaryW,
     statusW,
+    dossierW,
     aiW,
   };
 }
@@ -99,6 +114,11 @@ function HeaderRow({ hasRerank, titleW, compW, locW, compact }) {
       { width: 12, marginRight: GAP },
       h(Text, { bold: true, dimColor: true }, 'Salary')
     ),
+    h(
+      Box,
+      { width: 2, marginRight: GAP },
+      h(Text, { bold: true, dimColor: true }, '📋')
+    ),
     h(Box, { width: 2 }, h(Text, { bold: true, dimColor: true }, '  '))
   );
 }
@@ -112,12 +132,15 @@ function JobRow({
   locW,
   marked,
   compact,
+  dossierStatus,
 }) {
   const loc = formatLocation(job.location, job.remote);
   const sal = formatSalary(job.salary, job.salary_usd);
   const score =
     typeof job.similarity === 'number' ? job.similarity.toFixed(2) : '—';
   const icon = stateIcon(job.state);
+  const dossierIcon =
+    dossierStatus === 'generating' ? '◌' : dossierStatus === 'done' ? '📋' : '';
 
   const stColor =
     job.state === 'interested'
@@ -145,6 +168,8 @@ function JobRow({
     backgroundColor: bg,
   };
 
+  const dossierColor = dossierStatus === 'generating' ? 'yellow' : 'green';
+
   if (compact) {
     return h(
       Box,
@@ -160,6 +185,15 @@ function JobRow({
         { flexGrow: 1 },
         h(Text, props, truncate(job.title || '—', titleW))
       ),
+      h(
+        Box,
+        { width: 2 },
+        h(
+          Text,
+          { ...props, color: dossierIcon ? dossierColor : undefined },
+          dossierIcon || ' '
+        )
+      ),
       h(Box, { width: 2 }, h(Text, props, icon))
     );
   }
@@ -196,6 +230,15 @@ function JobRow({
       h(Text, props, truncate(loc, locW - 1))
     ),
     h(Box, { width: 12, marginRight: GAP }, h(Text, props, truncate(sal, 11))),
+    h(
+      Box,
+      { width: 2, marginRight: GAP },
+      h(
+        Text,
+        { ...props, color: dossierIcon ? dossierColor : undefined },
+        dossierIcon || ' '
+      )
+    ),
     h(Box, { width: 2 }, h(Text, props, icon))
   );
 }
@@ -248,8 +291,10 @@ export default function JobList({
   onSelect,
   onMark,
   onAISummary,
+  onDossier,
   onAIBatch,
   onExport,
+  getDossierStatus,
   isActive,
   tab,
   compact,
@@ -321,6 +366,7 @@ export default function JobList({
       if (input === 'p' && jobs[cursor])
         onMark(jobs[cursor].id, 'not_interested');
       if (input === ' ' && jobs[cursor]) onAISummary(jobs[cursor]);
+      if (input === 'c' && jobs[cursor] && onDossier) onDossier(jobs[cursor]);
       if (input === 'S' && onAIBatch) onAIBatch(jobs);
       if (input === 'e' && onExport) onExport();
     },
@@ -344,6 +390,7 @@ export default function JobList({
       compW,
       locW,
       compact,
+      dossierStatus: getDossierStatus ? getDossierStatus(job.id) : null,
     })
   );
 

package/src/tui/StatusBar.js

@@ -12,6 +12,7 @@ const KEYS = {
     ['v', 'select'],
     ['n', 'find'],
     ['space', 'AI'],
+    ['c', 'dossier'],
   ],
   detail: [
     ['j/k', 'nav jobs'],
@@ -19,6 +20,7 @@ const KEYS = {
     ['i/x/m/p', 'mark'],
     ['o', 'open URL'],
     ['space', 'AI'],
+    ['c', 'dossier'],
     ['esc', 'back'],
   ],
   search: [
@@ -39,7 +41,13 @@ const KEYS = {
     ['d', 'delete'],
     ['esc', 'close'],
   ],
-  ai: [['esc', 'dismiss']],
+  ai: [
+    ['j/k', 'scroll'],
+    ['g/G', 'top/bottom'],
+    ['i/x/m/p', 'mark'],
+    ['e', 'export'],
+    ['esc', 'back'],
+  ],
   help: [['?/esc', 'close']],
 };
 

package/src/tui/useAI.js

@@ -1,12 +1,64 @@
-import { useState, useCallback } from 'react';
+import { useState, useCallback, useRef } from 'react';
+import { writeFileSync } from 'fs';
 import { generateText } from 'ai';
 import { openai } from '@ai-sdk/openai';
 
+function buildResumeText(resume) {
+  return [
+    resume?.basics?.name,
+    resume?.basics?.label,
+    resume?.basics?.summary,
+    ...(resume?.skills || []).map(
+      (s) => `${s.name}: ${(s.keywords || []).join(', ')}`
+    ),
+    ...(resume?.work || [])
+      .slice(0, 5)
+      .map(
+        (w) =>
+          `${w.position} at ${w.name}${
+            w.startDate ? ` (${w.startDate})` : ''
+          }: ${w.summary || ''}`
+      ),
+    ...(resume?.projects || [])
+      .slice(0, 3)
+      .map((p) => `Project: ${p.name} — ${p.description || ''}`),
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
+function buildJobText(job, rawContent) {
+  return [
+    `Title: ${job.title}`,
+    `Company: ${job.company}`,
+    `Salary: ${job.salary || 'Not listed'}`,
+    `Remote: ${job.remote || 'Not specified'}`,
+    job.experience ? `Experience: ${job.experience}` : '',
+    job.type ? `Type: ${job.type}` : '',
+    job.url ? `HN Post: ${job.url}` : '',
+    `Description: ${job.description || ''}`,
+    `Skills: ${(job.skills || []).map((s) => s.name || s).join(', ')}`,
+    ...(job.qualifications || []).map((q) => `Qualification: ${q}`),
+    ...(job.responsibilities || []).map((r) => `Responsibility: ${r}`),
+    rawContent ? `\nFull original posting:\n${rawContent}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
 export function useAI(resume) {
   const [text, setText] = useState('');
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
+  const [mode, setMode] = useState('ai'); // 'ai' | 'cover'
   const hasKey = Boolean(process.env.OPENAI_API_KEY);
+  const childRef = useRef(null);
+  const dossierJobId = useRef(null);
+  // Local cache: jobId → { text, done, loading }
+  const dossierCache = useRef(new Map());
+  // Bump to trigger re-renders when dossier status changes
+  const [, setDossierTick] = useState(0);
+  const bumpTick = () => setDossierTick((t) => t + 1);
 
   const summarizeJob = useCallback(
     async (job) => {
@@ -16,6 +68,7 @@ export function useAI(resume) {
         );
         return;
       }
+      setMode('ai');
       setLoading(true);
       setError(null);
       setText('');
@@ -56,6 +109,283 @@ export function useAI(resume) {
     [resume, hasKey]
   );
 
+  const dossier = useCallback(
+    async (job, api) => {
+      const cached = dossierCache.current.get(job.id);
+
+      // If dossier is already loading or loaded for this job, just show it
+      if (cached && (cached.loading || cached.done)) {
+        setMode('cover');
+        setText(cached.text || '');
+        setLoading(cached.loading || false);
+        setError(null);
+        dossierJobId.current = job.id;
+        return;
+      }
+
+      setMode('cover');
+      setError(null);
+      setText('');
+      dossierJobId.current = job.id;
+      dossierCache.current.set(job.id, {
+        text: '',
+        done: false,
+        loading: true,
+      });
+      bumpTick();
+
+      // Helper to update both state and cache
+      // Only updates visible state if this job is still the active dossier
+      const updateText = (val) => {
+        const entry = dossierCache.current.get(job.id);
+        if (entry) entry.text = val;
+        if (dossierJobId.current === job.id) setText(val);
+      };
+
+      // Check server for existing dossier
+      try {
+        const { content } = await api.fetchDossier(job.id);
+        if (content) {
+          updateText(content);
+          dossierCache.current.set(job.id, {
+            text: content,
+            done: true,
+            loading: false,
+          });
+          bumpTick();
+          return;
+        }
+      } catch {
+        /* no cached dossier */
+      }
+
+      // Check if claude CLI is available
+      const { execSync } = await import('child_process');
+      let claudePath;
+      try {
+        claudePath = execSync('which claude', { encoding: 'utf-8' }).trim();
+      } catch {
+        setError(
+          'Claude Code CLI not found. Install it: npm install -g @anthropic-ai/claude-code'
+        );
+        return;
+      }
+
+      // Kill any existing claude process
+      if (childRef.current) {
+        try {
+          childRef.current.kill();
+        } catch {}
+        childRef.current = null;
+      }
+
+      setLoading(true);
+
+      // Fetch resume if not available yet
+      let currentResume = resume;
+      if (!currentResume) {
+        try {
+          const me = await api.fetchMe();
+          currentResume = me.resume;
+        } catch {
+          /* proceed without resume */
+        }
+      }
+
+      // Fetch full job detail for raw content
+      let rawContent = '';
+      try {
+        const detail = await api.fetchJobDetail(job.id);
+        rawContent = detail.raw_content || detail.full_description || '';
+      } catch {}
+
+      const resumeText = buildResumeText(currentResume);
+      const jobText = buildJobText(job, rawContent);
+
+      const prompt = `You are a job search research assistant. A candidate is considering applying to this role. Do thorough research and produce a comprehensive dossier.
+
+## Candidate Resume
+${resumeText}
+
+## Job Posting
+${jobText}
+
+## Your Task
+
+Research everything you can and produce a complete dossier covering:
+
+### 1. Company Deep Dive
+- What the company does, their products/services
+- Funding stage, size, recent news
+- Tech stack and engineering culture
+- Leadership team
+- Employee sentiment and Glassdoor/Blind highlights
+- Any red flags or concerns
+
+### 2. Role Analysis
+- What you'd actually be doing day-to-day
+- Team context — who you'd work with
+- Growth trajectory for this role
+- How this role fits into the company's current priorities
+
+### 3. Fit Assessment
+- Matching skills and experience (be specific, reference the candidate's actual background)
+- Skill gaps to acknowledge or address
+- Adjacent experience that transfers
+- Overall fit rating: Strong / Good / Stretch
+
+### 4. Cover Letter Talking Points
+- 5-7 specific bullet points to mention, each referencing the candidate's real experience
+- What angle to take (technical depth? leadership? domain expertise?)
+- What to emphasize vs. downplay
+
+### 5. Contact Info
+- Email addresses from the posting
+- Who posted (HN username from the URL if available)
+- Best way to reach out
+
+### 6. Interview Prep
+- Questions they'll likely ask for this role
+- Questions the candidate should ask
+- Topics to research before interviewing
+
+### 7. Compensation Context
+- Market rate for this role/level/location
+- How the listed salary compares
+- Negotiation leverage points
+
+Be thorough, specific, and opinionated. Reference the candidate's actual experience when making recommendations.`;
+
+      try {
+        const { spawn } = await import('child_process');
+        // Remove CLAUDECODE env var to allow nested claude sessions
+        const env = { ...process.env };
+        delete env.CLAUDECODE;
+        delete env.CLAUDE_CODE_ENTRYPOINT;
+        delete env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+
+        const child = spawn(
+          claudePath,
+          [
+            '--print',
+            '--output-format',
+            'stream-json',
+            '--verbose',
+            '--allowedTools',
+            'WebSearch',
+            'WebFetch',
+            '--',
+            prompt,
+          ],
+          { stdio: ['ignore', 'pipe', 'pipe'], env }
+        );
+        childRef.current = child;
+
+        let finalResult = '';
+        let buffer = '';
+        let statusLine = '';
+
+        function processLine(line) {
+          if (!line.trim()) return;
+          try {
+            const event = JSON.parse(line);
+
+            if (event.type === 'assistant') {
+              // Extract text from assistant message content
+              const content = event.message?.content || [];
+              for (const block of content) {
+                if (block.type === 'text' && block.text) {
+                  finalResult = block.text;
+                  updateText(
+                    statusLine ? `${statusLine}\n\n${finalResult}` : finalResult
+                  );
+                } else if (block.type === 'tool_use') {
+                  // Show what Claude is doing (e.g. WebSearch, WebFetch)
+                  const name = block.name || 'tool';
+                  const input = block.input || {};
+                  if (name === 'WebSearch' || name === 'WebFetch') {
+                    statusLine = `🔍 ${name}: ${
+                      input.query || input.url || ''
+                    }`;
+                  } else {
+                    statusLine = `⚙ Using ${name}…`;
+                  }
+                  updateText(
+                    finalResult ? `${statusLine}\n\n${finalResult}` : statusLine
+                  );
+                }
+              }
+            }
+
+            if (event.type === 'result' && event.result) {
+              finalResult = event.result;
+              updateText(finalResult);
+            }
+          } catch {
+            // Not valid JSON, skip
+          }
+        }
+
+        child.stdout.on('data', (chunk) => {
+          buffer += chunk.toString();
+          // Process complete JSON lines
+          const lines = buffer.split('\n');
+          buffer = lines.pop() || '';
+          for (const line of lines) {
+            processLine(line);
+          }
+        });
+
+        child.stderr.on('data', () => {});
+
+        await new Promise((resolve, reject) => {
+          child.on('close', (code) => {
+            // Only clear childRef if it's still our process
+            if (childRef.current === child) childRef.current = null;
+            // Process any remaining buffer
+            if (buffer.trim()) processLine(buffer);
+            if (code === 0) {
+              resolve();
+            } else if (code !== null) {
+              reject(new Error(`Claude exited with code ${code}`));
+            } else {
+              resolve(); // killed
+            }
+          });
+          child.on('error', (err) => {
+            if (childRef.current === child) childRef.current = null;
+            reject(err);
+          });
+        });
+
+        // Save to server if we got output
+        if (finalResult.trim()) {
+          try {
+            await api.saveDossier(job.id, finalResult);
+          } catch {}
+        }
+      } catch (err) {
+        if (err.message?.includes('exited with code')) {
+          setError(`Claude failed — ${err.message}`);
+        } else if (err.message !== 'killed') {
+          setError(err.message);
+        }
+      } finally {
+        const entry = dossierCache.current.get(job.id);
+        if (entry) {
+          entry.done = true;
+          entry.loading = false;
+        }
+        bumpTick();
+        if (dossierJobId.current === job.id) {
+          childRef.current = null;
+          setLoading(false);
+        }
+      }
+    },
+    [resume]
+  );
+
   const batchReview = useCallback(
     async (jobs) => {
       if (!hasKey) {
@@ -64,6 +394,7 @@ export function useAI(resume) {
         );
         return;
       }
+      setMode('ai');
       setLoading(true);
       setError(null);
       setText('');
@@ -99,13 +430,61 @@ export function useAI(resume) {
     [resume, hasKey]
   );
 
+  const cancel = useCallback(() => {
+    if (childRef.current) {
+      try {
+        childRef.current.kill();
+      } catch {}
+      childRef.current = null;
+    }
+  }, []);
+
+  const textRef = useRef('');
+  textRef.current = text;
+
+  const exportDossier = useCallback((job) => {
+    // Use visible text state, or fall back to cache
+    const content =
+      textRef.current || dossierCache.current.get(job?.id)?.text || '';
+    if (!content) return null;
+    const company = (job?.company || 'unknown')
+      .replace(/[^a-zA-Z0-9]+/g, '-')
+      .replace(/-+/g, '-')
+      .replace(/^-|-$/g, '')
+      .toLowerCase()
+      .slice(0, 50);
+    const filename = `dossier-${company}.md`;
+    writeFileSync(filename, content, 'utf-8');
+    return filename;
+  }, []);
+
+  // Expose dossier status for job list icons
+  // Returns: 'generating' | 'done' | null
+  const getDossierStatus = useCallback((jobId) => {
+    const entry = dossierCache.current.get(jobId);
+    if (!entry) return null;
+    if (entry.loading) return 'generating';
+    if (entry.done) return 'done';
+    return null;
+  }, []);
+
   return {
     text,
     loading,
     error,
     hasKey,
+    mode,
+    hasActiveProcess: Boolean(childRef.current),
+    getDossierStatus,
     summarizeJob,
+    dossier,
     batchReview,
-    clear: () => setText(''),
+    exportDossier,
+    cancel,
+    clear: () => {
+      cancel();
+      setText('');
+      dossierJobId.current = null;
+    },
   };
 }

package/src/tui/useJobs.js

@@ -12,6 +12,7 @@ export function useJobs(api, activeFilters, tab, searchId) {
   const params = useMemo(() => {
     const p = { top: 100, days: 30 };
     if (searchId) p.searchId = searchId;
+    if (api.mode) p.mode = api.mode;
     for (const f of activeFilters || []) {
       if (f.type === 'days') p.days = Number(f.value) || 30;
       if (f.type === 'remote') p.remote = true;
@@ -19,7 +20,7 @@ export function useJobs(api, activeFilters, tab, searchId) {
       if (f.type === 'search') p.search = f.value || '';
     }
     return p;
-  }, [activeFilters, searchId]);
+  }, [activeFilters, searchId, api.mode]);
 
   const paramsKey = JSON.stringify(params);