poe-code 3.0.107 → 3.0.109

package/dist/index.js

@@ -558,6 +558,12 @@ var init_src2 = __esm({
 });
 
 // packages/poe-code-config/src/schema.ts
+function defineScope(scope, schema) {
+  return {
+    scope,
+    schema
+  };
+}
 var init_schema = __esm({
   "packages/poe-code-config/src/schema.ts"() {
     "use strict";
@@ -885,16 +891,16 @@ function getConfigFormat(pathOrFormat) {
   }
   return formatRegistry[formatName];
 }
-function detectFormat(path27) {
-  const ext = getExtension(path27);
+function detectFormat(path28) {
+  const ext = getExtension(path28);
   return extensionMap[ext];
 }
-function getExtension(path27) {
-  const lastDot = path27.lastIndexOf(".");
+function getExtension(path28) {
+  const lastDot = path28.lastIndexOf(".");
   if (lastDot === -1) {
     return "";
   }
-  return path27.slice(lastDot).toLowerCase();
+  return path28.slice(lastDot).toLowerCase();
 }
 var formatRegistry, extensionMap;
 var init_formats = __esm({
@@ -1787,6 +1793,92 @@ var init_models = __esm({
   }
 });
 
+// packages/poe-code-config/src/inspect.ts
+import path4 from "node:path";
+function collectEnvOverrides(scopes, env) {
+  const document = {};
+  const entries = [];
+  for (const definition of scopes) {
+    const scopeResult = collectScopeEnvOverrides(definition, env);
+    if (Object.keys(scopeResult.values).length === 0) {
+      continue;
+    }
+    document[definition.scope] = scopeResult.values;
+    entries.push(...scopeResult.entries);
+  }
+  return { entries, document };
+}
+async function resolveEditTarget(fs3, configPath, projectConfigPath, options) {
+  if (options.global && options.project) {
+    throw new Error("Choose either --global or --project, not both.");
+  }
+  if (options.global) {
+    return configPath;
+  }
+  if (options.project) {
+    return projectConfigPath;
+  }
+  if (await pathExists(fs3, projectConfigPath)) {
+    return projectConfigPath;
+  }
+  return configPath;
+}
+async function initProjectConfig(fs3, targetPath) {
+  if (await pathExists(fs3, targetPath)) {
+    return "already-exists";
+  }
+  await fs3.mkdir(path4.dirname(targetPath), { recursive: true });
+  await fs3.writeFile(targetPath, EMPTY_DOCUMENT2, { encoding: "utf8" });
+  return "created";
+}
+function collectScopeEnvOverrides(definition, env) {
+  const entries = [];
+  const values = {};
+  for (const [key, field] of Object.entries(definition.schema)) {
+    if (!field.env) {
+      continue;
+    }
+    const value = coerceEnvValue(field.type, env[field.env]);
+    if (value === void 0) {
+      continue;
+    }
+    values[key] = value;
+    entries.push(`  ${field.env} = ${String(value)}`);
+  }
+  return { entries, values };
+}
+function coerceEnvValue(type, raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (type === "string") {
+    return raw;
+  }
+  if (type === "number") {
+    if (raw.length === 0) {
+      return void 0;
+    }
+    const parsed = Number(raw);
+    return Number.isNaN(parsed) ? void 0 : parsed;
+  }
+  if (raw === "true" || raw === "1") {
+    return true;
+  }
+  if (raw === "false" || raw === "0") {
+    return false;
+  }
+  return void 0;
+}
+var EMPTY_DOCUMENT2;
+var init_inspect = __esm({
+  "packages/poe-code-config/src/inspect.ts"() {
+    "use strict";
+    init_src3();
+    EMPTY_DOCUMENT2 = `${JSON.stringify({}, null, 2)}
+`;
+  }
+});
+
 // packages/poe-code-config/src/index.ts
 var init_src4 = __esm({
   "packages/poe-code-config/src/index.ts"() {
@@ -1796,6 +1888,7 @@ var init_src4 = __esm({
     init_merge();
     init_models();
     init_resolve();
+    init_inspect();
     init_store();
   }
 });
@@ -1807,38 +1900,38 @@ import { createTwoFilesPatch } from "diff";
 import chalk from "chalk";
 function createDryRunFileSystem(base, recorder) {
   const proxy = {
-    async readFile(path27, encoding) {
+    async readFile(path28, encoding) {
       if (encoding) {
-        return base.readFile(path27, encoding);
+        return base.readFile(path28, encoding);
       }
-      return base.readFile(path27);
+      return base.readFile(path28);
     },
-    async writeFile(path27, data, options) {
-      const previousContent = await tryReadText(base, path27);
+    async writeFile(path28, data, options) {
+      const previousContent = await tryReadText(base, path28);
       const nextContent = formatData(data, options?.encoding);
       recorder.record({
         type: "writeFile",
-        path: path27,
+        path: path28,
         nextContent,
         previousContent
       });
     },
-    async mkdir(path27, options) {
-      recorder.record({ type: "mkdir", path: path27, options });
+    async mkdir(path28, options) {
+      recorder.record({ type: "mkdir", path: path28, options });
     },
-    async stat(path27) {
-      return base.stat(path27);
+    async stat(path28) {
+      return base.stat(path28);
     },
-    async unlink(path27) {
-      recorder.record({ type: "unlink", path: path27 });
+    async unlink(path28) {
+      recorder.record({ type: "unlink", path: path28 });
     },
-    async readdir(path27) {
-      return base.readdir(path27);
+    async readdir(path28) {
+      return base.readdir(path28);
     }
   };
   if (typeof base.rm === "function") {
-    proxy.rm = async (path27, options) => {
-      recorder.record({ type: "rm", path: path27, options });
+    proxy.rm = async (path28, options) => {
+      recorder.record({ type: "rm", path: path28, options });
     };
   }
   if (typeof base.copyFile === "function") {
@@ -1928,8 +2021,8 @@ function describeWriteChange(previous, next) {
   }
   return "update";
 }
-function renderWriteCommand(path27, change) {
-  const command = `cat > ${path27}`;
+function renderWriteCommand(path28, change) {
+  const command = `cat > ${path28}`;
   if (change === "create") {
     return renderOperationCommand(command, chalk.green, "# create");
   }
@@ -2091,9 +2184,9 @@ function redactTomlLine(line) {
   }
   return line;
 }
-async function tryReadText(base, path27) {
+async function tryReadText(base, path28) {
   try {
-    return await base.readFile(path27, "utf8");
+    return await base.readFile(path28, "utf8");
   } catch (error2) {
     if (isNotFound(error2)) {
       return null;
@@ -2275,7 +2368,7 @@ var init_context = __esm({
 });
 
 // src/cli/isolated-env.ts
-import path4 from "node:path";
+import path5 from "node:path";
 async function resolveIsolatedEnvDetails(env, isolated, providerName, readApiKey) {
   if (!providerName) {
     throw new Error("resolveIsolatedEnvDetails requires providerName.");
@@ -2297,7 +2390,7 @@ function resolveIsolatedTargetDirectory(input) {
   const expanded = expandHomeShortcut(input.env, input.targetDirectory);
   const baseDir = resolveIsolatedBaseDir(input.env, input.providerName);
   const homeDir = input.env.homeDir;
-  const homeDirWithSep = `${homeDir}${path4.sep}`;
+  const homeDirWithSep = `${homeDir}${path5.sep}`;
   if (expanded !== homeDir && !expanded.startsWith(homeDirWithSep)) {
     throw new Error(
       `Isolated config targets must live under the user's home directory (received "${input.targetDirectory}").`
@@ -2312,7 +2405,7 @@ function resolveIsolatedTargetDirectory(input) {
   if (!expanded.startsWith(homeDirWithSep)) {
     return expanded;
   }
-  const mapped = path4.join(baseDir, expanded.slice(homeDirWithSep.length));
+  const mapped = path5.join(baseDir, expanded.slice(homeDirWithSep.length));
   return stripAgentHome(mapped, baseDir, input.isolated.agentBinary);
 }
 function resolveIsolatedBaseDir(env, providerName) {
@@ -2361,9 +2454,9 @@ async function resolveIsolatedEnvValue(env, baseDir, value, readApiKey) {
 function resolveIsolatedEnvPath(env, baseDir, value) {
   switch (value.kind) {
     case "isolatedDir":
-      return value.relativePath ? path4.join(baseDir, value.relativePath) : baseDir;
+      return value.relativePath ? path5.join(baseDir, value.relativePath) : baseDir;
     case "isolatedFile":
-      return path4.join(baseDir, value.relativePath);
+      return path5.join(baseDir, value.relativePath);
   }
 }
 function isEnvVarReference(value) {
@@ -2405,10 +2498,10 @@ async function applyIsolatedEnvRepairs(input) {
     if (repair.kind !== "chmod") {
       continue;
     }
-    if (path4.isAbsolute(repair.relativePath)) {
+    if (path5.isAbsolute(repair.relativePath)) {
       continue;
     }
-    const repairPath = path4.join(baseDir, repair.relativePath);
+    const repairPath = path5.join(baseDir, repair.relativePath);
     try {
       await input.fs.chmod(repairPath, repair.mode);
     } catch (error2) {
@@ -2459,13 +2552,13 @@ async function resolveCliSettingValue(value, env, readApiKey) {
 }
 function stripAgentHome(mapped, baseDir, agentBinary) {
   const agentDir = `.${agentBinary}`;
-  const prefix = path4.join(baseDir, agentDir);
+  const prefix = path5.join(baseDir, agentDir);
   if (mapped === prefix) {
     return baseDir;
   }
-  const withSep = `${prefix}${path4.sep}`;
+  const withSep = `${prefix}${path5.sep}`;
   if (mapped.startsWith(withSep)) {
-    return path4.join(baseDir, mapped.slice(withSep.length));
+    return path5.join(baseDir, mapped.slice(withSep.length));
   }
   return mapped;
 }
@@ -2476,11 +2569,11 @@ function expandHomeShortcut(env, input) {
   if (input === "~") {
     return env.homeDir;
   }
-  if (input.startsWith("~/") || input.startsWith(`~${path4.sep}`)) {
-    return path4.join(env.homeDir, input.slice(2));
+  if (input.startsWith("~/") || input.startsWith(`~${path5.sep}`)) {
+    return path5.join(env.homeDir, input.slice(2));
   }
-  if (input.startsWith("~./") || input.startsWith(`~.${path4.sep}`)) {
-    return path4.join(env.homeDir, `.${input.slice(3)}`);
+  if (input.startsWith("~./") || input.startsWith(`~.${path5.sep}`)) {
+    return path5.join(env.homeDir, `.${input.slice(3)}`);
   }
   return input;
 }
@@ -3923,21 +4016,21 @@ async function* adaptClaude(lines) {
         if (blockType !== "tool_result") continue;
         const kind = toolKindsById.get(item.tool_use_id);
         toolKindsById.delete(item.tool_use_id);
-        let path27;
+        let path28;
         if (typeof item.content === "string") {
-          path27 = item.content;
+          path28 = item.content;
         } else {
           try {
-            path27 = JSON.stringify(item.content);
+            path28 = JSON.stringify(item.content);
           } catch {
-            path27 = String(item.content);
+            path28 = String(item.content);
           }
         }
         yield {
           event: "tool_complete",
           id: item.tool_use_id,
           kind,
-          path: path27
+          path: path28
         };
       }
     }
@@ -4059,10 +4152,10 @@ async function* adaptCodex(lines) {
         const kindFromStart = toolKindById.get(item.id);
         const kind = kindFromStart ?? (itemType === "command_execution" ? "exec" : itemType === "file_edit" ? "edit" : "other");
         const titleFromEvent = isNonEmptyString(item.path) ? item.path : itemType === "mcp_tool_call" ? `${isNonEmptyString(item.server) ? item.server : "unknown"}.${isNonEmptyString(item.tool) ? item.tool : "unknown"}` : void 0;
-        const path27 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
+        const path28 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
         toolTitleById.delete(item.id);
         toolKindById.delete(item.id);
-        yield { event: "tool_complete", id: item.id, kind, path: path27 };
+        yield { event: "tool_complete", id: item.id, kind, path: path28 };
       }
     }
   }
@@ -4504,7 +4597,7 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   }
   const id = readString(event.id);
   const kind = readString(event.kind);
-  const path27 = readString(event.path);
+  const path28 = readString(event.path);
   let toolCall = id ? toolCallsById.get(id) : void 0;
   if (!toolCall) {
     toolCall = {};
@@ -4519,8 +4612,8 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   if (kind) {
     toolCall.kind = kind;
   }
-  if (path27) {
-    toolCall.path = path27;
+  if (path28) {
+    toolCall.path = path28;
   }
 }
 var sessionCapture;
@@ -4606,7 +4699,7 @@ var init_usage_capture = __esm({
 });
 
 // packages/agent-spawn/src/acp/middlewares/spawn-log.ts
-import path5 from "node:path";
+import path6 from "node:path";
 import { homedir as homedir2 } from "node:os";
 import { mkdir, open } from "node:fs/promises";
 function pad(value, width) {
@@ -4640,11 +4733,11 @@ function resolveStartedAt(value) {
   return value;
 }
 function resolveLogFilePath(ctx) {
-  const baseDir = ctx.logDir ?? path5.join(homedir2(), ".poe-code", "spawn-logs");
+  const baseDir = ctx.logDir ?? path6.join(homedir2(), ".poe-code", "spawn-logs");
   const startedAt = resolveStartedAt(ctx.startedAt);
   const { day, time: time3, milliseconds } = formatTimestamp(startedAt);
   const fileName = `${day}-${time3}-${milliseconds}-${normalizeAgent(ctx.agent)}.jsonl`;
-  return path5.join(baseDir, fileName);
+  return path6.join(baseDir, fileName);
 }
 async function writePreloadedEvents(writer, events) {
   for (const event of events) {
@@ -4662,7 +4755,7 @@ var init_spawn_log = __esm({
       logDirPath;
       constructor(ctx) {
         this.logFilePath = resolveLogFilePath(ctx);
-        this.logDirPath = path5.dirname(this.logFilePath);
+        this.logDirPath = path6.dirname(this.logFilePath);
       }
       async writeEvent(event) {
         if (this.isDisabled) {
@@ -4747,7 +4840,7 @@ var init_src6 = __esm({
 });
 
 // src/cli/commands/shared.ts
-import path6 from "node:path";
+import path7 from "node:path";
 function resolveCommandFlags(program) {
   const opts = program.optsWithGlobals();
   return {
@@ -4820,7 +4913,7 @@ function buildResumeCommand(canonicalService, threadId, cwd) {
   if (!binaryName) {
     return void 0;
   }
-  const resumeCwd = path6.resolve(cwd);
+  const resumeCwd = path7.resolve(cwd);
   const args = spawnConfig.resumeCommand(threadId, resumeCwd);
   const agentCommand = [binaryName, ...args.map(shlexQuote)].join(" ");
   const needsCdPrefix = !args.includes(resumeCwd);
@@ -4917,7 +5010,7 @@ var init_shared = __esm({
 });
 
 // src/sdk/spawn-core.ts
-import path7 from "node:path";
+import path8 from "node:path";
 import chalk10 from "chalk";
 async function spawnCore(container, service, options, flags = { dryRun: false, verbose: false }) {
   const adapter = container.registry.get(service);
@@ -5035,10 +5128,10 @@ function resolveSpawnWorkingDirectory(baseDir, candidate) {
   if (!candidate || candidate.trim().length === 0) {
     return void 0;
   }
-  if (path7.isAbsolute(candidate)) {
+  if (path8.isAbsolute(candidate)) {
     return candidate;
   }
-  return path7.resolve(baseDir, candidate);
+  return path8.resolve(baseDir, candidate);
 }
 var init_spawn_core = __esm({
   "src/sdk/spawn-core.ts"() {
@@ -5050,7 +5143,7 @@ var init_spawn_core = __esm({
 });
 
 // src/cli/environment.ts
-import path8 from "node:path";
+import path9 from "node:path";
 function createCliEnvironment(init) {
   const platform = init.platform ?? process.platform;
   const variables = init.variables ?? process.env;
@@ -5058,7 +5151,7 @@ function createCliEnvironment(init) {
   const projectConfigPath = resolveProjectConfigPath(init.cwd);
   const logDir = resolveLogDir(init.homeDir);
   const { poeApiBaseUrl, poeBaseUrl } = resolvePoeBaseUrls(variables);
-  const resolveHomePath = (...segments) => path8.join(init.homeDir, ...segments);
+  const resolveHomePath = (...segments) => path9.join(init.homeDir, ...segments);
   const getVariable = (name) => variables[name];
   return {
     cwd: init.cwd,
@@ -5075,7 +5168,7 @@ function createCliEnvironment(init) {
   };
 }
 function resolveLogDir(homeDir) {
-  return path8.join(homeDir, ".poe-code", "logs");
+  return path9.join(homeDir, ".poe-code", "logs");
 }
 function resolvePoeBaseUrls(variables) {
   const raw = variables.POE_BASE_URL;
@@ -5970,7 +6063,7 @@ var init_logger2 = __esm({
 });
 
 // src/cli/error-logger.ts
-import path9 from "node:path";
+import path10 from "node:path";
 var DEFAULT_MAX_SIZE, DEFAULT_MAX_BACKUPS, ErrorLogger;
 var init_error_logger = __esm({
   "src/cli/error-logger.ts"() {
@@ -5987,7 +6080,7 @@ var init_error_logger = __esm({
       fileLoggingAvailable;
       constructor(options) {
         this.fs = options.fs;
-        this.logFilePath = path9.join(options.logDir, "errors.log");
+        this.logFilePath = path10.join(options.logDir, "errors.log");
         this.logToStderr = options.logToStderr ?? true;
         this.maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
         this.maxBackups = options.maxBackups ?? DEFAULT_MAX_BACKUPS;
@@ -6106,7 +6199,7 @@ ${entry.stack}`);
         return `${this.logFilePath}.${index}`;
       }
       ensureLogDirectory() {
-        const directory = path9.dirname(this.logFilePath);
+        const directory = path10.dirname(this.logFilePath);
         try {
           if (!this.fs.existsSync(directory)) {
             this.fs.mkdirSync(directory, { recursive: true });
@@ -6124,7 +6217,7 @@ ${entry.stack}`);
 });
 
 // src/providers/index.ts
-import path10 from "node:path";
+import path11 from "node:path";
 import { readdir } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
 function isProviderModule(filename) {
@@ -6151,7 +6244,7 @@ async function loadProviders() {
   for (const entry of entries) {
     if (!entry.isFile()) continue;
     if (!isProviderModule(entry.name)) continue;
-    const moduleUrl = pathToFileURL(path10.join(currentDir, entry.name)).href;
+    const moduleUrl = pathToFileURL(path11.join(currentDir, entry.name)).href;
     const moduleExports = await import(moduleUrl);
     if (!moduleExports.provider) {
       throw new Error(`Provider module "${entry.name}" must export "provider".`);
@@ -6167,8 +6260,8 @@ var moduleDir, currentDir, defaultProviders;
 var init_providers = __esm({
   async "src/providers/index.ts"() {
     "use strict";
-    moduleDir = path10.dirname(fileURLToPath(import.meta.url));
-    currentDir = path10.basename(moduleDir) === "providers" ? moduleDir : path10.join(moduleDir, "providers");
+    moduleDir = path11.dirname(fileURLToPath(import.meta.url));
+    currentDir = path11.basename(moduleDir) === "providers" ? moduleDir : path11.join(moduleDir, "providers");
     defaultProviders = await loadProviders();
   }
 });
@@ -6235,7 +6328,7 @@ async function createConfigurePayload(init) {
   const payload = { env: context.env, apiKey };
   const modelPrompt = adapter.configurePrompts?.model;
   if (modelPrompt) {
-    const configModel = await loadAgentModel(
+    const configModel = await resolveModel(
       {
         fs: container.fs,
         filePath: container.env.configPath
@@ -6518,21 +6611,21 @@ function createSdkContainer(options) {
   });
   loggerFactory.setErrorLogger(errorLogger);
   const asyncFs = {
-    readFile: ((path27, encoding) => {
+    readFile: ((path28, encoding) => {
       if (encoding) {
-        return fs2.readFile(path27, encoding);
+        return fs2.readFile(path28, encoding);
       }
-      return fs2.readFile(path27);
+      return fs2.readFile(path28);
     }),
-    writeFile: (path27, data, opts) => fs2.writeFile(path27, data, opts),
-    mkdir: (path27, opts) => fs2.mkdir(path27, opts).then(() => {
+    writeFile: (path28, data, opts) => fs2.writeFile(path28, data, opts),
+    mkdir: (path28, opts) => fs2.mkdir(path28, opts).then(() => {
     }),
-    stat: (path27) => fs2.stat(path27),
-    rm: (path27, opts) => fs2.rm(path27, opts),
-    unlink: (path27) => fs2.unlink(path27),
-    readdir: (path27) => fs2.readdir(path27),
+    stat: (path28) => fs2.stat(path28),
+    rm: (path28, opts) => fs2.rm(path28, opts),
+    unlink: (path28) => fs2.unlink(path28),
+    readdir: (path28) => fs2.readdir(path28),
     copyFile: (src, dest) => fs2.copyFile(src, dest),
-    chmod: (path27, mode) => fs2.chmod(path27, mode)
+    chmod: (path28, mode) => fs2.chmod(path28, mode)
   };
   const contextFactory = createCommandContextFactory({ fs: asyncFs });
   const authFs = {
@@ -7236,8 +7329,8 @@ function resourceNotFound(resource) {
     `Resource not found: ${resource}`
   );
 }
-function assertAbsolutePath(path27) {
-  if (!isAbsolute(path27)) {
+function assertAbsolutePath(path28) {
+  if (!isAbsolute(path28)) {
     throw invalidParams('"path" must be an absolute path');
   }
 }
@@ -8998,7 +9091,7 @@ var init_acp_core = __esm({
 });
 
 // packages/poe-agent/src/plugins/plugin-args.ts
-import path11 from "node:path";
+import path12 from "node:path";
 function isObjectRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -9029,13 +9122,13 @@ function getOptionalString(args, key) {
   return value;
 }
 function resolveAllowedPath(cwd, allowedPaths, inputPath) {
-  const resolvedPath = path11.resolve(cwd, inputPath);
+  const resolvedPath = path12.resolve(cwd, inputPath);
   const isAllowed = allowedPaths.some((allowedPath) => {
     if (allowedPath === resolvedPath) {
       return true;
     }
-    const rel = path11.relative(allowedPath, resolvedPath);
-    return rel.length > 0 && !rel.startsWith("..") && !path11.isAbsolute(rel);
+    const rel = path12.relative(allowedPath, resolvedPath);
+    return rel.length > 0 && !rel.startsWith("..") && !path12.isAbsolute(rel);
   });
   if (!isAllowed) {
     throw new Error(`Path is outside allowed paths: ${inputPath}`);
@@ -9050,7 +9143,7 @@ var init_plugin_args = __esm({
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-files.ts
 import fsPromises2 from "node:fs/promises";
-import path12 from "node:path";
+import path13 from "node:path";
 async function fileExists(fs3, filePath) {
   try {
     await fs3.readFile(filePath, "utf8");
@@ -9074,9 +9167,9 @@ var init_poe_agent_plugin_files = __esm({
     "use strict";
     init_plugin_args();
     filesPlugin = (options = {}) => {
-      const cwd = path12.resolve(options.cwd ?? process.cwd());
+      const cwd = path13.resolve(options.cwd ?? process.cwd());
       const allowedPaths = (options.allowedPaths ?? [cwd]).map(
-        (allowedPath) => path12.resolve(cwd, allowedPath)
+        (allowedPath) => path13.resolve(cwd, allowedPath)
       );
       const fs3 = options.fs ?? fsPromises2;
       const readFileTool = {
@@ -9130,7 +9223,7 @@ var init_poe_agent_plugin_files = __esm({
         async call(args) {
           const command = getRequiredString(args, "command");
           const filePath = resolveAllowedPath(cwd, allowedPaths, getRequiredString(args, "path"));
-          const displayedPath = path12.relative(cwd, filePath) || path12.basename(filePath);
+          const displayedPath = path13.relative(cwd, filePath) || path13.basename(filePath);
           if (command === "str_replace") {
             const oldStr = getRequiredString(args, "old_str", true);
             const newStr = getRequiredString(args, "new_str", true);
@@ -9150,7 +9243,7 @@ var init_poe_agent_plugin_files = __esm({
             if (await fileExists(fs3, filePath)) {
               throw new Error("File already exists \u2014 use str_replace to edit");
             }
-            await fs3.mkdir(path12.dirname(filePath), { recursive: true });
+            await fs3.mkdir(path13.dirname(filePath), { recursive: true });
             await fs3.writeFile(filePath, fileText, "utf8");
             return `Created file: ${displayedPath}`;
           }
@@ -9191,7 +9284,7 @@ var init_poe_agent_plugin_files = __esm({
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-shell.ts
 import { exec as execCallback } from "node:child_process";
-import path13 from "node:path";
+import path14 from "node:path";
 import { promisify } from "node:util";
 async function defaultRunCommand(command, cwd) {
   try {
@@ -9224,9 +9317,9 @@ var init_poe_agent_plugin_shell = __esm({
     init_plugin_args();
     exec = promisify(execCallback);
     shellPlugin = (options = {}) => {
-      const cwd = path13.resolve(options.cwd ?? process.cwd());
+      const cwd = path14.resolve(options.cwd ?? process.cwd());
       const allowedPaths = (options.allowedPaths ?? [cwd]).map(
-        (allowedPath) => path13.resolve(cwd, allowedPath)
+        (allowedPath) => path14.resolve(cwd, allowedPath)
       );
       const runCommand2 = options.runCommand ?? defaultRunCommand;
       const runCommandTool = {
@@ -12614,7 +12707,7 @@ var init_utils2 = __esm({
 });
 
 // packages/pipeline/src/config/loader.ts
-import path14 from "node:path";
+import path15 from "node:path";
 import { parse as parse4 } from "yaml";
 function asStepMode(value) {
   if (value === void 0 || value === null) {
@@ -12698,8 +12791,8 @@ async function loadStepsFile(fs3, filePath) {
   return parseStepConfigDocument(filePath, content);
 }
 async function loadPipelineConfig(options) {
-  const globalPath = path14.join(options.homeDir, ".poe-code", "pipeline", "config.yaml");
-  const projectPath = path14.join(options.cwd, ".poe-code", "pipeline", "config.yaml");
+  const globalPath = path15.join(options.homeDir, ".poe-code", "pipeline", "config.yaml");
+  const projectPath = path15.join(options.cwd, ".poe-code", "pipeline", "config.yaml");
   const [globalConfig2, projectConfig] = await Promise.all([
     loadConfigFile(options.fs, globalPath),
     loadConfigFile(options.fs, projectPath)
@@ -12710,8 +12803,8 @@ async function loadPipelineConfig(options) {
   };
 }
 async function loadResolvedSteps(options) {
-  const globalPath = path14.join(options.homeDir, ".poe-code", "pipeline", "steps.yaml");
-  const projectPath = path14.join(options.cwd, ".poe-code", "pipeline", "steps.yaml");
+  const globalPath = path15.join(options.homeDir, ".poe-code", "pipeline", "steps.yaml");
+  const projectPath = path15.join(options.cwd, ".poe-code", "pipeline", "steps.yaml");
   const [globalSteps, projectSteps] = await Promise.all([
     loadStepsFile(options.fs, globalPath),
     loadStepsFile(options.fs, projectPath)
@@ -12804,7 +12897,7 @@ var init_parser = __esm({
 });
 
 // packages/pipeline/src/plan/discovery.ts
-import path15 from "node:path";
+import path16 from "node:path";
 import * as fsPromises3 from "node:fs/promises";
 function createDefaultFs() {
   return {
@@ -12840,7 +12933,7 @@ function countCompletedTasks(planPath, content) {
   };
 }
 async function ensurePlanExists(fs3, cwd, planPath) {
-  const absolutePath = path15.isAbsolute(planPath) ? planPath : path15.resolve(cwd, planPath);
+  const absolutePath = path16.isAbsolute(planPath) ? planPath : path16.resolve(cwd, planPath);
   try {
     const stat8 = await fs3.stat(absolutePath);
     if (!stat8.isFile()) {
@@ -12868,20 +12961,20 @@ async function scanPlansDir(fs3, plansDir, displayPrefix) {
     if (!isPlanCandidateFile(entry)) {
       continue;
     }
-    const absolutePath = path15.join(plansDir, entry);
+    const absolutePath = path16.join(plansDir, entry);
     const stat8 = await fs3.stat(absolutePath);
     if (!stat8.isFile()) {
       continue;
     }
-    const displayPath = path15.join(displayPrefix, entry);
+    const displayPath = path16.join(displayPrefix, entry);
     const content = await fs3.readFile(absolutePath, "utf8");
     candidates.push(countCompletedTasks(displayPath, content));
   }
   return candidates;
 }
 async function listPlanCandidates(fs3, cwd, homeDir) {
-  const projectDir = path15.join(cwd, ".poe-code", "pipeline", "plans");
-  const globalDir = path15.join(homeDir, ".poe-code", "pipeline", "plans");
+  const projectDir = path16.join(cwd, ".poe-code", "pipeline", "plans");
+  const globalDir = path16.join(homeDir, ".poe-code", "pipeline", "plans");
   const [projectCandidates, globalCandidates] = await Promise.all([
     scanPlansDir(fs3, projectDir, ".poe-code/pipeline/plans"),
     scanPlansDir(fs3, globalDir, "~/.poe-code/pipeline/plans")
@@ -12892,9 +12985,9 @@ async function listPlanCandidates(fs3, cwd, homeDir) {
 }
 function resolveAbsolutePlanPath(planPath, cwd, homeDir) {
   if (planPath.startsWith("~/")) {
-    return path15.join(homeDir, planPath.slice(2));
+    return path16.join(homeDir, planPath.slice(2));
   }
-  return path15.isAbsolute(planPath) ? planPath : path15.resolve(cwd, planPath);
+  return path16.isAbsolute(planPath) ? planPath : path16.resolve(cwd, planPath);
 }
 async function resolvePlanPath(options) {
   const fs3 = options.fs ?? createDefaultFs();
@@ -13137,7 +13230,7 @@ var init_lock = __esm({
 });
 
 // packages/pipeline/src/run/pipeline.ts
-import path16 from "node:path";
+import path17 from "node:path";
 import * as fsPromises5 from "node:fs/promises";
 function createDefaultFs3() {
   return {
@@ -13173,9 +13266,9 @@ function resolveMode(stepName, steps) {
   return step.mode;
 }
 async function archivePlan(fs3, absolutePlanPath) {
-  const dir = path16.dirname(absolutePlanPath);
-  const archiveDir = path16.join(dir, "archive");
-  const archivePath = path16.join(archiveDir, path16.basename(absolutePlanPath));
+  const dir = path17.dirname(absolutePlanPath);
+  const archiveDir = path17.join(dir, "archive");
+  const archivePath = path17.join(archiveDir, path17.basename(absolutePlanPath));
   await fs3.mkdir(archiveDir, { recursive: true });
   await fs3.rename(absolutePlanPath, archivePath);
 }
@@ -13494,7 +13587,7 @@ var init_frontmatter = __esm({
 });
 
 // packages/ralph/src/discovery/discovery.ts
-import path17 from "node:path";
+import path18 from "node:path";
 import * as fsPromises6 from "node:fs/promises";
 function createDefaultFs4() {
   return {
@@ -13529,12 +13622,12 @@ async function scanDir(fs3, absoluteDir, displayDir) {
     if (!isMarkdownFile(entry)) {
       continue;
     }
-    const absolutePath = path17.join(absoluteDir, entry);
+    const absolutePath = path18.join(absoluteDir, entry);
     const stat8 = await fs3.stat(absolutePath);
     if (!stat8.isFile()) {
       continue;
     }
-    const displayPath = path17.join(displayDir, entry);
+    const displayPath = path18.join(displayDir, entry);
     docs.push({
       path: displayPath,
       displayPath
@@ -13547,18 +13640,18 @@ async function discoverDocs(options) {
   const [localDocs, globalDocs] = await Promise.all([
     scanDir(
       fs3,
-      path17.join(options.cwd, ".poe-code", "ralph", "plans"),
+      path18.join(options.cwd, ".poe-code", "ralph", "plans"),
       ".poe-code/ralph/plans"
     ),
     scanDir(
       fs3,
-      path17.join(options.homeDir, ".poe-code", "ralph", "plans"),
+      path18.join(options.homeDir, ".poe-code", "ralph", "plans"),
       "~/.poe-code/ralph/plans"
     )
   ]);
   return [...localDocs, ...globalDocs].sort((left, right) => {
-    const leftName = path17.basename(left.displayPath).toLowerCase();
-    const rightName = path17.basename(right.displayPath).toLowerCase();
+    const leftName = path18.basename(left.displayPath).toLowerCase();
+    const rightName = path18.basename(right.displayPath).toLowerCase();
     return leftName === rightName ? left.displayPath.localeCompare(right.displayPath) : leftName.localeCompare(rightName);
   });
 }
@@ -13600,7 +13693,7 @@ var init_detector = __esm({
 });
 
 // packages/ralph/src/run/ralph.ts
-import path18 from "node:path";
+import path19 from "node:path";
 import * as fsPromises7 from "node:fs/promises";
 async function runRalph(options) {
   const fs3 = options.fs ?? createDefaultFs5();
@@ -13723,9 +13816,9 @@ function createDefaultFs5() {
 }
 function resolveAbsoluteDocPath(docPath, cwd, homeDir) {
   if (docPath.startsWith("~/")) {
-    return path18.join(homeDir, docPath.slice(2));
+    return path19.join(homeDir, docPath.slice(2));
   }
-  return path18.isAbsolute(docPath) ? docPath : path18.resolve(cwd, docPath);
+  return path19.isAbsolute(docPath) ? docPath : path19.resolve(cwd, docPath);
 }
 function assertNotAborted5(signal) {
   if (!signal?.aborted) {
@@ -13746,9 +13839,9 @@ async function updateFrontmatter(fs3, absoluteDocPath, body, status, iteration)
   await fs3.writeFile(absoluteDocPath, content);
 }
 async function archivePlan2(fs3, absoluteDocPath) {
-  const dir = path18.dirname(absoluteDocPath);
-  const archiveDir = path18.join(dir, "archive");
-  const archivePath = path18.join(archiveDir, path18.basename(absoluteDocPath));
+  const dir = path19.dirname(absoluteDocPath);
+  const archiveDir = path19.join(dir, "archive");
+  const archivePath = path19.join(archiveDir, path19.basename(absoluteDocPath));
   await fs3.mkdir(archiveDir, { recursive: true });
   await fs3.rename(absoluteDocPath, archivePath);
 }
@@ -14142,7 +14235,7 @@ var init_container2 = __esm({
 });
 
 // src/services/config.ts
-import path20 from "node:path";
+import path21 from "node:path";
 async function deleteConfig(options) {
   const { fs: fs3, filePath } = options;
   try {
@@ -14223,7 +14316,7 @@ async function migrateLegacyCredentialsIfNeeded(fs3, filePath) {
   await migrateLegacyCredentialsFile(fs3, filePath);
 }
 async function migrateLegacyCredentialsFile(fs3, configPath) {
-  const legacyPath = path20.join(path20.dirname(configPath), "credentials.json");
+  const legacyPath = path21.join(path21.dirname(configPath), "credentials.json");
   const raw = await readFileIfExists(fs3, legacyPath);
   if (raw === null) {
     return;
@@ -14288,25 +14381,40 @@ function normalizeConfiguredServices(value) {
 async function recoverInvalidConfig(fs3, filePath, content) {
   const backupPath = createInvalidBackupPath2(filePath);
   await fs3.writeFile(backupPath, content, { encoding: "utf8" });
-  await fs3.writeFile(filePath, EMPTY_DOCUMENT2, { encoding: "utf8" });
+  await fs3.writeFile(filePath, EMPTY_DOCUMENT3, { encoding: "utf8" });
 }
 function createInvalidBackupPath2(filePath) {
-  const directory = path20.dirname(filePath);
-  const baseName = path20.basename(filePath);
-  return path20.join(directory, `${baseName}.invalid-${createTimestamp()}.json`);
+  const directory = path21.dirname(filePath);
+  const baseName = path21.basename(filePath);
+  return path21.join(directory, `${baseName}.invalid-${createTimestamp()}.json`);
 }
 function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-var CORE_SCOPE, configuredServicesScope, EMPTY_DOCUMENT2;
+var coreConfigScope, knownConfigScopes, CORE_SCOPE, configuredServicesScope, EMPTY_DOCUMENT3;
 var init_config3 = __esm({
   "src/services/config.ts"() {
     "use strict";
     init_src3();
     init_src4();
-    CORE_SCOPE = "core";
+    coreConfigScope = defineScope("core", {
+      apiKey: {
+        type: "string",
+        default: "",
+        env: "POE_API_KEY",
+        doc: "Poe API key"
+      },
+      poeBaseUrl: {
+        type: "string",
+        default: "https://api.poe.com/v1",
+        env: "POE_BASE_URL",
+        doc: "Poe API base URL"
+      }
+    });
+    knownConfigScopes = [coreConfigScope];
+    CORE_SCOPE = coreConfigScope.scope;
     configuredServicesScope = "configured_services";
-    EMPTY_DOCUMENT2 = `${JSON.stringify({}, null, 2)}
+    EMPTY_DOCUMENT3 = `${JSON.stringify({}, null, 2)}
 `;
   }
 });
@@ -14540,7 +14648,7 @@ var init_agent2 = __esm({
 });
 
 // src/cli/commands/spawn.ts
-import path21 from "node:path";
+import path22 from "node:path";
 function registerSpawnCommand(program, container, options = {}) {
   const spawnServices = container.registry.list().filter((service) => typeof service.spawn === "function" || getSpawnConfig(service.name)).map((service) => service.name);
   const extraServices = options.extraServices ?? [];
@@ -14573,7 +14681,7 @@ function registerSpawnCommand(program, container, options = {}) {
       if (!proceed) {
         return;
       }
-      const model = await resolveConfiguredModel(
+      const model2 = await resolveConfiguredModel(
         container,
         canonicalService2,
         commandOptions.model
@@ -14581,7 +14689,7 @@ function registerSpawnCommand(program, container, options = {}) {
       const result = await spawnInteractive(canonicalService2, {
         prompt: promptText ?? "",
         args: forwardedArgs,
-        model,
+        model: model2,
         mode: commandOptions.mode,
         ...mcpServers ? { mcpServers } : {},
         cwd: cwdOverride
@@ -14599,7 +14707,7 @@ function registerSpawnCommand(program, container, options = {}) {
     if (!promptText) {
       throw new Error("No prompt provided via argument or stdin");
     }
-    const spawnOptions = {
+    const directSpawnOptions = {
       prompt: promptText,
       args: forwardedArgs,
       model: commandOptions.model,
@@ -14615,7 +14723,7 @@ function registerSpawnCommand(program, container, options = {}) {
       await directHandler({
         container,
         service,
-        options: spawnOptions,
+        options: directSpawnOptions,
         flags,
         resources: resources2
       });
@@ -14624,6 +14732,15 @@ function registerSpawnCommand(program, container, options = {}) {
     }
     const adapter = resolveServiceAdapter(container, service);
     const canonicalService = adapter.name;
+    const model = await resolveConfiguredModel(
+      container,
+      canonicalService,
+      commandOptions.model
+    );
+    const spawnOptions = {
+      ...directSpawnOptions,
+      model
+    };
     const resources = createExecutionResources(container, flags, `spawn:${canonicalService}`);
     resources.logger.intro(`spawn ${canonicalService}`);
     const canonicalHandler = options.handlers?.[canonicalService];
@@ -14733,10 +14850,10 @@ function resolveSpawnWorkingDirectory2(baseDir, candidate) {
   if (!candidate || candidate.trim().length === 0) {
     return void 0;
   }
-  if (path21.isAbsolute(candidate)) {
+  if (path22.isAbsolute(candidate)) {
     return candidate;
   }
-  return path21.resolve(baseDir, candidate);
+  return path22.resolve(baseDir, candidate);
 }
 function parseMcpSpawnConfig2(input) {
   if (!input) {
@@ -14854,7 +14971,7 @@ var init_spawn4 = __esm({
 });
 
 // src/sdk/research.ts
-import path22 from "node:path";
+import path23 from "node:path";
 async function research(container, options) {
   const logger2 = options.logger;
   const source = await resolveSource({
@@ -14889,7 +15006,7 @@ async function research(container, options) {
         markdown: markdownOutput
       });
       outputPath = buildOutputPath(container.env.homeDir, options.prompt);
-      await ensureDirectory2(container.fs, path22.dirname(outputPath));
+      await ensureDirectory2(container.fs, path23.dirname(outputPath));
       await container.fs.writeFile(outputPath, document, {
         encoding: "utf8"
       });
@@ -14964,7 +15081,7 @@ function buildResearchDocument(input) {
 }
 function buildClonePath(homeDir, github) {
   const slug = extractRepoSlug(github);
-  return path22.join(homeDir, ".poe-code", "repos", slug);
+  return path23.join(homeDir, ".poe-code", "repos", slug);
 }
 function extractRepoSlug(value) {
   const trimmed = value.trim();
@@ -15002,7 +15119,7 @@ function extractRepoSlug(value) {
 function buildOutputPath(homeDir, prompt, now = /* @__PURE__ */ new Date()) {
   const timestamp = formatTimestamp2(now);
   const slug = buildSlug(prompt);
-  return path22.join(
+  return path23.join(
     homeDir,
     ".poe-code",
     "research",
@@ -15023,7 +15140,7 @@ async function resolveSource(input) {
   if (options.github) {
     const cloneUrl = resolveGithubCloneUrl(options.github);
     const clonePath = buildClonePath(container.env.homeDir, options.github);
-    await ensureDirectory2(container.fs, path22.dirname(clonePath));
+    await ensureDirectory2(container.fs, path23.dirname(clonePath));
     const exists = await pathExists2(container.fs, clonePath);
     if (!exists) {
       const cloneResult = await container.commandRunner(
@@ -15121,10 +15238,10 @@ function formatYamlString(value) {
   return JSON.stringify(value);
 }
 function resolvePath2(baseDir, candidate) {
-  if (path22.isAbsolute(candidate)) {
+  if (path23.isAbsolute(candidate)) {
     return candidate;
   }
-  return path22.resolve(baseDir, candidate);
+  return path23.resolve(baseDir, candidate);
 }
 function teeAcpStream(events) {
   const chunks = [];
@@ -15184,7 +15301,7 @@ async function removePathFallback(fs3, target) {
   if (stats && typeof stats.isDirectory === "function" && stats.isDirectory()) {
     const entries = await fs3.readdir(target);
     for (const entry of entries) {
-      await removePathFallback(fs3, path22.join(target, entry));
+      await removePathFallback(fs3, path23.join(target, entry));
     }
   }
   try {
@@ -15834,6 +15951,130 @@ var init_auth = __esm({
   }
 });
 
+// src/cli/commands/config.ts
+import { execSync } from "node:child_process";
+function registerConfigCommand(program, container) {
+  const config2 = program.command("config").description("Inspect and manage poe-code config files.").action(async () => {
+    await executeConfigInfo(program, container);
+  });
+  config2.command("show").description("Show config inputs and the merged result.").action(async () => {
+    await executeConfigShow(program, container);
+  });
+  config2.command("init").description("Create an empty project config file.").action(async () => {
+    await executeConfigInit(program, container);
+  });
+  config2.command("edit").description("Open a config file in $EDITOR.").option("--global", "Open the global config file.").option("--project", "Open the project config file.").action(async (options) => {
+    await executeConfigEdit(program, container, options);
+  });
+}
+async function executeConfigInfo(program, container) {
+  const flags = resolveCommandFlags(program);
+  const resources = createExecutionResources(container, flags, "config");
+  const globalExists = await pathExists(container.fs, container.env.configPath);
+  const projectExists = await pathExists(container.fs, container.env.projectConfigPath);
+  resources.logger.intro("config");
+  resources.logger.resolved(
+    "Global config",
+    `${container.env.configPath} (${globalExists ? "exists" : "missing"})`
+  );
+  resources.logger.resolved(
+    "Project config",
+    `${container.env.projectConfigPath} (${projectExists ? "exists" : "missing"})`
+  );
+  resources.logger.nextSteps([
+    'Run "poe-code config show" to see resolved configuration.'
+  ]);
+}
+async function executeConfigShow(program, container) {
+  const flags = resolveCommandFlags(program);
+  const resources = createExecutionResources(container, flags, "config:show");
+  const globalDocument = await readDocument(container.fs, container.env.configPath);
+  const projectDocument = await readDocument(container.fs, container.env.projectConfigPath);
+  const mergedDocument = await readMergedDocument(
+    container.fs,
+    container.env.configPath,
+    container.env.projectConfigPath
+  );
+  const envOverrides = collectEnvOverrides(knownConfigScopes, container.env.variables);
+  const resolvedDocument = deepMergeDocuments(mergedDocument, envOverrides.document);
+  resources.logger.intro("config show");
+  resources.logger.info(
+    [
+      formatDocumentSection("Global config", container.env.configPath, globalDocument),
+      formatDocumentSection("Project config", container.env.projectConfigPath, projectDocument),
+      formatEnvSection(envOverrides.entries),
+      formatDocumentSection("Resolved (merged)", void 0, resolvedDocument)
+    ].join("\n\n")
+  );
+}
+async function executeConfigInit(program, container) {
+  const flags = resolveCommandFlags(program);
+  const resources = createExecutionResources(container, flags, "config:init");
+  const targetPath = container.env.projectConfigPath;
+  resources.logger.intro("config init");
+  if (await pathExists(container.fs, targetPath)) {
+    resources.logger.info(`Project config already exists at ${targetPath}`);
+    return;
+  }
+  if (flags.dryRun) {
+    resources.logger.dryRun(`Dry run: would create project config at ${targetPath}`);
+    return;
+  }
+  await initProjectConfig(container.fs, targetPath);
+  resources.logger.success(`Created project config at ${targetPath}`);
+}
+async function executeConfigEdit(program, container, options) {
+  const flags = resolveCommandFlags(program);
+  const resources = createExecutionResources(container, flags, "config:edit");
+  const editor = resolveEditor(container);
+  resources.logger.intro("config edit");
+  const targetPath = await resolveEditTarget(
+    container.fs,
+    container.env.configPath,
+    container.env.projectConfigPath,
+    options
+  );
+  if (flags.dryRun) {
+    resources.logger.dryRun(`Dry run: would open ${targetPath} in ${editor}`);
+    return;
+  }
+  if (!await pathExists(container.fs, targetPath)) {
+    await initProjectConfig(container.fs, targetPath);
+  }
+  execSync(`${editor} ${shlexQuote(targetPath)}`, {
+    stdio: "inherit"
+  });
+}
+function formatDocumentSection(title, filePath, document) {
+  const headingText = filePath ? `${title} (${filePath})` : title;
+  const body = Object.keys(document).length === 0 ? text.muted("(empty)") : JSON.stringify(document, null, 2);
+  return `${text.heading(`\u2500\u2500 ${headingText} \u2500\u2500`)}
+${body}`;
+}
+function formatEnvSection(entries) {
+  const body = entries.length > 0 ? entries.join("\n") : text.muted("(empty)");
+  return `${text.heading("\u2500\u2500 Environment variable overrides \u2500\u2500")}
+${body}`;
+}
+function resolveEditor(container) {
+  const editor = container.env.getVariable("EDITOR") ?? container.env.getVariable("VISUAL");
+  const resolved = typeof editor === "string" ? editor.trim() : "";
+  if (resolved.length === 0) {
+    throw new Error("Set $EDITOR to use this command");
+  }
+  return resolved;
+}
+var init_config4 = __esm({
+  "src/cli/commands/config.ts"() {
+    "use strict";
+    init_src3();
+    init_src4();
+    init_src5();
+    init_config3();
+    init_shared();
+  }
+});
+
 // src/cli/commands/install.ts
 function registerInstallCommand(program, container) {
   const serviceNames = container.registry.list().filter((service) => typeof service.install === "function").map((service) => service.name);
@@ -16030,7 +16271,7 @@ var init_media_download = __esm({
 });
 
 // src/cli/commands/generate.ts
-import path23 from "node:path";
+import path24 from "node:path";
 function registerGenerateCommand(program, container) {
   const generate2 = program.command("generate").description("Generate content via Poe API").option("--model <model>", `Model identifier (default: ${DEFAULT_TEXT_MODEL})`).option(
     "--param <key=value>",
@@ -16296,11 +16537,11 @@ function getDefaultMimeType(type) {
   return defaults[type];
 }
 function resolveOutputPath(filename, cwd) {
-  if (path23.isAbsolute(filename)) {
+  if (path24.isAbsolute(filename)) {
     return { path: filename, label: filename };
   }
   return {
-    path: path23.join(cwd, filename),
+    path: path24.join(cwd, filename),
     label: `./${filename}`
   };
 }
@@ -17404,8 +17645,8 @@ var init_parseUtil = __esm({
     init_errors3();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path27, errorMaps, issueData } = params;
-      const fullPath = [...path27, ...issueData.path || []];
+      const { data, path: path28, errorMaps, issueData } = params;
+      const fullPath = [...path28, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -17685,11 +17926,11 @@ var init_types4 = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path27, key) {
+      constructor(parent, value, path28, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path27;
+        this._path = path28;
         this._key = key;
       }
       get path() {
@@ -21193,10 +21434,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path27) {
-  if (!path27)
+function getElementAtPath(obj, path28) {
+  if (!path28)
     return obj;
-  return path27.reduce((acc, key) => acc?.[key], obj);
+  return path28.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -21508,11 +21749,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path27, issues) {
+function prefixIssues(path28, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path27);
+    iss.path.unshift(path28);
     return iss;
   });
 }
@@ -33673,8 +33914,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path27) {
-      let input = path27;
+    function removeDotSegments(path28) {
+      let input = path28;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -33873,8 +34114,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path27, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path27 && path27 !== "/" ? path27 : void 0;
+        const [path28, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path28 && path28 !== "/" ? path28 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -37817,9 +38058,9 @@ var init_shapes = __esm({
 });
 
 // packages/agent-mcp-config/src/apply.ts
-import path24 from "node:path";
+import path25 from "node:path";
 function getConfigDirectory(configPath) {
-  return path24.dirname(configPath);
+  return path25.dirname(configPath);
 }
 function isConfigObject5(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -38109,7 +38350,7 @@ var init_mcp2 = __esm({
 
 // packages/agent-skill-config/src/configs.ts
 import os2 from "node:os";
-import path25 from "node:path";
+import path26 from "node:path";
 function resolveAgentSupport2(input, registry2 = agentSkillConfigs) {
   const resolvedId = resolveAgentId(input);
   if (!resolvedId) {
@@ -39120,7 +39361,7 @@ var init_models2 = __esm({
 });
 
 // src/cli/commands/pipeline.ts
-import path26 from "node:path";
+import path27 from "node:path";
 import { readFile as readFile7, stat as stat7 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function formatDuration(ms) {
@@ -39152,11 +39393,11 @@ function resolveMaxRuns(value) {
   return parsed;
 }
 function resolvePipelinePaths(scope, cwd, homeDir) {
-  const rootPath = scope === "global" ? path26.join(homeDir, ".poe-code", "pipeline") : path26.join(cwd, ".poe-code", "pipeline");
+  const rootPath = scope === "global" ? path27.join(homeDir, ".poe-code", "pipeline") : path27.join(cwd, ".poe-code", "pipeline");
   const displayRoot = scope === "global" ? "~/.poe-code/pipeline" : ".poe-code/pipeline";
   return {
-    plansPath: path26.join(rootPath, "plans"),
-    stepsPath: path26.join(rootPath, "steps.yaml"),
+    plansPath: path27.join(rootPath, "plans"),
+    stepsPath: path27.join(rootPath, "steps.yaml"),
     displayPlansPath: `${displayRoot}/plans`,
     displayStepsPath: `${displayRoot}/steps.yaml`
   };
@@ -39167,16 +39408,16 @@ async function loadPipelineTemplates() {
   }
   const packageRoot = await findPackageRoot(fileURLToPath4(import.meta.url));
   const templateRoots = [
-    path26.join(packageRoot, "src", "templates", "pipeline"),
-    path26.join(packageRoot, "dist", "templates", "pipeline")
+    path27.join(packageRoot, "src", "templates", "pipeline"),
+    path27.join(packageRoot, "dist", "templates", "pipeline")
   ];
   for (const templateRoot of templateRoots) {
     if (!await pathExistsOnDisk(templateRoot)) {
       continue;
     }
     const [skillPlan, steps] = await Promise.all([
-      readFile7(path26.join(templateRoot, "SKILL_plan.md"), "utf8"),
-      readFile7(path26.join(templateRoot, "steps.yaml.hbs"), "utf8")
+      readFile7(path27.join(templateRoot, "SKILL_plan.md"), "utf8"),
+      readFile7(path27.join(templateRoot, "steps.yaml.hbs"), "utf8")
     ]);
     pipelineTemplatesCache = { skillPlan, steps };
     return pipelineTemplatesCache;
@@ -39195,12 +39436,12 @@ async function pathExistsOnDisk(targetPath) {
   }
 }
 async function findPackageRoot(entryFilePath) {
-  let currentPath = path26.dirname(entryFilePath);
+  let currentPath = path27.dirname(entryFilePath);
   while (true) {
-    if (await pathExistsOnDisk(path26.join(currentPath, "package.json"))) {
+    if (await pathExistsOnDisk(path27.join(currentPath, "package.json"))) {
       return currentPath;
     }
-    const parentPath = path26.dirname(currentPath);
+    const parentPath = path27.dirname(currentPath);
     if (parentPath === currentPath) {
       throw new Error("Unable to locate package root for Pipeline templates.");
     }
@@ -39478,7 +39719,7 @@ function registerPipelineCommand(program, container) {
           `Would ${stepsExists ? "overwrite" : "create"}: ${pipelinePaths.displayStepsPath}`
         );
       } else {
-        await container.fs.mkdir(path26.dirname(pipelinePaths.stepsPath), {
+        await container.fs.mkdir(path27.dirname(pipelinePaths.stepsPath), {
           recursive: true
         });
         await container.fs.writeFile(pipelinePaths.stepsPath, templates.steps, {
@@ -39740,7 +39981,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "poe-code",
-      version: "3.0.107",
+      version: "3.0.109",
       description: "CLI tool to configure Poe API for developer workflows.",
       type: "module",
       main: "./dist/index.js",
@@ -39903,6 +40144,26 @@ function formatHelpText(input) {
       args: "",
       description: "Remove all configuration"
     },
+    {
+      name: "config",
+      args: "",
+      description: "Show config file paths and usage hints"
+    },
+    {
+      name: "config show",
+      args: "",
+      description: "Show config inputs and resolved result"
+    },
+    {
+      name: "config init",
+      args: "",
+      description: "Create a project config file"
+    },
+    {
+      name: "config edit",
+      args: "",
+      description: "Open a config file in your editor"
+    },
     {
       name: "auth status",
       args: "",
@@ -40117,6 +40378,7 @@ function bootstrapProgram(container) {
   registerUnconfigureCommand(program, container);
   registerLoginCommand(program, container);
   registerLogoutCommand(program, container);
+  registerConfigCommand(program, container);
   registerAuthCommand(program, container);
   registerMcpCommand(program, container);
   registerSkillCommand(program, container);
@@ -40169,6 +40431,7 @@ var init_program = __esm({
     init_login();
     init_logout();
     init_auth();
+    init_config4();
     init_install();
     init_unconfigure();
     init_test();
@@ -40462,7 +40725,7 @@ init_src6();
 init_src5();
 init_constants();
 init_errors();
-import path19 from "node:path";
+import path20 from "node:path";
 import { Command } from "commander";
 function parseMcpSpawnConfig(input) {
   if (!input) {
@@ -40533,10 +40796,10 @@ function resolveWorkingDirectory(baseDir, candidate) {
   if (!candidate || candidate.trim().length === 0) {
     return void 0;
   }
-  if (path19.isAbsolute(candidate)) {
+  if (path20.isAbsolute(candidate)) {
     return candidate;
   }
-  return path19.resolve(baseDir, candidate);
+  return path20.resolve(baseDir, candidate);
 }
 function createPoeAgentProgram() {
   const program = new Command();