@mcpc-tech/cli 0.1.1-beta.1 → 0.1.1-beta.5

package/README.md

@@ -2,17 +2,37 @@
 
 CLI server for MCPC with configuration support.
 
+## Quick Start
+
+```bash
+# Show help
+npx -y deno run -A jsr:@mcpc/cli/bin --help
+
+# Load configuration from URL
+npx -y deno run -A jsr:@mcpc/cli/bin --config-url \
+  "https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"
+```
+
 ## Configuration
 
 Load configuration using command-line arguments:
 
+- `--help`, `-h` - Show help message
 - `--config <json>` - Inline JSON configuration string
 - `--config-url <url>` - Fetch from URL (e.g., GitHub raw)
 - `--config-file <path>` - Path to configuration file
+- `--request-headers <header>`, `-H <header>` - Add custom HTTP header for URL
+  fetching (can be used multiple times)
 - No arguments - Uses `./mcpc.config.json` if available
 
 ## Usage
 
+**Show help:**
+
+```bash
+npx -y deno run -A jsr:@mcpc/cli/bin --help
+```
+
 **Inline JSON config:**
 
 ```bash
@@ -25,6 +45,15 @@ deno run --allow-all src/bin.ts --config '[{"name":"my-agent","description":"...
 deno run --allow-all src/bin.ts --config-url https://example.com/config.json
 ```
 
+**From URL with custom headers:**
+
+```bash
+deno run --allow-all src/bin.ts \
+  --config-url https://api.example.com/config.json \
+  -H "Authorization: Bearer token123" \
+  -H "X-Custom-Header: value"
+```
+
 **From file:**
 
 ```bash
@@ -75,7 +104,7 @@ When using the Codex Fork configuration:
 Run the example scripts to see different usage patterns:
 
 ```bash
-# P
+# First, set required environment variables
 export GITHUB_PERSONAL_ACCESS_TOKEN="github_pat_your_token"
 
 # Example 1: Inline configuration
@@ -92,6 +121,9 @@ export GITHUB_PERSONAL_ACCESS_TOKEN="github_pat_your_token"
 
 # Example 5: Remote URL config
 ./examples/05-url-config.sh
