jobly-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jobly.ai.vn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# jobly-mcp
+
+A CLI to add the [JoblyAI](https://github.com/JoblyAI) MCP server to your OpenCode configuration.
+
+## Quick Start
+
+```bash
+npx jobly-mcp
+```
+
+The CLI will:
+1. Prompt for your JoblyAI API key (masked input)
+2. Ask whether to install globally or in the current project
+3. Write the MCP server config to `opencode.json` (or `opencode.jsonc`)
+
+## Uninstall
+
+```bash
+npx jobly-mcp --uninstall
+```
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `-u, --uninstall` | Remove the jobly-mcp entry instead of adding it |
+| `-y, --yes` | Skip confirmation prompts (overwrite, comment-loss) |
+| `-V, --version` | Print version |
+| `-h, --help` | Print help |
+
+## Where configs are written
+
+| Scope | Path |
+|-------|------|
+| Global | `~/.config/opencode/opencode.jsonc` (or `$XDG_CONFIG_HOME/opencode/opencode.jsonc`) |
+| Local | `<nearest-git-root>/opencode.json` |
+
+## Requirements
+
+- Node.js 20+
+- An OpenCode installation
+- A JoblyAI API key (starts with `jobly_sk_`)

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+
+// src/commands/setup.ts
+import fs4 from "fs";
+
+// src/opencode/config-paths.ts
+import os from "os";
+import path from "path";
+import fs from "fs";
+function getGlobalConfigDir() {
+  const home = os.homedir();
+  const xdg = process.env.XDG_CONFIG_HOME ?? path.join(home, ".config");
+  return path.join(xdg, "opencode");
+}
+function getLocalConfigDir() {
+  let dir = process.cwd();
+  while (true) {
+    if (fs.existsSync(path.join(dir, ".git"))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) return process.cwd();
+    dir = parent;
+  }
+}
+function resolveConfigFile(scope) {
+  const dir = scope === "global" ? getGlobalConfigDir() : getLocalConfigDir();
+  const jsonc = path.join(dir, "opencode.jsonc");
+  const json = path.join(dir, "opencode.json");
+  if (fs.existsSync(jsonc)) return jsonc;
+  if (fs.existsSync(json)) return json;
+  return scope === "global" ? jsonc : json;
+}
+
+// src/opencode/read-config.ts
+import fs2 from "fs";
+import stripJsonComments from "strip-json-comments";
+function readConfig(filePath) {
+  if (!fs2.existsSync(filePath)) {
+    return { kind: "missing" };
+  }
+  const raw = fs2.readFileSync(filePath, "utf8");
+  const stripped = stripJsonComments(raw);
+  const hadComments = stripped !== raw;
+  try {
+    const config = JSON.parse(stripped);
+    return { kind: "ok", config, raw, hadComments };
+  } catch (err) {
+    return { kind: "invalid", error: err.message };
+  }
+}
+
+// src/opencode/write-config.ts
+import fs3 from "fs";
+import path2 from "path";
+
+// src/opencode/types.ts
+var JOBLY_MCP_KEY = "jobly-mcp";
+var JOBLY_MCP_URL = "https://jobly.ai.vn/api/mcp";
+var OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
+function buildJoblyMcpEntry(apiKey) {
+  return {
+    type: "remote",
+    url: JOBLY_MCP_URL,
+    enabled: true,
+    headers: {
+      Authorization: `Bearer ${apiKey}`
+    }
+  };
+}
+function createNewConfig(entry) {
+  return {
+    $schema: OPENCODE_SCHEMA_URL,
+    mcp: {
+      [JOBLY_MCP_KEY]: entry
+    }
+  };
+}
+
+// src/opencode/write-config.ts
+function hasMcpEntry(config) {
+  return Boolean(config.mcp?.[JOBLY_MCP_KEY]);
+}
+function setMcpEntry(config, entry) {
+  return {
+    ...config,
+    mcp: {
+      ...config.mcp ?? {},
+      [JOBLY_MCP_KEY]: entry
+    }
+  };
+}
+function removeMcpEntry(config) {
+  if (!config.mcp) return config;
+  const rest = {};
+  for (const [key, value] of Object.entries(config.mcp)) {
+    if (key !== JOBLY_MCP_KEY) rest[key] = value;
+  }
+  return { ...config, mcp: rest };
+}
+async function writeConfig(filePath, config) {
+  const dir = path2.dirname(filePath);
+  if (!fs3.existsSync(dir)) {
+    fs3.mkdirSync(dir, { recursive: true });
+  }
+  const tmp = filePath + ".tmp";
+  const content = JSON.stringify(config, null, 2) + "\n";
+  fs3.writeFileSync(tmp, content, "utf8");
+  fs3.renameSync(tmp, filePath);
+}
+
+// src/prompts/api-key.ts
+import { password } from "@inquirer/prompts";
+var API_KEY_REGEX = /^jobly_sk_[A-Za-z0-9]{20,}$/;
+function validateApiKey(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return "API key cannot be empty";
+  if (trimmed === "xxx" || trimmed === "your-key-here") return "That looks like a placeholder, not a real key";
+  if (!API_KEY_REGEX.test(trimmed)) {
+    return 'Key must start with "jobly_sk_" followed by at least 20 alphanumeric characters';
+  }
+  return true;
+}
+async function promptApiKey() {
+  const answer = await password({
+    message: "Enter your JoblyAI API key:",
+    mask: "*",
+    validate: validateApiKey
+  });
+  return answer.trim();
+}
+
+// src/prompts/scope.ts
+import { select } from "@inquirer/prompts";
+async function promptScope() {
+  return select({
+    message: "Where should the config be installed?",
+    choices: [
+      {
+        name: "Global (~/.config/opencode/)",
+        value: "global",
+        description: "Available in all projects on this machine"
+      },
+      {
+        name: "Local (current project)",
+        value: "local",
+        description: "Written to the nearest git root as opencode.json"
+      }
+    ]
+  });
+}
+
+// src/prompts/overwrite.ts
+import { confirm } from "@inquirer/prompts";
+async function promptOverwrite() {
+  return confirm({
+    message: "jobly-mcp is already configured. Overwrite?",
+    default: false
+  });
+}
+
+// src/prompts/confirm-comment-loss.ts
+import { confirm as confirm2 } from "@inquirer/prompts";
+async function promptConfirmCommentLoss() {
+  return confirm2({
+    message: "This file contains comments that will be lost when rewriting. Continue?",
+    default: false
+  });
+}
+
+// src/prompts/invalid-config.ts
+import { select as select2 } from "@inquirer/prompts";
+async function promptInvalidConfigAction() {
+  return select2({
+    message: "opencode.json contains invalid JSON. What do you want to do?",
+    choices: [
+      {
+        name: "Abort (recommended)",
+        value: "abort",
+        description: "Exit without making changes. Fix the file manually first."
+      },
+      {
+        name: "Back up the file and continue with a fresh config",
+        value: "backup",
+        description: "Renames the broken file to .bak-<timestamp> and writes a new one"
+      }
+    ]
+  });
+}
+
+// src/utils/logger.ts
+import pc from "picocolors";
+var logger = {
+  info: (msg) => console.log(pc.cyan("\u2139") + " " + msg),
+  success: (msg) => console.log(pc.green("\u2713") + " " + msg),
+  warn: (msg) => console.warn(pc.yellow("\u26A0") + " " + msg),
+  error: (msg) => console.error(pc.red("\u2717") + " " + msg),
+  step: (msg) => console.log(pc.bold("\n" + msg))
+};
+
+// src/commands/setup.ts
+async function runSetup(opts) {
+  const apiKey = await promptApiKey();
+  const scope = await promptScope();
+  const filePath = resolveConfigFile(scope);
+  const result = readConfig(filePath);
+  let config;
+  if (result.kind === "missing") {
+    config = createNewConfig(buildJoblyMcpEntry(apiKey));
+  } else if (result.kind === "invalid") {
+    logger.warn(`opencode.json contains invalid JSON: ${result.error}`);
+    const action = await promptInvalidConfigAction();
+    if (action === "abort") {
+      logger.error("Aborted. Fix the file manually and try again.");
+      process.exit(3);
+    }
+    const backupPath = `${filePath}.bak-${Date.now()}`;
+    fs4.renameSync(filePath, backupPath);
+    logger.info(`Backed up to ${backupPath}`);
+    config = createNewConfig(buildJoblyMcpEntry(apiKey));
+  } else {
+    config = result.config;
+    const hadComments = result.hadComments;
+    if (hasMcpEntry(config) && !opts.force) {
+      const overwrite = await promptOverwrite();
+      if (!overwrite) {
+        logger.info("Aborted, no changes made.");
+        process.exit(130);
+      }
+    }
+    if (hadComments && !opts.force) {
+      const confirm3 = await promptConfirmCommentLoss();
+      if (!confirm3) {
+        logger.info("Aborted, no changes made.");
+        process.exit(130);
+      }
+    }
+    config = setMcpEntry(config, buildJoblyMcpEntry(apiKey));
+  }
+  await writeConfig(filePath, config);
+  logger.success(`jobly-mcp added to ${filePath}`);
+}
+
+// src/commands/uninstall.ts
+async function runUninstall(opts) {
+  const scope = await promptScope();
+  const filePath = resolveConfigFile(scope);
+  const result = readConfig(filePath);
+  if (result.kind === "missing") {
+    logger.info("jobly-mcp is not configured.");
+    process.exit(0);
+  }
+  if (result.kind === "invalid") {
+    logger.warn(`opencode.json contains invalid JSON: ${result.error}`);
+    const action = await promptInvalidConfigAction();
+    if (action === "abort") {
+      logger.error("Aborted. Fix the file manually and try again.");
+      process.exit(3);
+    }
+    logger.info("Preserving the broken file. jobly-mcp not removed.");
+    process.exit(0);
+  }
+  let config = result.config;
+  const hadComments = result.hadComments;
+  if (!hasMcpEntry(config)) {
+    logger.info("jobly-mcp is not configured.");
+    process.exit(0);
+  }
+  if (hadComments && !opts.force) {
+    const confirm3 = await promptConfirmCommentLoss();
+    if (!confirm3) {
+      logger.info("Aborted, no changes made.");
+      process.exit(130);
+    }
+  }
+  config = removeMcpEntry(config);
+  await writeConfig(filePath, config);
+  logger.success(`jobly-mcp removed from ${filePath}`);
+}
+
+// src/utils/exit.ts
+function isCancelError(err) {
+  return err instanceof Error && err.name === "ExitPromptError";
+}
+function handleCliError(err) {
+  if (isCancelError(err)) {
+    console.log("");
+    process.exit(130);
+  }
+  if (err instanceof Error) {
+    logger.error(err.message);
+  } else {
+    logger.error("An unknown error occurred");
+  }
+  if (process.env.DEBUG === "1") {
+    console.error(err);
+  }
+  process.exit(1);
+}
+
+// src/cli.ts
+var program = new Command();
+program.name("jobly-mcp").description("Setup JoblyAI MCP server in your OpenCode config").version("0.1.0").option("-u, --uninstall", "Remove the jobly-mcp entry instead of adding it").option("-y, --yes", "Skip confirmation prompts (overwrite, comment-loss)").action(async (opts) => {
+  if (opts.uninstall) {
+    await runUninstall({ force: opts.yes });
+  } else {
+    await runSetup({ force: opts.yes });
+  }
+});
+program.parseAsync(process.argv).catch(handleCliError);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "jobly-mcp",
+  "version": "0.1.0",
+  "description": "Setup JoblyAI MCP server in your OpenCode config",
+  "type": "module",
+  "bin": {
+    "jobly-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "author": "jobly.ai.vn",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jobly-ai/jobly-mcp.git"
+  },
+  "homepage": "https://jobly.ai.vn",
+  "keywords": [
+    "jobly",
+    "joblyai",
+    "mcp",
+    "model-context-protocol",
+    "opencode",
+    "cli"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1",
+    "strip-json-comments": "^5.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "@vitest/coverage-v8": "^4.1.9",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  }
+}