@evantahler/mcpcli 0.4.0 → 0.5.1

package/{skills → .claude/skills}/mcpcli.md

@@ -90,3 +90,4 @@ mcpcli deauth <server>      # remove stored auth
 | `mcpcli add <name> --command <cmd>`    | Add a stdio MCP server            |
 | `mcpcli add <name> --url <url>`        | Add an HTTP MCP server            |
 | `mcpcli remove <name>`                 | Remove an MCP server              |
+| `mcpcli skill install --claude`        | Install mcpcli skill for Claude   |

package/README.md

@@ -68,6 +68,7 @@ mcpcli search -q "manage pull requests"
 | `mcpcli add <name> --command <cmd>`  | Add a stdio MCP server to your config        |
 | `mcpcli add <name> --url <url>`      | Add an HTTP MCP server to your config        |
 | `mcpcli remove <name>`               | Remove an MCP server from your config        |
+| `mcpcli skill install --claude`      | Install the mcpcli skill for Claude Code     |
 
 ## Options
 
@@ -134,7 +135,7 @@ mcpcli remove my-api --dry-run
 
 ## Configuration
 
-Config lives in `~/.config/mcpcli/` (or the current directory). Three files:
+Config lives in `~/.mcpcli/` (or the current directory). Three files:
 
 ### `servers.json` — MCP Server Definitions
 
@@ -231,18 +232,18 @@ Scenarios and keywords are extracted heuristically from tool names and descripti
 1. `MCP_CONFIG_PATH` environment variable
 2. `-c / --config` flag
 3. `./servers.json` (current directory)
-4. `~/.config/mcpcli/servers.json`
+4. `~/.mcpcli/servers.json`
 
 ## Environment Variables
 
-| Variable          | Purpose                     | Default             |
-| ----------------- | --------------------------- | ------------------- |
-| `MCP_CONFIG_PATH` | Config directory path       | `~/.config/mcpcli/` |
-| `MCP_DEBUG`       | Enable debug output         | `false`             |
-| `MCP_TIMEOUT`     | Request timeout (seconds)   | `1800`              |
-| `MCP_CONCURRENCY` | Parallel server connections | `5`                 |
-| `MCP_MAX_RETRIES` | Retry attempts              | `3`                 |
-| `MCP_STRICT_ENV`  | Error on missing `${VAR}`   | `true`              |
+| Variable          | Purpose                     | Default      |
+| ----------------- | --------------------------- | ------------ |
+| `MCP_CONFIG_PATH` | Config directory path       | `~/.mcpcli/` |
+| `MCP_DEBUG`       | Enable debug output         | `false`      |
+| `MCP_TIMEOUT`     | Request timeout (seconds)   | `1800`       |
+| `MCP_CONCURRENCY` | Parallel server connections | `5`          |
+| `MCP_MAX_RETRIES` | Retry attempts              | `3`          |
+| `MCP_STRICT_ENV`  | Error on missing `${VAR}`   | `true`       |
 
 ## OAuth Flow
 
@@ -405,11 +406,20 @@ cat params.json | mcpcli exec server tool
 
 ### Claude Code Skill
 
-mcpcli ships a Claude Code skill at `skills/mcpcli.md` that teaches Claude Code how to discover and use MCP tools. Install it:
+mcpcli ships a Claude Code skill at `.claude/skills/mcpcli.md` that teaches Claude Code how to discover and use MCP tools. Install it:
 
 ```bash
-# Copy the skill to your global Claude Code skills
-cp skills/mcpcli.md ~/.claude/skills/mcpcli.md
+# Install to the current project (.claude/skills/mcpcli.md)
+mcpcli skill install --claude
+
+# Install globally (~/.claude/skills/mcpcli.md)
+mcpcli skill install --claude --global
+
+# Install to both locations
+mcpcli skill install --claude --global --project
+
+# Overwrite an existing skill file
+mcpcli skill install --claude --force
 ```
 
 Then in any Claude Code session, the agent can use `/mcpcli` or the skill triggers automatically when the agent needs to interact with external services. The skill instructs the agent to:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evantahler/mcpcli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "A command-line interface for MCP servers. curl for MCP.",
   "type": "module",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "files": [
     "src",
-    "skills",
+    ".claude",
     "README.md",
     "LICENSE"
   ],

