trackly-cli 0.1.9 → 0.1.12

package/README.md

@@ -7,19 +7,21 @@
 
 The only job tracking CLI built for AI agents.
 
-Search 99,000+ jobs across 775+ companies and 22 ATS types. Track applications, get AI-powered recommendations, and manage your job search -- from the terminal or through Claude Code, Cursor, and other MCP-compatible AI agents.
+Search 128,000+ jobs across 1,900+ companies and 40+ ATS types. Track applications, get AI-powered recommendations, and manage your job search -- from the terminal or through Claude Code, Cursor, and other MCP-compatible AI agents.
 
 ## Quick Start
 
 ```bash
-npm install -g trackly-cli
+npm install -g trackly-cli    # may need: sudo npm install -g trackly-cli
 trackly login
 trackly jobs --function product
 ```
 
+> **Prerequisites:** [Node.js 18+](https://nodejs.org/) (LTS recommended). On macOS with the official `.pkg` installer, global npm installs may require `sudo`.
+
 ## At a Glance
 
-775+ companies | 99K+ jobs | 22 ATS types | CLI + MCP | 10 MCP tools
+1,900+ companies | 128K+ jobs | 40+ ATS types | CLI + MCP | 10 MCP tools
 
 ## CLI Commands
 
@@ -39,6 +41,12 @@ trackly apply 1234                    # Mark as applied
 trackly save 1234                     # Save a job
 trackly dismiss 1234                  # Dismiss a job
 trackly ask "PM jobs in SF"           # Natural language search (20/day)
+trackly contacts "Stripe"             # Search contacts at a company
+trackly brief 1234                    # Get network brief for a job
+trackly referral start 1234           # Start a referral campaign
+trackly referral status 1234          # Check referral campaign status
+trackly company-brief 243             # Get company brief (--refresh to regenerate)
+trackly company-workspace 243         # Full company workspace view
 trackly api-key create                # Generate API key
 trackly api-key list                  # List API keys
 trackly config                        # Show current CLI config
@@ -55,7 +63,13 @@ Add `--json` to any command for JSON output. Use `--api-key <key>` or `--base-ur
 ### One-liner (recommended)
 
 ```bash
-claude mcp add-json trackly '{"command":"trackly","args":["mcp"]}'
+claude mcp add --scope user trackly -- trackly mcp
+```
+
+Or equivalently:
+
+```bash
+claude mcp add-json --scope user trackly '{"command":"trackly","args":["mcp"]}'
 ```
 
 ### Claude Code manual config
@@ -181,7 +195,7 @@ Install trackly-cli (`npm install -g trackly-cli`), authenticate with `trackly l
 
 **What MCP servers exist for job searching?**
 
-trackly-cli includes a built-in MCP server with 10 tools for job search, company lookup, and application tracking. Run `trackly mcp` or add it to Claude Code with `claude mcp add-json trackly '{"command":"trackly","args":["mcp"]}'`. It connects to a live database of 99,000+ jobs across 775+ companies.
+trackly-cli includes a built-in MCP server with 10 tools for job search, company lookup, and application tracking. Run `trackly mcp` or add it to Claude Code with `claude mcp add --scope user trackly -- trackly mcp`. It connects to a live database of 128,000+ jobs across 1,900+ companies.
 
 **How do I use Claude Code for job hunting?**
 
@@ -189,7 +203,7 @@ Add trackly as an MCP server in Claude Code. Then ask questions naturally: "Find
 
 **What are the best CLI tools for job search?**
 
-trackly-cli is the first dedicated job tracking CLI. It provides direct terminal access to 99,000+ job postings across 775+ companies, with filters for job function, location, and work modality. It also integrates with AI agents via the Model Context Protocol (MCP).
+trackly-cli is the first dedicated job tracking CLI. It provides direct terminal access to 128,000+ job postings across 1,900+ companies, with filters for job function, location, and work modality. It also integrates with AI agents via the Model Context Protocol (MCP).
 
 ## Security
 

package/bin/trackly

@@ -214,8 +214,35 @@ async function cmdLogin() {
             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>');
+            res.writeHead(200, { 'Content-Type': 'text/html', 'Referrer-Policy': 'no-referrer' });
+            res.end(`<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Trackly CLI</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0a0a0a;color:#fafafa;display:flex;align-items:center;justify-content:center;min-height:100vh}
+.card{text-align:center;padding:48px 40px;max-width:420px}
+.icon{margin-bottom:24px}
+.check{width:48px;height:48px;border-radius:50%;background:#22c55e;display:inline-flex;align-items:center;justify-content:center;margin-bottom:20px}
+.check svg{width:24px;height:24px}
+h1{font-size:22px;font-weight:600;margin-bottom:8px;letter-spacing:-0.02em}
+p{color:#a1a1aa;font-size:15px;line-height:1.5}
+.hint{margin-top:24px;padding:12px 16px;background:#18181b;border:1px solid #27272a;border-radius:8px;font-family:'SF Mono','Fira Code',monospace;font-size:13px;color:#71717a}
+</style>
+</head>
+<body>
+<div class="card">
+<div class="icon"><svg width="56" height="56" viewBox="0 0 56 56" fill="none"><rect width="56" height="56" rx="14" fill="#18181b"/><path d="M16 20h24v4H16zm0 8h18v4H16zm0 8h22v4H16z" fill="#22c55e" opacity="0.9"/></svg></div>
+<div class="check"><svg fill="none" stroke="white" stroke-width="3" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7"/></svg></div>
+<h1>You're logged in</h1>
+<p>You can close this tab and return to your terminal.</p>
+<div class="hint">trackly search "PM jobs in SF"</div>
+</div>
+</body>
+</html>`);
             console.log(color('green', 'Login successful!'));
             if (hadApiKey) {
               console.log('Switched to OAuth. Stored API key cleared.');
@@ -611,8 +638,12 @@ async function cmdConfig(args) {
 
   if (args['api-key'] !== undefined) {
     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.'));
+    if (keyValue.startsWith('trk_') && keyValue.length < 14) {
+      failNow('Invalid API key: trk_ keys must be at least 14 characters (trk_ + 10). Run "trackly api-key create" to generate a valid key.');
+    } else if (!keyValue.startsWith('trk_') && keyValue.length < 20) {
+      failNow('Invalid API key: key does not start with trk_ and is too short (must be 20+ characters). Run "trackly api-key create" to generate a valid key.');
+    } else if (!keyValue.startsWith('trk_')) {
+      console.log(color('yellow', 'Warning: API key does not start with trk_ prefix. Saving as legacy/JWT key.'));
     }
     const hadToken = Boolean(config.token);
     config.apiKey = keyValue;
@@ -702,7 +733,7 @@ ${color('bold', 'Flags:')}
   --help                Show this help
 
 ${color('bold', 'MCP Setup:')}
-  Claude Code: claude mcp add-json trackly '{"command":"trackly","args":["mcp"]}'
+  Claude Code: claude mcp add --scope user trackly -- trackly mcp
   Cursor: add {"command":"trackly","args":["mcp"]} to .cursor/mcp.json
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackly-cli",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "mcpName": "io.github.kevinastuhuaman/trackly",
   "description": "CLI + MCP server for job tracking — search, apply, and manage applications from terminal or AI agents",
   "bin": {
@@ -35,7 +35,7 @@
     "career",
     "terminal"
   ],
-  "author": "Kevin Astuhuaman <kevin.astuhuaman.flores@gmail.com>",
+  "author": "Kevin Astuhuaman <hello@usetrackly.app>",
   "license": "MIT",
   "repository": {
     "type": "git",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.kevinastuhuaman/trackly",
   "title": "Trackly CLI",
-  "description": "Job tracking CLI + MCP server for AI agents. 99K+ jobs, 775+ companies.",
+  "description": "Job search and application tracking for AI agents. Search 128K+ jobs across 1,900+ companies and 40+ ATS types. Filter by role, location, visa sponsorship. Natural language queries. Works with Claude Code, Cursor, Windsurf, and any MCP client.",
   "repository": {
     "url": "https://github.com/kevinastuhuaman/trackly-cli",
     "source": "github"
@@ -15,12 +15,12 @@
       "sizes": ["512x512"]
     }
   ],
-  "version": "0.1.9",
+  "version": "0.1.12",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "trackly-cli",
-      "version": "0.1.9",
+      "version": "0.1.12",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {
@@ -38,5 +38,19 @@
         "type": "stdio"
       }
     }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.usetrackly.app/api/mcp",
+      "headers": [
+        {
+          "name": "Authorization",
+          "description": "Bearer API key (trk_*). Create one at https://usetrackly.app/settings",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
   ]
 }