@jsonresume/jobs 0.8.0 → 0.10.0

package/README.md

@@ -6,18 +6,30 @@
 
 Search Hacker News "Who is Hiring" jobs matched against your [JSON Resume](https://jsonresume.org). Jobs are semantically ranked using AI embeddings — your resume is compared against hundreds of monthly job postings to surface the best fits.
 
+![demo](./demo.gif)
+
 ## Quick Start
 
+**With a registry account:**
+
 ```bash
 npx @jsonresume/jobs
 ```
 
-That's it. The CLI walks you through login on first run — all you need is a resume hosted at [registry.jsonresume.org](https://registry.jsonresume.org).
+The CLI walks you through login on first run — all you need is a resume hosted at [registry.jsonresume.org](https://registry.jsonresume.org).
+
+**With a local resume file (no account needed):**
+
+```bash
+npx @jsonresume/jobs --resume ./resume.json
+```
+
+Or just drop a `resume.json` in your current directory and run `npx @jsonresume/jobs` — it's auto-detected.
 
 ## Prerequisites
 
 - **Node.js** >= 18
-- A JSON Resume on the [JSON Resume Registry](https://registry.jsonresume.org) (free, backed by your GitHub Gist)
+- A [JSON Resume](https://jsonresume.org/schema/) — either hosted on the [registry](https://registry.jsonresume.org) or as a local `resume.json` file
 - *(Optional)* `OPENAI_API_KEY` — enables AI summaries and batch ranking in the TUI
 
 ## Installation
@@ -57,6 +69,27 @@ To clear saved credentials:
 npx @jsonresume/jobs logout
 ```
 
+## Local Mode (No Account)
+
+You don't need a registry account to use the TUI. If you have a `resume.json` file following the [JSON Resume schema](https://jsonresume.org/schema/), you can use it directly:
+
+```bash
+# Explicit path
+npx @jsonresume/jobs --resume ./my-resume.json
+
+# Auto-detect (looks for resume.json in current directory)
+npx @jsonresume/jobs
+```
+
+In local mode:
+
+- Job matching works the same way (your resume is sent to the server for embedding and vector search)
+- **Marks are saved locally** to `~/.jsonresume/local-marks.json` instead of the server
+- Filters and export work identically
+- Custom search profiles are not available (they require a registry account for server-side storage)
+
+This is useful if you want to try the tool without setting up a registry account, or if you prefer to keep your resume as a local file.
+
 ## Interactive TUI
 
 The default command launches a full terminal interface for browsing and managing jobs.
@@ -65,20 +98,31 @@ The default command launches a full terminal interface for browsing and managing
 npx @jsonresume/jobs
 ```
 
+### Layout
+
+The TUI has three main regions:
+
+- **Header** — shows the app title, active search profile name, tab bar (All / Interested / Applied / Maybe / Passed) with live counts, and any active filter pills
+- **Content area** — job list in list view, or a split-pane layout (40% compact list + 60% job detail) in detail view
+- **Status bar** — context-sensitive keyboard hints, loading/reranking indicators, and toast notifications
+
 ### Features
 
-- **Split-pane detail view** — press Enter to see a compact job list on the left and full details on the right, navigate jobs without leaving the detail panel
-- **Tab-based views** — All / Interested / Applied / Maybe / Passed with live counts
-- **Persistent filters** — remote, salary, keyword, days — saved to disk per search profile
-- **Custom search profiles** — targeted searches like "remote React jobs in climate tech" with AI-powered reranking
+- **Split-pane detail view** — press `Enter` to see a compact job list on the left and full details on the right; navigate jobs with `j`/`k` without leaving the detail panel
+- **Tab-based views** — All / Interested / Applied / Maybe / Passed — always visible with live counts, cycle with `Tab`/`Shift+Tab`
+- **Persistent filters** — remote, salary, keyword, date range — saved to disk per search profile and restored when you switch profiles
+- **Custom search profiles** — targeted searches like "remote React jobs in climate tech" with AI-powered reranking via HyDE embeddings
 - **Two-pass loading** — results appear instantly from vector search, then reshuffle when LLM reranking completes in the background
-- **Batch operations** — select multiple jobs with `v`, then bulk-mark them all at once
-- **Inline search** — press `n` to quickly filter visible jobs by keyword
-- **Export** — press `e` to export your shortlist to a markdown file
-- **Toast notifications** — instant feedback on every action
-- **Help modal** — press `?` for a full keyboard reference
-- **AI summaries** — per-job summaries and batch ranking (requires `OPENAI_API_KEY`)
-- **Vim-style navigation** — `j`/`k`, `g`/`G`, `Ctrl+U`/`Ctrl+D`, `/` for search profiles, `f` for filters
+- **Batch operations** — select multiple jobs with `v`, then bulk-mark them all at once with `i`/`x`/`m`/`p`
+- **Inline search** — press `n` to quickly filter visible jobs by keyword; press `Esc` to clear
+- **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
+- **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
 
 ### Keyboard Shortcuts
 
@@ -95,15 +139,15 @@ npx @jsonresume/jobs
 | `x` | Mark applied |
 | `m` | Mark maybe |
 | `p` | Mark passed |
-| `v` | Toggle batch selection |
+| `v` | Toggle batch selection (selected jobs shown with `●`) |
 | `Tab` / `Shift+Tab` | Next / previous tab |
 | `n` | Inline keyword search |
 | `f` | Manage filters |
 | `/` | Search profiles |
-| `Space` | AI summary |
-| `S` | AI batch review |
+| `Space` | AI summary for current job |
+| `S` | AI batch review of visible jobs |
 | `e` | Export shortlist to markdown |
-| `R` | Force refresh |
+| `R` | Force refresh (bypass cache) |
 | `?` | Help modal |
 | `q` | Quit |
 
@@ -111,22 +155,60 @@ npx @jsonresume/jobs
 
 | Key | Action |
 |-----|--------|
-| `j` / `k` | Navigate jobs (updates detail pane) |
-| `J` / `K` | Scroll detail content |
+| `j` / `k` | Navigate between jobs (updates detail pane) |
+| `J` / `K` | Scroll detail content up / down |
 | `o` | Open HN post in browser |
 | `i` / `x` / `m` / `p` | Mark job state |
 | `Space` | AI summary |
 | `Esc` / `q` | Back to full list |
 
-#### Filters & Search Profiles
+#### Filters Panel
 
 | Key | Action |
 |-----|--------|
-| `a` | Add filter |
-| `d` | Delete filter / search profile |
-| `n` | New search profile |
-| `Enter` | Select / edit |
-| `Esc` | Close |
+| `j` / `k` | Navigate filters |
+| `Enter` | Edit filter value |
+| `a` | Add filter (remote, salary, keyword, days) |
+| `d` | Delete selected filter |
+| `Esc` | Close panel |
+
+#### Search Profiles Panel
+
+| Key | Action |
+|-----|--------|
+| `j` / `k` | Navigate profiles |
+| `Enter` | Switch to selected profile |
+| `n` | Create new search profile |
+| `d` | Delete selected profile |
+| `Esc` | Close panel |
+
+### Job List Columns
+
+In full-width list view, columns are:
+
+| Column | Description |
+|--------|-------------|
+| Score | Cosine similarity (0.00–1.00) between your resume and the job |
+| AI | LLM rerank score (1–10), shown only when a search profile triggers reranking |
+| Title | Job title |
+| Company | Company name |
+| Location | City, country code, remote status |
+| Salary | Parsed salary or `—` if not listed |
+| Status | State icon: ⭐ interested, 📨 applied, ? maybe, ✗ passed |
+
+In split-pane detail view, the left pane shows a compact list with just score, title, and status.
+
+### Tab Views
+
+| Tab | Shows |
+|-----|-------|
+| All | All jobs from the current search (excludes passed/dismissed) |
+| Interested | Jobs you marked with `i` |
+| Applied | Jobs you marked with `x` |
+| Maybe | Jobs you marked with `m` |
+| Passed | Jobs you marked with `p` |
+
+All tabs always appear in the header with their current count. Marking a job moves it between tabs instantly.
 
 ## CLI Commands
 
@@ -140,6 +222,7 @@ npx @jsonresume/jobs detail 181420                       # Full job details
 npx @jsonresume/jobs mark 181420 interested              # Mark a job
 npx @jsonresume/jobs me                                  # Your resume summary
 npx @jsonresume/jobs update ./resume.json                # Update your resume
+npx @jsonresume/jobs logout                              # Remove saved API key
 npx @jsonresume/jobs help                                # All options
 ```
 
@@ -150,7 +233,7 @@ npx @jsonresume/jobs help                                # All options
 | *(default)* | Launch interactive TUI |
 | `search` | Find matching jobs (table output) |
 | `detail <id>` | Show full details for a job |
-| `mark <id> <state>` | Set job state: `interested`, `not_interested`, `applied`, `maybe`, `dismissed` |
+| `mark <id> <state>` | Set job state (see states below) |
 | `me` | Show your resume summary |
 | `update <file>` | Upload a new version of your resume |
 | `logout` | Remove saved API key |
@@ -176,8 +259,8 @@ npx @jsonresume/jobs help                                # All options
 | `interested` | ⭐ | You want this job |
 | `applied` | 📨 | You've applied |
 | `maybe` | ? | Considering it |
-| `not_interested` | ✗ | Not for you |
-| `dismissed` | 👁 | Hide from results |
+| `not_interested` | ✗ | Not for you (hidden from future searches) |
+| `dismissed` | 👁 | Hide from results (hidden from future searches) |
 
 ## How Ranking Works
 
@@ -191,7 +274,7 @@ Job postings from HN's monthly "Who is Hiring?" threads are parsed by GPT into s
 
 ### Stage 2: Vector Similarity Search
 
-Your resume embedding is compared against all job embeddings using cosine similarity via [pgvector](https://github.com/pgvector/pgvector). The top ~500 candidates are retrieved in ~200ms. This is purely semantic — it finds jobs that "sound like" your resume. Jobs you've already passed on are excluded server-side so you always get fresh results.
+Your resume embedding is compared against all job embeddings using cosine similarity via [pgvector](https://github.com/pgvector/pgvector). The top ~500 candidates are retrieved in ~200ms. This is purely semantic — it finds jobs that "sound like" your resume. Jobs you've already passed on or dismissed are excluded server-side (with 5x over-fetch to compensate) so you always get fresh results.
 
 ### Stage 3: Custom Search Profiles
 
@@ -207,11 +290,11 @@ For custom searches, the top 30 vector results are re-scored by `gpt-4.1-mini`.
 
 The final score blends both signals: `0.4 × vector_score + 0.6 × llm_score`. This lets the LLM override semantic similarity — a job that's a great vector match but contradicts your preferences gets pushed down.
 
-In the TUI, this runs as a two-pass load: jobs appear instantly from vector search, then reshuffle when reranking finishes in the background.
+In the TUI, this runs as a two-pass load: jobs appear instantly from vector search, then reshuffle when reranking finishes in the background. The status bar shows "reranking..." while this is in progress.
 
 ### Stage 5: Client-side Filtering
 
-After server-side ranking, the TUI applies local filters (remote only, minimum salary, keyword, days). Filters are persisted per search profile, so switching profiles restores each one's filters.
+After server-side ranking, the TUI applies local filters (remote only, minimum salary, keyword, days). Filters are persisted per search profile to `~/.jsonresume/filters.json`, so switching profiles restores each one's filters automatically.
 
 ## Claude Code Skill
 
@@ -246,11 +329,16 @@ The skill interviews you about what you're looking for, runs multiple searches,
 
 ## Data Storage
 
+All local data is stored under `~/.jsonresume/`:
+
 | Path | Contents |
 |------|----------|
-| `~/.jsonresume/config.json` | API key and username |
+| `~/.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) |
+| `~/.jsonresume/cache/` | Cached job results (auto-expires after 24 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.
 
 ## Contributing
 
@@ -263,6 +351,26 @@ pnpm install
 node packages/job-search/bin/cli.js help
 ```
 
+The TUI is built with [React Ink](https://github.com/vadimdemedes/ink) v6 using a `h()` helper (no JSX). Key source files:
+
+| File | Purpose |
+|------|---------|
+| `bin/cli.js` | Entry point, CLI command routing |
+| `src/auth.js` | Interactive login flow, API key management |
+| `src/tui/App.js` | Main TUI orchestrator, view state, layout |
+| `src/tui/Header.js` | Title bar, tab bar, filter pills |
+| `src/tui/JobList.js` | Responsive job table with flexbox columns |
+| `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/useSearches.js` | Search profile CRUD |
+| `src/filters.js` | Persistent filter storage per search profile |
+| `src/export.js` | Markdown export |
+| `src/localApi.js` | API client for local mode (no registry account) |
+| `src/localState.js` | Local mark storage for local mode |
+| `src/cache.js` | Local result caching with TTL |
+
 See the repo root [CLAUDE.md](../../CLAUDE.md) for code standards and contribution guidelines.
 
 ## License

package/bin/cli.js

@@ -6,7 +6,7 @@
  * Just run:  npx @jsonresume/jobs
  */
 
-const VERSION = '0.8.0';
+const VERSION = '0.10.0';
 
 const BASE_URL =
   getArg('--base-url') ||
@@ -25,6 +25,37 @@ function hasFlag(name) {
   return process.argv.includes(name);
 }
 
+// ── Local resume detection ────────────────────────────────
+
+async function findLocalResume() {
+  const explicitPath = getArg('--resume');
+  if (explicitPath) {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const resolved = path.resolve(explicitPath);
+    try {
+      return JSON.parse(fs.readFileSync(resolved, 'utf-8'));
+    } catch (err) {
+      console.error(`Error reading resume at ${resolved}: ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  // Auto-detect resume.json in CWD
+  const fs = await import('node:fs');
+  const path = await import('node:path');
+  const candidates = ['resume.json', 'Resume.json'];
+  for (const name of candidates) {
+    const filePath = path.resolve(name);
+    try {
+      const raw = fs.readFileSync(filePath, 'utf-8');
+      const resume = JSON.parse(raw);
+      if (resume.basics) return resume;
+    } catch {}
+  }
+  return null;
+}
+
 // ── API client ─────────────────────────────────────────────
 
 let _apiKey;
@@ -87,10 +118,12 @@ function stateIcon(state) {
 
 async function cmdSearch() {
   const params = new URLSearchParams();
-  params.set('top', getArg('--top') || '20');
-  params.set('days', getArg('--days') || '30');
+  const topArg = parseInt(getArg('--top')) || 20;
+  params.set('top', String(Math.min(Math.max(1, topArg), 100)));
+  params.set('days', String(parseInt(getArg('--days')) || 30));
   if (hasFlag('--remote')) params.set('remote', 'true');
-  if (getArg('--min-salary')) params.set('min_salary', getArg('--min-salary'));
+  const minSalary = parseInt(getArg('--min-salary'));
+  if (minSalary > 0) params.set('min_salary', String(minSalary));
   if (getArg('--search')) params.set('search', getArg('--search'));
 
   const { jobs } = await api(`/jobs?${params}`);
@@ -288,6 +321,12 @@ jsonresume-jobs v${VERSION} — Search HN "Who is Hiring" jobs matched to your J
 
 QUICK START
   npx @jsonresume/jobs              Launch the interactive TUI (logs in automatically)
+  npx @jsonresume/jobs --resume resume.json   Use a local resume (no account needed)
+
+LOCAL MODE
+  If a resume.json file exists in the current directory, or you pass --resume,
+  the TUI launches without requiring a registry account. Job matches are fetched
+  from the server using your resume, and marks are saved locally.
 
 COMMANDS
   (default)                         Interactive TUI with AI features
@@ -316,6 +355,7 @@ MARK STATES
   dismissed                         Hide from results
 
 GLOBAL OPTIONS
+  --resume <path>                   Use a local resume file (skips registry auth)
   --json                            Output raw JSON (for piping / Claude Code)
   --base-url URL                    API base URL (default: https://registry.jsonresume.org)
   --feedback "reason"               Add a reason when marking (with mark command)
@@ -326,7 +366,8 @@ ENVIRONMENT
   JSONRESUME_BASE_URL               API base URL override
 
 EXAMPLES
-  npx @jsonresume/jobs                                              # TUI
+  npx @jsonresume/jobs                                              # TUI (registry)
+  npx @jsonresume/jobs --resume ./resume.json                       # TUI (local)
   npx @jsonresume/jobs search --remote --min-salary 150             # CLI search
   npx @jsonresume/jobs detail 181420                                # Job details
   npx @jsonresume/jobs mark 181420 interested --feedback "great"    # Mark job
@@ -366,7 +407,23 @@ async function main() {
     case 'tui':
     case '':
     default: {
-      // Default: launch TUI
+      // Check for local resume first
+      const localResume = await findLocalResume();
+      if (localResume) {
+        console.error(
+          `\n  Using local resume: ${localResume.basics?.name || 'Unknown'}`
+        );
+        console.error('  Marks will be saved locally.\n');
+        const { createLocalApiClient } = await import('../src/localApi.js');
+        const localApi = createLocalApiClient({
+          baseUrl: BASE_URL,
+          resume: localResume,
+        });
+        const { default: runTUI } = await import('../src/tui/App.js');
+        return runTUI({ baseUrl: BASE_URL, apiClient: localApi });
+      }
+
+      // Registry mode
       const apiKey = await getApiKey();
       const { default: runTUI } = await import('../src/tui/App.js');
       return runTUI({ baseUrl: BASE_URL, apiKey });

package/package.json

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

package/src/api.js

@@ -40,7 +40,7 @@ export function createApiClient({ baseUrl, apiKey }) {
     markJob: (id, state, feedback) =>
       request(`/jobs/${id}`, {
         method: 'PUT',
-        body: JSON.stringify({ state, feedback: feedback || state }),
+        body: JSON.stringify({ state, feedback: feedback || undefined }),
       }),
     fetchMe: () => request('/me'),
 

package/src/formatters.js

@@ -39,26 +39,6 @@ export function truncate(str, len) {
   return str.length > len ? str.slice(0, len - 1) + '…' : str;
 }
 
-/**
- * Render a score as a sparkline bar: ████░░░░ 0.72
- * Uses Unicode block characters for sub-character precision.
- */
-const BLOCKS = [' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█'];
-
-export function scoreBar(score, width = 6) {
-  if (typeof score !== 'number' || isNaN(score)) return '░'.repeat(width);
-  const clamped = Math.max(0, Math.min(1, score));
-  const filled = clamped * width;
-  const full = Math.floor(filled);
-  const frac = Math.round((filled - full) * 8);
-  const empty = width - full - (frac > 0 ? 1 : 0);
-  return (
-    '█'.repeat(full) +
-    (frac > 0 ? BLOCKS[frac] : '') +
-    '░'.repeat(Math.max(0, empty))
-  );
-}
-
 export function stateLabel(state) {
   const labels = {
     interested: 'Interested',

package/src/localApi.js

@@ -0,0 +1,72 @@
+import { getMarks, setMark } from './localState.js';
+
+const DEFAULT_BASE_URL = 'https://registry.jsonresume.org';
+
+/**
+ * Creates an API client for local mode — uses a resume JSON object
+ * instead of registry auth. Marks are stored locally.
+ */
+export function createLocalApiClient({ baseUrl, resume }) {
+  const base = baseUrl || DEFAULT_BASE_URL;
+
+  return {
+    fetchJobs: async (params = {}) => {
+      const body = {
+        resume,
+        top: params.top || 50,
+        days: params.days || 30,
+      };
+      if (params.remote) body.remote = true;
+      if (params.minSalary) body.min_salary = params.minSalary;
+      if (params.search) body.search = params.search;
+
+      const res = await fetch(`${base}/api/v1/jobs`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+      });
+      const text = await res.text();
+      let data;
+      try {
+        data = JSON.parse(text);
+      } catch {
+        throw new Error(`Non-JSON response: ${res.status}`);
+      }
+      if (!res.ok) throw new Error(data.error || res.statusText);
+
+      // Overlay local marks onto results
+      const marks = getMarks();
+      const jobs = (data.jobs || []).map((j) => ({
+        ...j,
+        state: marks[String(j.id)] || j.state || null,
+      }));
+
+      return { jobs };
+    },
+
+    fetchJobDetail: async (id) => {
+      // In local mode we don't have a detail endpoint — return
+      // a stub so JobDetail falls back to the job data it already has.
+      return { id };
+    },
+
+    markJob: async (id, state, feedback) => {
+      setMark(id, state);
+      return { id, state, feedback };
+    },
+
+    fetchMe: async () => ({ resume, username: 'local' }),
+
+    // Search profiles not supported in local mode
+    listSearches: async () => ({ searches: [] }),
+    createSearch: async () => {
+      throw new Error('Search profiles require a registry account');
+    },
+    updateSearch: async () => {
+      throw new Error('Search profiles require a registry account');
+    },
+    deleteSearch: async () => {
+      throw new Error('Search profiles require a registry account');
+    },
+  };
+}

package/src/localState.js

@@ -0,0 +1,37 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const DIR = join(homedir(), '.jsonresume');
+const FILE = join(DIR, 'local-marks.json');
+
+function ensureDir() {
+  try {
+    mkdirSync(DIR, { recursive: true });
+  } catch {}
+}
+
+function load() {
+  try {
+    return JSON.parse(readFileSync(FILE, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+function save(data) {
+  ensureDir();
+  writeFileSync(FILE, JSON.stringify(data, null, 2));
+}
+
+/** Get all marks as { jobId: state } */
+export function getMarks() {
+  return load();
+}
+
+/** Set a mark for a job */
+export function setMark(jobId, state) {
+  const marks = load();
+  marks[String(jobId)] = state;
+  save(marks);
+}

package/src/tui/App.js

@@ -36,17 +36,18 @@ const TAB_LABELS = {
 function InlineSearch({ query, onChange, onSubmit }) {
   return h(
     Box,
-    { paddingX: 1 },
-    h(Text, { color: 'yellow', bold: true }, 'Find: '),
-    h(TextInput, { value: query, onChange, onSubmit })
+    { paddingX: 1, gap: 1 },
+    h(Text, { color: 'yellow', bold: true }, 'Find:'),
+    h(TextInput, { value: query, onChange, onSubmit }),
+    h(Text, { dimColor: true }, '  Enter to apply, Esc to clear')
   );
 }
 
-function App({ baseUrl, apiKey }) {
+function App({ baseUrl, apiKey, apiClient }) {
   const { exit } = useApp();
   const api = useMemo(
-    () => createApiClient({ baseUrl, apiKey }),
-    [baseUrl, apiKey]
+    () => apiClient || createApiClient({ baseUrl, apiKey }),
+    [baseUrl, apiKey, apiClient]
   );
 
   // View: 'list' | 'detail' | 'filters' | 'searches' | 'ai' | 'help'
@@ -106,7 +107,18 @@ function App({ baseUrl, apiKey }) {
   const jobs = useMemo(() => {
     if (!appliedQuery) return rawJobs;
     const q = appliedQuery.toLowerCase();
-    return rawJobs.filter((j) => JSON.stringify(j).toLowerCase().includes(q));
+    return rawJobs.filter((j) => {
+      const fields = [
+        j.title,
+        j.company,
+        j.description,
+        j.remote,
+        j.location?.city,
+        j.location?.countryCode,
+        ...(j.skills || []).map((s) => s.name || s),
+      ];
+      return fields.some((f) => f && String(f).toLowerCase().includes(q));
+    });
   }, [rawJobs, appliedQuery]);
 
   useEffect(() => {
@@ -215,7 +227,7 @@ function App({ baseUrl, apiKey }) {
   const handleExport = () => {
     try {
       const filename = exportShortlist(allJobs);
-      showToast(`Exported to ${filename}`, 'export');
+      showToast(`Saved ./${filename}`, 'export');
     } catch (err) {
       showToast(`Export failed: ${err.message}`, 'error');
     }
@@ -389,6 +401,6 @@ function App({ baseUrl, apiKey }) {
   );
 }
 
-export default function runTUI({ baseUrl, apiKey }) {
-  render(h(App, { baseUrl, apiKey }));
+export default function runTUI({ baseUrl, apiKey, apiClient }) {
+  render(h(App, { baseUrl, apiKey, apiClient }));
 }

package/src/tui/FilterManager.js

@@ -124,7 +124,7 @@ export default function FilterManager({ filterState, onUpdate, onClose }) {
               ...next[editIdx],
               value:
                 filter.type === 'minSalary' || filter.type === 'days'
-                  ? parseInt(val) || val
+                  ? parseInt(val) || 0
                   : val,
             };
             onUpdate({ ...filterState, active: next });
@@ -132,11 +132,7 @@ export default function FilterManager({ filterState, onUpdate, onClose }) {
           },
         })
       ),
-      h(
-        Text,
-        { dimColor: true, marginTop: 1 },
-        'Enter to save, Ctrl+C to cancel'
-      )
+      h(Text, { dimColor: true, marginTop: 1 }, 'Enter to save, Esc to cancel')
     );
   }
 
@@ -165,7 +161,7 @@ export default function FilterManager({ filterState, onUpdate, onClose }) {
             if (val.trim()) {
               const value =
                 ft.type === 'minSalary' || ft.type === 'days'
-                  ? parseInt(val) || val
+                  ? parseInt(val) || 0
                   : val;
               onUpdate({
                 ...filterState,

package/src/tui/Header.js

@@ -42,8 +42,6 @@ export default function Header({
   const tabElements = tabs.map((t) => {
     const active = t === tab;
     const count = counts[t] || 0;
-    if (count === 0 && !active && t !== 'all') return null;
-
     const label = `${tabLabels[t]} ${count}`;
 
     if (active) {
@@ -64,7 +62,7 @@ export default function Header({
     );
   });
 
-  const tabRow = h(Box, { paddingX: 1 }, ...tabElements.filter(Boolean));
+  const tabRow = h(Box, { paddingX: 1 }, ...tabElements);
 
   // ── Filter pills (only if active) ────────────────
   const tags = [];

package/src/tui/HelpModal.js

@@ -7,10 +7,12 @@ const SECTIONS = [
     keys: [
       ['j / ↓', 'Move down'],
       ['k / ↑', 'Move up'],
-      ['Enter', 'Open job details'],
+      ['g / G', 'Jump to first / last'],
+      ['Ctrl+U / D', 'Page up / page down'],
+      ['Enter', 'Open split-pane detail view'],
       ['Esc / q', 'Back / quit'],
-      ['Tab', 'Next section tab'],
-      ['Shift+Tab', 'Previous section tab'],
+      ['Tab', 'Next tab'],
+      ['Shift+Tab', 'Previous tab'],
     ],
   },
   {
@@ -20,28 +22,31 @@ const SECTIONS = [
       ['x', 'Mark applied'],
       ['m', 'Mark maybe'],
       ['p', 'Mark passed'],
+      ['v', 'Toggle batch selection'],
     ],
   },
   {
     title: 'Search & Filter',
     keys: [
+      ['n', 'Inline keyword search'],
       ['/', 'Search profiles'],
       ['f', 'Manage filters'],
-      ['R', 'Force refresh'],
+      ['e', 'Export shortlist to markdown'],
+      ['R', 'Force refresh (bypass cache)'],
     ],
   },
   {
-    title: 'AI Features',
+    title: 'Detail View',
     keys: [
-      ['Space', 'AI summary of job'],
-      ['S', 'AI batch review'],
+      ['J / K', 'Scroll detail content'],
+      ['o', 'Open HN post in browser'],
     ],
   },
   {
-    title: 'Detail View',
+    title: 'AI Features (requires OPENAI_API_KEY)',
     keys: [
-      ['o', 'Open HN post in browser'],
-      ['e', 'Export shortlist to markdown'],
+      ['Space', 'AI summary of current job'],
+      ['S', 'AI batch review of visible jobs'],
     ],
   },
 ];
@@ -68,7 +73,7 @@ export default function HelpModal({ onClose }) {
     h(
       Box,
       { justifyContent: 'center', marginBottom: 1 },
-      h(Text, { bold: true, color: 'cyan' }, '⌨  Keyboard Shortcuts')
+      h(Text, { bold: true, color: 'cyan' }, 'Keyboard Shortcuts')
     ),
     ...SECTIONS.flatMap((section) => [
       h(

package/src/tui/JobDetail.js

@@ -23,7 +23,8 @@ export default function JobDetail({
     api
       .fetchJobDetail(job.id)
       .then((d) => {
-        setDetail(d);
+        // If the detail response only has an id (local mode), use the job data we already have
+        setDetail(d?.title ? d : null);
         setLoading(false);
       })
       .catch(() => setLoading(false));

package/src/tui/SearchManager.js

@@ -73,7 +73,7 @@ export default function SearchManager({
         h(
           Text,
           { color: 'magenta' },
-          ' Creating search profile... (AI is blending your resume with the prompt)'
+          ' Creating profile — generating a custom embedding from your resume + search prompt…'
         )
       )
     );
@@ -110,7 +110,7 @@ export default function SearchManager({
       h(
         Text,
         { dimColor: true, marginTop: 1 },
-        'Enter to continue, Ctrl+C to cancel'
+        'Enter to continue, Esc to cancel'
       )
     );
   }
@@ -153,7 +153,7 @@ export default function SearchManager({
       h(
         Text,
         { dimColor: true, marginTop: 1 },
-        'Enter to create, Ctrl+C to cancel'
+        'Enter to create, Esc to cancel'
       )
     );
   }

package/src/tui/StatusBar.js

@@ -21,6 +21,10 @@ const KEYS = {
     ['space', 'AI'],
     ['esc', 'back'],
   ],
+  search: [
+    ['esc', 'clear search'],
+    ['enter', 'apply'],
+  ],
   filters: [
     ['j/k', 'nav'],
     ['enter', 'edit'],
@@ -67,14 +71,21 @@ export default function StatusBar({
     h(Text, { dimColor: true }, '─'.repeat(Math.max(10, cols - 2)))
   );
 
-  const rightInfo = h(
-    Box,
-    { gap: 1 },
-    loading ? h(Text, { color: 'yellow' }, 'loading…') : null,
-    reranking ? h(Text, { color: 'magenta' }, 'reranking…') : null,
-    h(Text, { dimColor: true }, `${jobCount}/${totalCount}`),
-    aiEnabled ? null : h(Text, { dimColor: true }, 'no-AI')
+  const rightParts = [];
+  if (loading)
+    rightParts.push(h(Text, { key: 'l', color: 'yellow' }, 'loading…'));
+  if (reranking)
+    rightParts.push(h(Text, { key: 'r', color: 'magenta' }, 'reranking…'));
+  rightParts.push(
+    h(Text, { key: 'c', dimColor: true }, `${jobCount}/${totalCount}`)
   );
+  if (!aiEnabled) {
+    rightParts.push(
+      h(Text, { key: 'ai', dimColor: true }, 'set OPENAI_API_KEY for AI')
+    );
+  }
+
+  const rightInfo = h(Box, { gap: 1 }, ...rightParts);
 
   const content = toast
     ? h(Box, { paddingX: 1, justifyContent: 'space-between' }, toast, rightInfo)

package/src/tui/useAI.js

@@ -11,7 +11,9 @@ export function useAI(resume) {
   const summarizeJob = useCallback(
     async (job) => {
       if (!hasKey) {
-        setError('Set OPENAI_API_KEY to enable AI features');
+        setError(
+          'AI requires OPENAI_API_KEY — run: export OPENAI_API_KEY=sk-...'
+        );
         return;
       }
       setLoading(true);
@@ -57,7 +59,9 @@ export function useAI(resume) {
   const batchReview = useCallback(
     async (jobs) => {
       if (!hasKey) {
-        setError('Set OPENAI_API_KEY to enable AI features');
+        setError(
+          'AI requires OPENAI_API_KEY — run: export OPENAI_API_KEY=sk-...'
+        );
         return;
       }
       setLoading(true);

package/src/tui/PreviewPane.js

@@ -1,68 +0,0 @@
-import { Box, Text } from 'ink';
-import { h } from './h.js';
-import { formatSalary, formatLocation, stateIcon } from '../formatters.js';
-
-export default function PreviewPane({ job }) {
-  if (!job) return null;
-
-  const cols = process.stdout.columns || 80;
-  const loc = formatLocation(job.location, job.remote);
-  const sal = formatSalary(job.salary, job.salary_usd);
-  const icon = stateIcon(job.state);
-
-  const skills = job.skills
-    ? job.skills
-        .slice(0, 8)
-        .map((s) => s.name || s)
-        .join(' · ')
-    : null;
-
-  const desc = job.description
-    ? job.description.replace(/\n/g, ' ').slice(0, cols * 2)
-    : null;
-
-  return h(
-    Box,
-    {
-      flexDirection: 'column',
-      borderStyle: 'single',
-      borderColor: 'gray',
-      borderTop: true,
-      borderBottom: false,
-      borderLeft: false,
-      borderRight: false,
-      paddingX: 1,
-    },
-    // Title line
-    h(
-      Box,
-      { gap: 1 },
-      h(Text, { bold: true, color: 'white' }, job.title || '—'),
-      h(Text, { dimColor: true }, 'at'),
-      h(Text, { bold: true, color: 'cyan' }, job.company || '—'),
-      job.state ? h(Text, null, ` ${icon}`) : null
-    ),
-    // Meta line
-    h(
-      Box,
-      { gap: 2 },
-      h(Text, { dimColor: true }, `📍 ${loc}`),
-      h(Text, { dimColor: true }, `💰 ${sal}`),
-      job.experience
-        ? h(Text, { dimColor: true }, `📊 ${job.experience}`)
-        : null,
-      job.url ? h(Text, { color: 'blue', dimColor: true }, 'o:open') : null
-    ),
-    // Skills
-    skills
-      ? h(
-          Box,
-          null,
-          h(Text, { color: 'yellow' }, 'Skills: '),
-          h(Text, { dimColor: true }, skills)
-        )
-      : null,
-    // Description snippet
-    desc ? h(Text, { dimColor: true, wrap: 'truncate-end' }, desc) : null
-  );
-}