+
+# Example 6: URL config with custom headers
+./examples/06-url-with-headers.sh
 ```
 
 All examples use the same [codex-fork.json](examples/configs/codex-fork.json)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/cli",
-  "version": "0.1.1-beta.1",
+  "version": "0.1.1-beta.5",
   "homepage": "https://jsr.io/@mcpc/cli",
   "type": "module",
   "exports": {

package/src/bin.mjs

@@ -9,10 +9,10 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/config-plugin.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/config-plugin.js
 var createConfigPlugin, config_plugin_default;
 var init_config_plugin = __esm({
-  "../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/config-plugin.js"() {
+  "../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/config-plugin.js"() {
     createConfigPlugin = () => ({
       name: "built-in-config",
       enforce: "pre",
@@ -29,10 +29,10 @@ var init_config_plugin = __esm({
   }
 });
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/tool-name-mapping-plugin.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/tool-name-mapping-plugin.js
 var createToolNameMappingPlugin, tool_name_mapping_plugin_default;
 var init_tool_name_mapping_plugin = __esm({
-  "../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/tool-name-mapping-plugin.js"() {
+  "../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/tool-name-mapping-plugin.js"() {
     createToolNameMappingPlugin = () => ({
       name: "built-in-tool-name-mapping",
       enforce: "pre",
@@ -56,10 +56,10 @@ var init_tool_name_mapping_plugin = __esm({
   }
 });
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/logging-plugin.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/logging-plugin.js
 var createLoggingPlugin, logging_plugin_default;
 var init_logging_plugin = __esm({
-  "../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/logging-plugin.js"() {
+  "../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/logging-plugin.js"() {
     createLoggingPlugin = (options = {}) => {
       const { enabled = true, verbose = false, compact: compact2 = true } = options;
       return {
@@ -119,7 +119,7 @@ var init_logging_plugin = __esm({
   }
 });
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/index.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/index.js
 var built_in_exports = {};
 __export(built_in_exports, {
   createConfigPlugin: () => createConfigPlugin,
@@ -135,7 +135,7 @@ function getBuiltInPlugins() {
   ];
 }
 var init_built_in = __esm({
-  "../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/index.js"() {
+  "../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugins/built-in/index.js"() {
     init_config_plugin();
     init_tool_name_mapping_plugin();
     init_logging_plugin();
@@ -145,20 +145,20 @@ var init_built_in = __esm({
   }
 });
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/bin.ts
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/bin.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/app.js
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/app.js
 import { OpenAPIHono } from "@hono/zod-openapi";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/controllers/messages.controller.js
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/controllers/messages.controller.js
 import { createRoute } from "@hono/zod-openapi";
 import { z } from "zod";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__utils/src/transport/sse.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__utils/src/transport/sse.js
 import { JSONRPCMessageSchema } from "@modelcontextprotocol/sdk/types.js";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/std__http/server_sent_event_stream.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/std__http/server_sent_event_stream.js
 var NEWLINE_REGEXP = /\r\n|\r|\n/;
 var encoder = new TextEncoder();
 function assertHasNoNewline(value, varName, errPrefix) {
@@ -196,15 +196,15 @@ var ServerSentEventStream = class extends TransformStream {
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/controllers/sse.controller.js
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/controllers/sse.controller.js
 import { createRoute as createRoute2, z as z2 } from "@hono/zod-openapi";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/compose.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/compose.js
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { jsonSchema as jsonSchema3 } from "ai";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__utils/src/json.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__utils/src/json.js
 import { jsonrepair } from "jsonrepair";
 function parseJSON(text, throwError) {
   try {
@@ -226,7 +226,7 @@ function parseJSON(text, throwError) {
   }
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__utils/src/ai.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__utils/src/ai.js
 var p = (template, options = {}) => {
   const { missingVariableHandling = "warn" } = options;
   const names = /* @__PURE__ */ new Set();
@@ -262,7 +262,7 @@ var p = (template, options = {}) => {
   };
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__utils/src/tool-tags.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__utils/src/tool-tags.js
 import { load } from "cheerio";
 function parseTags(htmlString, tags) {
   const $ = load(htmlString, {
@@ -281,13 +281,13 @@ function parseTags(htmlString, tags) {
   };
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/mcp.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/mcp.js
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/registory.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/registory.js
 function connectToSmitheryServer(smitheryConfig) {
   const serverUrl = new URL(smitheryConfig.deploymentUrl);
   serverUrl.searchParams.set("config", btoa(JSON.stringify(smitheryConfig.config)));
@@ -312,7 +312,7 @@ function smitheryToolNameCompatibale(name, scope) {
   };
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/mcp.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/mcp.js
 import { cwd } from "node:process";
 import process2 from "node:process";
 import { createHash } from "node:crypto";
@@ -475,7 +475,7 @@ async function composeMcpDepTools(mcpConfig, filterIn) {
   };
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/schema.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/schema.js
 import traverse from "json-schema-traverse";
 function updateRefPaths(schema, wrapperPath) {
   if (!schema || typeof schema !== "object") {
@@ -507,18 +507,18 @@ function updateRefPaths(schema, wrapperPath) {
   return clonedSchema;
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-tool-registrar.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-tool-registrar.js
 import { jsonSchema } from "ai";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/config.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/config.js
 import process3 from "node:process";
 var GEMINI_PREFERRED_FORMAT = process3.env.GEMINI_PREFERRED_FORMAT === "0" ? false : true;
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/json.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/json.js
 import { jsonrepair as jsonrepair2 } from "jsonrepair";
 import { inspect } from "node:util";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/provider.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/provider.js
 var createGoogleCompatibleJSONSchema = (schema) => {
   if (!GEMINI_PREFERRED_FORMAT) {
     return schema;
@@ -542,7 +542,7 @@ var createGoogleCompatibleJSONSchema = (schema) => {
   return removeAdditionalProperties(cleanSchema);
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/prompts/index.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/prompts/index.js
 var SystemPrompts = {
   /**
    * Base system prompt for autonomous MCP execution
@@ -884,7 +884,7 @@ ${JSON.stringify(steps, null, 2)}`;
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-executor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-executor.js
 import { Ajv } from "ajv";
 import { AggregateAjvError } from "@segment/ajv-human-errors";
 import addFormats from "ajv-formats";