package/src/cli.ts

@@ -9,6 +9,7 @@ import { registerAuthCommand, registerDeauthCommand } from "./commands/auth.ts";
 import { registerIndexCommand } from "./commands/index.ts";
 import { registerAddCommand } from "./commands/add.ts";
 import { registerRemoveCommand } from "./commands/remove.ts";
+import { registerSkillCommand } from "./commands/skill.ts";
 
 declare const BUILD_VERSION: string | undefined;
 
@@ -33,5 +34,6 @@ registerDeauthCommand(program);
 registerIndexCommand(program);
 registerAddCommand(program);
 registerRemoveCommand(program);
+registerSkillCommand(program);
 
 program.parse();

package/src/commands/skill.ts

@@ -0,0 +1,70 @@
+import type { Command } from "commander";
+import { resolve, dirname, join } from "path";
+import { readFile, mkdir, writeFile, access } from "fs/promises";
+import { homedir } from "os";
+
+export function registerSkillCommand(program: Command) {
+  const skill = program.command("skill").description("manage mcpcli skills");
+
+  skill
+    .command("install")
+    .description("install the mcpcli skill for an AI agent")
+    .requiredOption("--claude", "install for Claude Code")
+    .option("--global", "install to ~/.claude/skills/")
+    .option("--project", "install to ./.claude/skills/ (default)")
+    .option("-f, --force", "overwrite if file already exists")
+    .action(
+      async (options: {
+        claude?: boolean;
+        global?: boolean;
+        project?: boolean;
+        force?: boolean;
+      }) => {
+        // Resolve the bundled skill file
+        const skillSource = resolve(dirname(Bun.main), "..", ".claude", "skills", "mcpcli.md");
+
+        let content: string;
+        try {
+          content = await readFile(skillSource, "utf-8");
+        } catch {
+          console.error(`Could not read skill file: ${skillSource}`);
+          process.exit(1);
+        }
+
+        // Determine targets — default to project if neither flag is set
+        const targets: { label: string; dir: string }[] = [];
+
+        if (options.global) {
+          targets.push({
+            label: "global",
+            dir: join(homedir(), ".claude", "skills"),
+          });
+        }
+        if (options.project || !options.global) {
+          targets.push({
+            label: "project",
+            dir: resolve(".claude", "skills"),
+          });
+        }
+
+        for (const target of targets) {
+          const dest = join(target.dir, "mcpcli.md");
+
+          // Check if file already exists
+          if (!options.force) {
+            try {
+              await access(dest);
+              console.error(`${dest} already exists (use --force to overwrite)`);
+              process.exit(1);
+            } catch {
+              // File doesn't exist — good
+            }
+          }
+
+          await mkdir(target.dir, { recursive: true });
+          await writeFile(dest, content, "utf-8");
+          console.log(`Installed mcpcli skill (${target.label}): ${dest}`);
+        }
+      },
+    );
+}

package/src/config/loader.ts

@@ -11,7 +11,7 @@ import {
   validateSearchIndex,
 } from "./schemas.ts";
 
-const DEFAULT_CONFIG_DIR = join(homedir(), ".config", "mcpcli");
+const DEFAULT_CONFIG_DIR = join(homedir(), ".mcpcli");
 
 const EMPTY_SERVERS: ServersFile = { mcpServers: {} };
 const EMPTY_AUTH: AuthFile = {};
@@ -42,7 +42,7 @@ function resolveConfigDir(configFlag?: string): string {
   // 3. ./servers.json exists in cwd → use cwd
   // (checked at load time, not here — we return the candidate dir)
 
-  // 4. Default ~/.config/mcpcli/
+  // 4. Default ~/.mcpcli/
   return DEFAULT_CONFIG_DIR;
 }