@anaclumos/taal 2.0.0 → 2.0.2

package/.github/workflows/publish.yml

@@ -1,9 +1,8 @@
 name: Publish to NPM
 
 on:
-  push:
-    tags:
-      - 'v*' # Triggers on v1.0.0, v1.2.3, etc.
+  release:
+    types: [published]
 
 permissions:
   contents: read

package/AGENTS.md

@@ -64,15 +64,15 @@ npm install -g @anaclumos/taal
 version: "1"
 
 mcp:
-  # TAAL MCP server
+  # TAAL MCP server (requires bun: https://bun.sh)
   taal:
-    command: npx
-    args: ["-y", "@anaclumos/taal", "taal-mcp"]
+    command: bunx
+    args: ["--bun", "taal-mcp"]
 
   # stdio server example
   filesystem:
-    command: npx
-    args: ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
+    command: bunx
+    args: ["--bun", "@modelcontextprotocol/server-filesystem", "/path"]
     env:
       LOG_LEVEL: "info"
   
@@ -175,8 +175,8 @@ vim ~/.taal/config.yaml
 # 2. Add server configuration
 # mcp:
 #   new-server:
-#     command: npx
-#     args: ["-y", "package-name"]
+#     command: bunx
+#     args: ["--bun", "package-name"]
 
 # 3. Validate
 taal validate

package/README.md

@@ -153,15 +153,15 @@ Shows for each provider:
 version: "1"
 
 mcp:
-  # TAAL MCP server
+  # TAAL MCP server (requires bun: https://bun.sh)
   taal:
-    command: npx
-    args: ["-y", "@anaclumos/taal", "taal-mcp"]
+    command: bunx
+    args: ["--bun", "taal-mcp"]
 
   # Stdio server example
   filesystem:
-    command: npx
-    args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
+    command: bunx
+    args: ["--bun", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
     env:
       LOG_LEVEL: "info"
   
@@ -215,13 +215,13 @@ mcp:
 
 ### TAAL MCP Server
 
-TAAL can run as an MCP server to expose its CLI features as tools.
+TAAL can run as an MCP server to expose its CLI features as tools. Requires [Bun](https://bun.sh).
 
 ```yaml
 mcp:
   taal:
-    command: npx
-    args: ["-y", "@anaclumos/taal", "taal-mcp"]
+    command: bunx
+    args: ["--bun", "taal-mcp"]
 ```
 
 Tools exposed:
@@ -527,7 +527,7 @@ taal/
 
 ## Publishing
 
-TAAL uses automated NPM publishing via GitHub Actions.
+TAAL uses automated NPM publishing via GitHub Actions, triggered by GitHub Releases.
 
 ### Release Process
 
@@ -545,11 +545,11 @@ TAAL uses automated NPM publishing via GitHub Actions.
    git push origin main
    ```
 
-3. **Create and push tag**:
-   ```bash
-   git tag v1.0.1
-   git push origin v1.0.1
-   ```
+3. **Create a GitHub Release**:
+   - Go to GitHub → Releases → "Create a new release"
+   - Create a new tag (e.g., `v1.0.1`)
+   - Add release notes
+   - Click "Publish release"
 
 4. **GitHub Actions automatically**:
    - Runs tests
@@ -559,7 +559,7 @@ TAAL uses automated NPM publishing via GitHub Actions.
 ### Prerequisites
 
 Repository maintainers must configure:
-- `NPM_TOKEN` secret in GitHub repository settings
+- NPM trusted publishing (OIDC) - no NPM_TOKEN needed
 - NPM account with 2FA enabled
 - Package access permissions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anaclumos/taal",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "CLI tool to sync MCP server configs and Agent Skills across AI coding assistants",
   "type": "module",
   "bin": {

package/src/commands/collect.ts

@@ -182,8 +182,8 @@ export async function collectAndUpdateConfig(
     version: "1",
     mcp: {
       taal: {
-        command: "npx",
-        args: ["-y", "@anaclumos/taal", "taal-mcp"],
+        command: "bunx",
+        args: ["--bun", "taal-mcp"],
       },
     },
     skills: { paths: ["~/.taal/skills"] },

package/src/commands/init.ts

@@ -4,19 +4,19 @@ import { join } from "node:path";
 import { collect } from "./collect.js";
 
 const SAMPLE_CONFIG = `# TAAL Configuration
-# https://github.com/user/taal
+# https://github.com/anaclumos/taal
 
 version: "1"
 
 mcp:
-  # TAAL MCP server
+  # TAAL MCP server (requires bun: https://bun.sh)
   taal:
-    command: npx
-    args: ["-y", "@anaclumos/taal", "taal-mcp"]
+    command: bunx
+    args: ["--bun", "taal-mcp"]
   # Example stdio server
   # example-server:
-  #   command: npx
-  #   args: ["-y", "@example/mcp-server"]
+  #   command: bunx
+  #   args: ["--bun", "@example/mcp-server"]
   #   env:
   #     API_KEY: "\${API_KEY}"
   

package/src/commands/sync.ts

@@ -70,11 +70,15 @@ export async function sync(
         const taalServers = config.mcp || {};
         const transformedServers = provider.transformMcpServers(taalServers);
 
-        const newConfig = {
+        let newConfig: Record<string, unknown> = {
           ...(currentConfig as object),
           [provider.mcpKey]: transformedServers,
         };
 
+        if (provider.transformConfig) {
+          newConfig = provider.transformConfig(newConfig, taalServers);
+        }
+
         await provider.writeConfig(newConfig, home);
 
         if (provider.skillsPath && config.skills?.paths) {

package/src/index.ts

@@ -1,5 +1,8 @@
 #!/usr/bin/env bun
+import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import { Command } from "commander";
 import { isError } from "es-toolkit/predicate";
@@ -10,15 +13,23 @@ import { list } from "./commands/list";
 import { providers } from "./commands/providers";
 import { sync } from "./commands/sync";
 import { validate } from "./commands/validate";
+import { checkForUpdates } from "./utils/update-checker";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, "..", "package.json"), "utf-8")
+) as { version: string };
 
 const program = new Command();
 
+checkForUpdates().catch(() => undefined);
+
 program
   .name("taal")
   .description(
     "CLI to sync MCP server configs and Agent Skills across AI providers"
   )
-  .version("2.0.0");
+  .version(packageJson.version);
 
 program
   .command("init")

package/src/mcp.ts

@@ -1,12 +1,14 @@
 #!/usr/bin/env bun
+import { readFileSync } from "node:fs";
 import { exists, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { isError } from "es-toolkit/predicate";
 import YAML from "yaml";
-import { z } from "zod/v4";
+import { z } from "zod";
 import { collectAndUpdateConfig } from "./commands/collect.js";
 import { diff } from "./commands/diff.js";
 import { init } from "./commands/init.js";
@@ -16,6 +18,11 @@ import { sync } from "./commands/sync.js";
 import { validate } from "./commands/validate.js";
 import { McpServerSchema, TaalConfigSchema } from "./config/schema.js";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, "..", "package.json"), "utf-8")
+) as { version: string };
+
 function createToolResult(data: unknown) {
   return {
     content: [
@@ -55,8 +62,8 @@ function createDefaultConfig(): RawTaalConfig {
     version: "1",
     mcp: {
       taal: {
-        command: "npx",
-        args: ["-y", "@anaclumos/taal", "taal-mcp"],
+        command: "bunx",
+        args: ["--bun", "taal-mcp"],
       },
     },
     skills: { paths: ["~/.taal/skills"] },
@@ -141,7 +148,7 @@ async function writeValidatedConfig(configPath: string, config: RawTaalConfig) {
 export function createTaalMcpServer() {
   const server = new McpServer({
     name: "taal",
-    version: "2.0.0",
+    version: packageJson.version,
   });
 
   const baseDirSchema = z
@@ -198,10 +205,10 @@ export function createTaalMcpServer() {
     "taal_init",
     {
       description: "Initialize TAAL configuration and collect existing MCPs.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         force: forceSchema,
-      },
+      }),
     },
     async ({ baseDir, force }) => {
       try {
@@ -217,10 +224,10 @@ export function createTaalMcpServer() {
     "taal_config_read",
     {
       description: "Read TAAL config.yaml (parsed and optionally raw).",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         includeRaw: includeRawSchema,
-      },
+      }),
     },
     async ({ baseDir, includeRaw }) => {
       try {
@@ -249,9 +256,9 @@ export function createTaalMcpServer() {
     {
       description:
         "Collect MCP servers from installed providers and merge into config.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
-      },
+      }),
     },
     async ({ baseDir }) => {
       try {
@@ -267,13 +274,13 @@ export function createTaalMcpServer() {
     "taal_mcp_add",
     {
       description: "Add or update an MCP server entry in config.yaml.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         createIfMissing: createIfMissingSchema,
         overwrite: overwriteSchema,
         name: mcpNameSchema,
         server: z.object(mcpServerInputSchema),
-      },
+      }),
     },
     async ({
       baseDir,
@@ -324,11 +331,11 @@ export function createTaalMcpServer() {
     "taal_mcp_delete",
     {
       description: "Delete an MCP server entry from config.yaml.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         errorIfMissing: errorIfMissingSchema,
         name: mcpNameSchema,
-      },
+      }),
     },
     async ({ baseDir, errorIfMissing, name }) => {
       try {
@@ -371,11 +378,11 @@ export function createTaalMcpServer() {
     "taal_skill_path_add",
     {
       description: "Add a skills path to config.yaml.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         createIfMissing: createIfMissingSchema,
         path: skillPathSchema,
-      },
+      }),
     },
     async ({ baseDir, createIfMissing, path }) => {
       try {
@@ -417,11 +424,11 @@ export function createTaalMcpServer() {
     "taal_skill_path_delete",
     {
       description: "Remove a skills path from config.yaml.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         errorIfMissing: errorIfMissingSchema,
         path: skillPathSchema,
-      },
+      }),
     },
     async ({ baseDir, errorIfMissing, path }) => {
       try {
@@ -469,9 +476,9 @@ export function createTaalMcpServer() {
     "taal_validate",
     {
       description: "Validate TAAL configuration.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
-      },
+      }),
     },
     async ({ baseDir }) => {
       try {
@@ -487,10 +494,10 @@ export function createTaalMcpServer() {
     "taal_diff",
     {
       description: "Show pending MCP changes without writing.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         provider: providerSchema,
-      },
+      }),
     },
     async ({ baseDir, provider }) => {
       try {
@@ -506,10 +513,10 @@ export function createTaalMcpServer() {
     "taal_sync",
     {
       description: "Sync MCP configs and skills to enabled providers.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
         provider: providerSchema,
-      },
+      }),
     },
     async ({ baseDir, provider }) => {
       try {
@@ -525,9 +532,9 @@ export function createTaalMcpServer() {
     "taal_list",
     {
       description: "List configured MCP servers, skills, and providers.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
-      },
+      }),
     },
     async ({ baseDir }) => {
       try {
@@ -543,9 +550,9 @@ export function createTaalMcpServer() {
     "taal_providers",
     {
       description: "List supported providers and their status.",
-      inputSchema: {
+      inputSchema: z.object({
         baseDir: baseDirSchema,
-      },
+      }),
     },
     async ({ baseDir }) => {
       try {

package/src/providers/claude-code.ts

@@ -16,14 +16,12 @@ export class ClaudeCodeProvider extends BaseProvider {
 
     for (const [name, server] of Object.entries(servers)) {
       if (server.url) {
-        // HTTP server - Claude Code supports HTTP transport
         transformed[name] = {
           type: "http",
           url: server.url,
           ...(server.headers && { headers: server.headers }),
         };
       } else if (server.command) {
-        // stdio server - Claude Code supports stdio transport
         transformed[name] = {
           type: "stdio",
           command: server.command,
@@ -37,4 +35,21 @@ export class ClaudeCodeProvider extends BaseProvider {
 
     return transformed;
   }
+
+  transformConfig(
+    config: Record<string, unknown>,
+    servers: Record<string, McpServer>
+  ): Record<string, unknown> {
+    const serverNames = Object.keys(servers);
+    const existingEnabled = Array.isArray(config.enabledMcpjsonServers)
+      ? (config.enabledMcpjsonServers as string[])
+      : [];
+
+    const mergedEnabled = [...new Set([...existingEnabled, ...serverNames])];
+
+    return {
+      ...config,
+      enabledMcpjsonServers: mergedEnabled,
+    };
+  }
 }

package/src/providers/types.ts

@@ -85,6 +85,15 @@ export interface Provider {
    * Optional: Transform skills to provider-specific format
    */
   transformSkills?(skills: unknown[]): unknown;
+
+  /**
+   * Optional: Apply additional transformations to the full config
+   * Called after mcpKey is set, allows providers to add extra keys
+   */
+  transformConfig?(
+    config: Record<string, unknown>,
+    servers: Record<string, McpServer>
+  ): Record<string, unknown>;
 }
 
 /**

package/src/utils/update-checker.ts

@@ -0,0 +1,126 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+
+const PACKAGE_NAME = "@anaclumos/taal";
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const CACHE_FILE = join(homedir(), ".taal", ".update-check-cache.json");
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, "..", "..", "package.json");
+const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as {
+  version: string;
+};
+const CURRENT_VERSION = packageJson.version;
+
+interface UpdateCache {
+  lastCheck: number;
+  latestVersion: string | null;
+}
+
+function readCache(): UpdateCache {
+  try {
+    if (existsSync(CACHE_FILE)) {
+      return JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
+    }
+  } catch {
+    return { lastCheck: 0, latestVersion: null };
+  }
+  return { lastCheck: 0, latestVersion: null };
+}
+
+function writeCache(cache: UpdateCache): void {
+  try {
+    writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf-8");
+  } catch {
+    return;
+  }
+}
+
+async function fetchLatestVersion(): Promise<string | null> {
+  try {
+    const response = await fetch(
+      `https://registry.npmjs.org/${PACKAGE_NAME}/latest`
+    );
+    if (!response.ok) {
+      return null;
+    }
+    const data = (await response.json()) as { version?: string };
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+
+function getCurrentVersion(): string {
+  return CURRENT_VERSION;
+}
+
+function compareVersions(current: string, latest: string): number {
+  const currentParts = current.split(".").map(Number);
+  const latestParts = latest.split(".").map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const c = currentParts[i] || 0;
+    const l = latestParts[i] || 0;
+    if (l > c) {
+      return 1;
+    }
+    if (l < c) {
+      return -1;
+    }
+  }
+  return 0;
+}
+
+export async function checkForUpdates(): Promise<void> {
+  const cache = readCache();
+  const now = Date.now();
+
+  if (now - cache.lastCheck < CHECK_INTERVAL_MS && cache.latestVersion) {
+    const current = getCurrentVersion();
+    if (compareVersions(current, cache.latestVersion) > 0) {
+      printUpdateNotice(current, cache.latestVersion);
+    }
+    return;
+  }
+
+  const latestVersion = await fetchLatestVersion();
+  writeCache({ lastCheck: now, latestVersion });
+
+  if (latestVersion) {
+    const current = getCurrentVersion();
+    if (compareVersions(current, latestVersion) > 0) {
+      printUpdateNotice(current, latestVersion);
+    }
+  }
+}
+
+function printUpdateNotice(current: string, latest: string): void {
+  console.log();
+  console.log(
+    chalk.yellow("  ╭─────────────────────────────────────────────────────╮")
+  );
+  console.log(
+    chalk.yellow("  │                                                     │")
+  );
+  console.log(
+    chalk.yellow(
+      `  │   Update available: ${chalk.dim(current)} → ${chalk.green(latest)}                  │`
+    )
+  );
+  console.log(
+    chalk.yellow(
+      `  │   Run ${chalk.cyan("bun add -g @anaclumos/taal")} to update        │`
+    )
+  );
+  console.log(
+    chalk.yellow("  │                                                     │")
+  );
+  console.log(
+    chalk.yellow("  ╰─────────────────────────────────────────────────────╯")
+  );
+  console.log();
+}