@@ -1016,7 +1016,7 @@ var AgenticExecutor = class {
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/partial.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/partial.js
 function partial(func, ...partialArgs) {
   return partialImpl(func, placeholderSymbol, ...partialArgs);
 }
@@ -1035,7 +1035,7 @@ function partialImpl(func, placeholder, ...partialArgs) {
 var placeholderSymbol = Symbol("partial.placeholder");
 partial.placeholder = placeholderSymbol;
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/partialRight.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/partialRight.js
 function partialRight(func, ...partialArgs) {
   return partialRightImpl(func, placeholderSymbol2, ...partialArgs);
 }
@@ -1056,10 +1056,10 @@ function partialRightImpl(func, placeholder, ...partialArgs) {
 var placeholderSymbol2 = Symbol("partialRight.placeholder");
 partialRight.placeholder = placeholderSymbol2;
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/retry.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/es-toolkit__es-toolkit/src/function/retry.js
 var DEFAULT_RETRIES = Number.POSITIVE_INFINITY;
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/es-toolkit__es-toolkit/src/object/pick.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/es-toolkit__es-toolkit/src/object/pick.js
 function pick(obj, keys) {
   const result = {};
   for (let i = 0; i < keys.length; i++) {
@@ -1071,7 +1071,7 @@ function pick(obj, keys) {
   return result;
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/es-toolkit__es-toolkit/src/string/deburr.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/es-toolkit__es-toolkit/src/string/deburr.js
 var deburrMap = new Map(
   // eslint-disable-next-line no-restricted-syntax
   Object.entries({
@@ -1107,7 +1107,7 @@ var deburrMap = new Map(
   })
 );
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/factories/args-def-factory.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/factories/args-def-factory.js
 var DECISION_OPTIONS = {
   RETRY: "retry",
   PROCEED: "proceed",
@@ -1332,7 +1332,7 @@ NOTE: The \`steps\` has been predefined` : `**You MUST execute this tool with fo
   };
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/sampling/base-sampling-executor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/sampling/base-sampling-executor.js
 import { Ajv as Ajv2 } from "ajv";
 import { AggregateAjvError as AggregateAjvError2 } from "@segment/ajv-human-errors";
 import addFormats2 from "ajv-formats";
@@ -1529,7 +1529,7 @@ VALID: {"key":"value"}` }) {
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/sampling/agentic-sampling-executor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/sampling/agentic-sampling-executor.js
 var SamplingExecutor = class extends BaseSamplingExecutor {
   agenticExecutor;
   constructor(name, description, allToolNames, toolNameToDetailList, server2, config2) {
@@ -1628,7 +1628,7 @@ When the task is complete, I should use "action": "complete".`;
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-tool-registrar.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/agentic/agentic-tool-registrar.js
 function registerAgenticTool(server2, { description, name, allToolNames, depGroups, toolNameToDetailList, sampling = false }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, void 0, void 0);
   const isSamplingMode = sampling === true || typeof sampling === "object";
@@ -1658,10 +1658,10 @@ function registerAgenticTool(server2, { description, name, allToolNames, depGrou
   });
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-tool-registrar.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-tool-registrar.js
 import { jsonSchema as jsonSchema2 } from "ai";
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/state.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/state.js
 var WorkflowState = class {
   currentStepIndex = -1;
   steps = [];
@@ -1830,7 +1830,7 @@ var WorkflowState = class {
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-executor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-executor.js
 import { Ajv as Ajv3 } from "ajv";
 import { AggregateAjvError as AggregateAjvError3 } from "@segment/ajv-human-errors";
 import addFormats3 from "ajv-formats";
@@ -2157,7 +2157,7 @@ ${this.formatProgress(state)}`
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/sampling/workflow-sampling-executor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/sampling/workflow-sampling-executor.js
 var WorkflowSamplingExecutor = class extends BaseSamplingExecutor {
   createArgsDef;
   predefinedSteps;
@@ -2224,7 +2224,7 @@ Current Task: <user_request>${args.userRequest}</user_request>`;
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-tool-registrar.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/executors/workflow/workflow-tool-registrar.js
 function registerAgenticWorkflowTool(server2, { description, name, allToolNames, depGroups, toolNameToDetailList, predefinedSteps, sampling = false, ensureStepActions, toolNameToIdMapping }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, predefinedSteps, ensureStepActions);
   const isSamplingMode = sampling === true || typeof sampling === "object";
@@ -2266,7 +2266,7 @@ function registerAgenticWorkflowTool(server2, { description, name, allToolNames,
   });
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/tool-tag-processor.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/tool-tag-processor.js
 var ALL_TOOLS_PLACEHOLDER = "__ALL__";
 function findToolId(toolName, tools, toolNameMapping) {
   const mappedId = toolNameMapping?.get(toolName);
@@ -2300,10 +2300,10 @@ function processToolTags({ description, tagToResults, $, tools, toolOverrides, t
   return $.root().html() ?? description;
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/compose.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/compose.js
 init_built_in();
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/plugin-utils.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/plugin-utils.js
 function shouldApplyPlugin(plugin, mode) {
   if (!plugin.apply) return true;
   if (typeof plugin.apply === "string") {
@@ -2358,7 +2358,7 @@ async function loadPlugin(pluginPath) {
   }
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/compose.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/compose.js
 var ALL_TOOLS_PLACEHOLDER2 = "__ALL__";
 var ComposableMCPServer = class extends Server {
   tools = [];
@@ -2881,7 +2881,7 @@ var ComposableMCPServer = class extends Server {
   }
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/utils/common/env.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/utils/common/env.js
 import process4 from "node:process";
 var isSCF = () => Boolean(process4.env.SCF_RUNTIME || process4.env.PROD_SCF);
 if (isSCF()) {
@@ -2891,7 +2891,7 @@ if (isSCF()) {
   });
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@jsr/mcpc__core/src/set-up-mcp-compose.js
+// ../__mcpc__cli_0.1.1/node_modules/@jsr/mcpc__core/src/set-up-mcp-compose.js
 function parseMcpcConfigs(conf) {
   const mcpcConfigs = conf ?? [];
   const newMcpcConfigs = [];
@@ -2932,7 +2932,7 @@ async function mcpc(serverConf, composeConf, setupCallback) {
   return server2;
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/app.js
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/app.js
 var createServer = async (config2) => {
   const serverConfig = config2 || {
     name: "large-result-plugin-example",
@@ -2961,10 +2961,59 @@ var createServer = async (config2) => {
   ], serverConfig.agents);
 };
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/config/loader.js
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/config/loader.js
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import process5 from "node:process";
+function printHelp() {
+  console.log(`
+MCPC CLI - Model Context Protocol Composer
+
+USAGE:
+    npx -y deno run -A jsr:@mcpc/cli/bin [OPTIONS]
+
+OPTIONS:
+    --help, -h              Show this help message
+    --config <json>         Inline JSON configuration string
+    --config-url <url>      Fetch configuration from URL
+    --config-file <path>    Load configuration from file path
+    --request-headers <header>, -H <header>
+                           Add custom HTTP header for URL fetching
+                           Format: "Key: Value" or "Key=Value"
+                           Can be used multiple times
+
+EXAMPLES:
+    # Show help
+    npx -y deno run -A jsr:@mcpc/cli/bin --help
+
+    # Load from URL
+    npx -y deno run -A jsr:@mcpc/cli/bin --config-url \\
+      "https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"
+
+    # Load from URL with custom headers
+    npx -y deno run -A jsr:@mcpc/cli/bin \\
+      --config-url "https://api.example.com/config.json" \\
+      -H "Authorization: Bearer token123" \\
+      -H "X-Custom-Header: value"
+
+    # Load from file
+    npx -y deno run -A jsr:@mcpc/cli/bin --config-file ./my-config.json
+
+    # Use default configuration (./mcpc.config.json)
+    npx -y deno run -A jsr:@mcpc/cli/bin
+
+CONFIGURATION:
+    Configuration files support environment variable substitution using $VAR_NAME syntax.
+    
+    Priority order:
+    1. --config (inline JSON)
+    2. --config-url (fetch from URL)
+    3. --config-file (file path)
+    4. ./mcpc.config.json (default)
+
+For more information, visit: https://github.com/mcpc-tech/mcpc
+`);
+}
 function parseArgs() {
   const args = process5.argv.slice(2);
   const result = {};
@@ -2976,12 +3025,31 @@ function parseArgs() {
       result.configUrl = args[++i];
     } else if (arg === "--config-file" && i + 1 < args.length) {
       result.configFile = args[++i];
+    } else if ((arg === "--request-headers" || arg === "-H") && i + 1 < args.length) {
+      const headerStr = args[++i];
+      const colonIdx = headerStr.indexOf(":");
+      const equalIdx = headerStr.indexOf("=");
+      const separatorIdx = colonIdx !== -1 ? equalIdx !== -1 ? Math.min(colonIdx, equalIdx) : colonIdx : equalIdx;
+      if (separatorIdx !== -1) {
+        const key = headerStr.substring(0, separatorIdx).trim();
+        const value = headerStr.substring(separatorIdx + 1).trim();
+        if (!result.requestHeaders) {
+          result.requestHeaders = {};
+        }
+        result.requestHeaders[key] = value;
+      }
+    } else if (arg === "--help" || arg === "-h") {
+      result.help = true;
     }
   }
   return result;
 }
 async function loadConfig() {
   const args = parseArgs();
+  if (args.help) {
+    printHelp();
+    process5.exit(0);
+  }
   if (args.config) {
     try {
       const parsed = JSON.parse(args.config);
@@ -2993,7 +3061,13 @@ async function loadConfig() {
   }
   if (args.configUrl) {
     try {
-      const response = await fetch(args.configUrl);
+      const headers = {
+        "User-Agent": "MCPC-CLI/0.1.0",
+        ...args.requestHeaders
+      };
+      const response = await fetch(args.configUrl, {
+        headers
+      });
       if (!response.ok) {
         throw new Error(`HTTP ${response.status}: ${response.statusText}`);
       }
@@ -3084,7 +3158,7 @@ function normalizeAgents(agents) {
   });
 }
 
-// ../__mcpc__cli_0.1.1-beta.1/node_modules/@mcpc/cli/src/bin.ts
+// ../__mcpc__cli_0.1.1/node_modules/@mcpc/cli/src/bin.ts
 var config = await loadConfig();
 if (config) {
   console.error(`Loaded configuration with ${config.agents.length} agent(s)`);