npm - popeye-cli - Versions diffs - 1.0.0 - Mend

popeye-cli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (209) hide show

package/.env.example +25 -0
package/.prettierrc +8 -0
package/README.md +320 -0
package/dist/adapters/claude.d.ts +82 -0
package/dist/adapters/claude.d.ts.map +1 -0
package/dist/adapters/claude.js +230 -0
package/dist/adapters/claude.js.map +1 -0
package/dist/adapters/openai.d.ts +48 -0
package/dist/adapters/openai.d.ts.map +1 -0
package/dist/adapters/openai.js +257 -0
package/dist/adapters/openai.js.map +1 -0
package/dist/auth/claude.d.ts +44 -0
package/dist/auth/claude.d.ts.map +1 -0
package/dist/auth/claude.js +139 -0
package/dist/auth/claude.js.map +1 -0
package/dist/auth/index.d.ts +61 -0
package/dist/auth/index.d.ts.map +1 -0
package/dist/auth/index.js +141 -0
package/dist/auth/index.js.map +1 -0
package/dist/auth/keychain.d.ts +66 -0
package/dist/auth/keychain.d.ts.map +1 -0
package/dist/auth/keychain.js +125 -0
package/dist/auth/keychain.js.map +1 -0
package/dist/auth/openai-entry.d.ts +9 -0
package/dist/auth/openai-entry.d.ts.map +1 -0
package/dist/auth/openai-entry.js +410 -0
package/dist/auth/openai-entry.js.map +1 -0
package/dist/auth/openai.d.ts +71 -0
package/dist/auth/openai.d.ts.map +1 -0
package/dist/auth/openai.js +212 -0
package/dist/auth/openai.js.map +1 -0
package/dist/auth/server.d.ts +32 -0
package/dist/auth/server.d.ts.map +1 -0
package/dist/auth/server.js +213 -0
package/dist/auth/server.js.map +1 -0
package/dist/cli/commands/auth.d.ts +10 -0
package/dist/cli/commands/auth.d.ts.map +1 -0
package/dist/cli/commands/auth.js +162 -0
package/dist/cli/commands/auth.js.map +1 -0
package/dist/cli/commands/config.d.ts +10 -0
package/dist/cli/commands/config.d.ts.map +1 -0
package/dist/cli/commands/config.js +215 -0
package/dist/cli/commands/config.js.map +1 -0
package/dist/cli/commands/create.d.ts +10 -0
package/dist/cli/commands/create.d.ts.map +1 -0
package/dist/cli/commands/create.js +240 -0
package/dist/cli/commands/create.js.map +1 -0
package/dist/cli/commands/index.d.ts +10 -0
package/dist/cli/commands/index.d.ts.map +1 -0
package/dist/cli/commands/index.js +10 -0
package/dist/cli/commands/index.js.map +1 -0
package/dist/cli/commands/resume.d.ts +18 -0
package/dist/cli/commands/resume.d.ts.map +1 -0
package/dist/cli/commands/resume.js +241 -0
package/dist/cli/commands/resume.js.map +1 -0
package/dist/cli/commands/status.d.ts +18 -0
package/dist/cli/commands/status.d.ts.map +1 -0
package/dist/cli/commands/status.js +154 -0
package/dist/cli/commands/status.js.map +1 -0
package/dist/cli/index.d.ts +17 -0
package/dist/cli/index.d.ts.map +1 -0
package/dist/cli/index.js +71 -0
package/dist/cli/index.js.map +1 -0
package/dist/cli/interactive.d.ts +9 -0
package/dist/cli/interactive.d.ts.map +1 -0
package/dist/cli/interactive.js +330 -0
package/dist/cli/interactive.js.map +1 -0
package/dist/cli/output.d.ts +182 -0
package/dist/cli/output.d.ts.map +1 -0
package/dist/cli/output.js +355 -0
package/dist/cli/output.js.map +1 -0
package/dist/config/defaults.d.ts +57 -0
package/dist/config/defaults.d.ts.map +1 -0
package/dist/config/defaults.js +103 -0
package/dist/config/defaults.js.map +1 -0
package/dist/config/index.d.ts +138 -0
package/dist/config/index.d.ts.map +1 -0
package/dist/config/index.js +244 -0
package/dist/config/index.js.map +1 -0
package/dist/config/schema.d.ts +220 -0
package/dist/config/schema.d.ts.map +1 -0
package/dist/config/schema.js +141 -0
package/dist/config/schema.js.map +1 -0
package/dist/generators/index.d.ts +101 -0
package/dist/generators/index.d.ts.map +1 -0
package/dist/generators/index.js +200 -0
package/dist/generators/index.js.map +1 -0
package/dist/generators/python.d.ts +48 -0
package/dist/generators/python.d.ts.map +1 -0
package/dist/generators/python.js +262 -0
package/dist/generators/python.js.map +1 -0
package/dist/generators/templates/index.d.ts +6 -0
package/dist/generators/templates/index.d.ts.map +1 -0
package/dist/generators/templates/index.js +6 -0
package/dist/generators/templates/index.js.map +1 -0
package/dist/generators/templates/python.d.ts +53 -0
package/dist/generators/templates/python.d.ts.map +1 -0
package/dist/generators/templates/python.js +454 -0
package/dist/generators/templates/python.js.map +1 -0
package/dist/generators/templates/typescript.d.ts +53 -0
package/dist/generators/templates/typescript.d.ts.map +1 -0
package/dist/generators/templates/typescript.js +394 -0
package/dist/generators/templates/typescript.js.map +1 -0
package/dist/generators/typescript.d.ts +64 -0
package/dist/generators/typescript.d.ts.map +1 -0
package/dist/generators/typescript.js +271 -0
package/dist/generators/typescript.js.map +1 -0
package/dist/index.d.ts +7 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +12 -0
package/dist/index.js.map +1 -0
package/dist/state/index.d.ts +168 -0
package/dist/state/index.d.ts.map +1 -0
package/dist/state/index.js +338 -0
package/dist/state/index.js.map +1 -0
package/dist/state/persistence.d.ts +91 -0
package/dist/state/persistence.d.ts.map +1 -0
package/dist/state/persistence.js +201 -0
package/dist/state/persistence.js.map +1 -0
package/dist/types/cli.d.ts +132 -0
package/dist/types/cli.d.ts.map +1 -0
package/dist/types/cli.js +17 -0
package/dist/types/cli.js.map +1 -0
package/dist/types/consensus.d.ts +111 -0
package/dist/types/consensus.d.ts.map +1 -0
package/dist/types/consensus.js +29 -0
package/dist/types/consensus.js.map +1 -0
package/dist/types/index.d.ts +9 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/index.js +13 -0
package/dist/types/index.js.map +1 -0
package/dist/types/project.d.ts +73 -0
package/dist/types/project.d.ts.map +1 -0
package/dist/types/project.js +55 -0
package/dist/types/project.js.map +1 -0
package/dist/types/workflow.d.ts +236 -0
package/dist/types/workflow.d.ts.map +1 -0
package/dist/types/workflow.js +74 -0
package/dist/types/workflow.js.map +1 -0
package/dist/workflow/consensus.d.ts +89 -0
package/dist/workflow/consensus.d.ts.map +1 -0
package/dist/workflow/consensus.js +220 -0
package/dist/workflow/consensus.js.map +1 -0
package/dist/workflow/execution-mode.d.ts +82 -0
package/dist/workflow/execution-mode.d.ts.map +1 -0
package/dist/workflow/execution-mode.js +346 -0
package/dist/workflow/execution-mode.js.map +1 -0
package/dist/workflow/index.d.ts +110 -0
package/dist/workflow/index.d.ts.map +1 -0
package/dist/workflow/index.js +283 -0
package/dist/workflow/index.js.map +1 -0
package/dist/workflow/plan-mode.d.ts +83 -0
package/dist/workflow/plan-mode.d.ts.map +1 -0
package/dist/workflow/plan-mode.js +241 -0
package/dist/workflow/plan-mode.js.map +1 -0
package/dist/workflow/test-runner.d.ts +87 -0
package/dist/workflow/test-runner.d.ts.map +1 -0
package/dist/workflow/test-runner.js +273 -0
package/dist/workflow/test-runner.js.map +1 -0
package/eslint.config.js +25 -0
package/package.json +66 -0
package/src/adapters/claude.ts +298 -0
package/src/adapters/openai.ts +300 -0
package/src/auth/claude.ts +166 -0
package/src/auth/index.ts +171 -0
package/src/auth/keychain.ts +138 -0
package/src/auth/openai-entry.ts +410 -0
package/src/auth/openai.ts +260 -0
package/src/auth/server.ts +252 -0
package/src/cli/commands/auth.ts +194 -0
package/src/cli/commands/config.ts +241 -0
package/src/cli/commands/create.ts +308 -0
package/src/cli/commands/index.ts +10 -0
package/src/cli/commands/resume.ts +304 -0
package/src/cli/commands/status.ts +189 -0
package/src/cli/index.ts +90 -0
package/src/cli/interactive.ts +418 -0
package/src/cli/output.ts +410 -0
package/src/config/defaults.ts +114 -0
package/src/config/index.ts +315 -0
package/src/config/schema.ts +164 -0
package/src/generators/index.ts +251 -0
package/src/generators/python.ts +318 -0
package/src/generators/templates/index.ts +6 -0
package/src/generators/templates/python.ts +465 -0
package/src/generators/templates/typescript.ts +417 -0
package/src/generators/typescript.ts +340 -0
package/src/index.ts +13 -0
package/src/state/index.ts +454 -0
package/src/state/persistence.ts +230 -0
package/src/types/cli.ts +146 -0
package/src/types/consensus.ts +116 -0
package/src/types/index.ts +64 -0
package/src/types/project.ts +85 -0
package/src/types/workflow.ts +149 -0
package/src/workflow/consensus.ts +299 -0
package/src/workflow/execution-mode.ts +517 -0
package/src/workflow/index.ts +396 -0
package/src/workflow/plan-mode.ts +356 -0
package/src/workflow/test-runner.ts +345 -0
package/tests/adapters/openai.test.ts +145 -0
package/tests/config/config.test.ts +208 -0
package/tests/generators/generators.test.ts +185 -0
package/tests/types/consensus.test.ts +152 -0
package/tests/types/project.test.ts +134 -0
package/tests/workflow/consensus.test.ts +221 -0
package/tests/workflow/test-runner.test.ts +214 -0
package/tsconfig.json +25 -0
package/vitest.config.ts +22 -0

package/src/auth/server.ts ADDED Viewed

@@ -0,0 +1,252 @@
+/**
+ * Local OAuth callback server for authentication flows
+ * Handles browser-based OAuth redirects and token entry
+ */
+import express, { type Express, type Request, type Response } from 'express';
+import { createServer, type Server } from 'http';
+import { getOpenAIEntryHTML } from './openai-entry.js';
+/**
+ * Find an available port in the specified range
+ */
+export async function findAvailablePort(start: number, end: number): Promise<number> {
+  const net = await import('net');
+  for (let port = start; port <= end; port++) {
+    const isAvailable = await new Promise<boolean>((resolve) => {
+      const server = net.createServer();
+      server.once('error', () => resolve(false));
+      server.once('listening', () => {
+        server.close();
+        resolve(true);
+      });
+      server.listen(port, '127.0.0.1');
+    });
+    if (isAvailable) {
+      return port;
+    }
+  }
+  throw new Error(`No available ports found in range ${start}-${end}`);
+}
+/**
+ * Result from the auth callback server
+ */
+export interface AuthCallbackResult {
+  success: boolean;
+  token?: string;
+  error?: string;
+}
+/**
+ * Create and start an OAuth callback server
+ *
+ * @param options - Server options
+ * @returns Promise that resolves when a token is received
+ */
+export async function startAuthCallbackServer(options: {
+  port?: number;
+  timeout?: number;
+  type: 'claude' | 'openai';
+}): Promise<AuthCallbackResult> {
+  const { type, timeout = 300000 } = options; // 5 minute default timeout
+  const port = options.port || (await findAvailablePort(3000, 3100));
+  return new Promise((resolve) => {
+    const app: Express = express();
+    // eslint-disable-next-line prefer-const
+    let server: Server;
+    // Parse JSON bodies
+    app.use(express.json());
+    app.use(express.urlencoded({ extended: true }));
+    // Serve the token entry page for OpenAI
+    if (type === 'openai') {
+      app.get('/', (_req: Request, res: Response) => {
+        res.setHeader('Content-Type', 'text/html');
+        res.send(getOpenAIEntryHTML(port));
+      });
+      // Handle token submission
+      app.get('/submit', (req: Request, res: Response) => {
+        const token = req.query.token as string;
+        if (!token) {
+          res.status(400).send('<html><body><h1>Error: No token provided</h1></body></html>');
+          return;
+        }
+        res.send(`
+          <html>
+            <head>
+              <style>
+                body {
+                  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+                  display: flex;
+                  justify-content: center;
+                  align-items: center;
+                  height: 100vh;
+                  margin: 0;
+                  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+                  color: white;
+                }
+                .container {
+                  text-align: center;
+                  padding: 40px;
+                  background: rgba(255, 255, 255, 0.1);
+                  border-radius: 16px;
+                  backdrop-filter: blur(10px);
+                }
+                h1 { margin-bottom: 16px; }
+                p { opacity: 0.9; }
+              </style>
+            </head>
+            <body>
+              <div class="container">
+                <h1>Token Received!</h1>
+                <p>You can close this window and return to the terminal.</p>
+              </div>
+            </body>
+          </html>
+        `);
+        // Close server after sending response
+        setTimeout(() => {
+          server.close();
+          resolve({ success: true, token });
+        }, 100);
+      });
+      // Handle POST submission as well
+      app.post('/submit', (req: Request, res: Response) => {
+        const token = req.body.token as string;
+        if (!token) {
+          res.status(400).json({ error: 'No token provided' });
+          return;
+        }
+        res.json({ success: true });
+        setTimeout(() => {
+          server.close();
+          resolve({ success: true, token });
+        }, 100);
+      });
+    }
+    // Handle Claude OAuth callback
+    if (type === 'claude') {
+      app.get('/callback', (req: Request, res: Response) => {
+        const code = req.query.code as string;
+        const error = req.query.error as string;
+        if (error) {
+          res.send(`
+            <html>
+              <body>
+                <h1>Authentication Failed</h1>
+                <p>Error: ${error}</p>
+                <p>You can close this window.</p>
+              </body>
+            </html>
+          `);
+          setTimeout(() => {
+            server.close();
+            resolve({ success: false, error });
+          }, 100);
+          return;
+        }
+        if (!code) {
+          res.status(400).send('<html><body><h1>Error: No authorization code</h1></body></html>');
+          return;
+        }
+        res.send(`
+          <html>
+            <head>
+              <style>
+                body {
+                  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+                  display: flex;
+                  justify-content: center;
+                  align-items: center;
+                  height: 100vh;
+                  margin: 0;
+                  background: linear-gradient(135deg, #da7756 0%, #c35f3b 100%);
+                  color: white;
+                }
+                .container {
+                  text-align: center;
+                  padding: 40px;
+                  background: rgba(255, 255, 255, 0.1);
+                  border-radius: 16px;
+                  backdrop-filter: blur(10px);
+                }
+              </style>
+            </head>
+            <body>
+              <div class="container">
+                <h1>Authentication Successful!</h1>
+                <p>You can close this window and return to the terminal.</p>
+              </div>
+            </body>
+          </html>
+        `);
+        setTimeout(() => {
+          server.close();
+          resolve({ success: true, token: code });
+        }, 100);
+      });
+    }
+    // Handle cancel
+    app.get('/cancel', (_req: Request, res: Response) => {
+      res.send(`
+        <html>
+          <body>
+            <h1>Authentication Cancelled</h1>
+            <p>You can close this window.</p>
+          </body>
+        </html>
+      `);
+      setTimeout(() => {
+        server.close();
+        resolve({ success: false, error: 'User cancelled authentication' });
+      }, 100);
+    });
+    // Start server
+    server = createServer(app);
+    server.listen(port, '127.0.0.1', () => {
+      console.log(`Auth server listening on http://127.0.0.1:${port}`);
+    });
+    // Set timeout
+    const timeoutId = setTimeout(() => {
+      server.close();
+      resolve({ success: false, error: 'Authentication timed out' });
+    }, timeout);
+    // Clear timeout when server closes
+    server.on('close', () => {
+      clearTimeout(timeoutId);
+    });
+  });
+}
+/**
+ * Get the callback URL for OAuth flows
+ */
+export function getCallbackUrl(port: number, type: 'claude' | 'openai'): string {
+  if (type === 'claude') {
+    return `http://127.0.0.1:${port}/callback`;
+  }
+  return `http://127.0.0.1:${port}`;
+}

package/src/cli/commands/auth.ts ADDED Viewed

@@ -0,0 +1,194 @@
+/**
+ * Authentication commands
+ * Handles login, logout, and status for Claude and OpenAI
+ */
+import { Command } from 'commander';
+import {
+  getAuthStatusForDisplay,
+  authenticateService,
+  logout,
+  isAuthenticated,
+} from '../../auth/index.js';
+import { authenticateOpenAIWithKey } from '../../auth/openai.js';
+import {
+  printHeader,
+  printAuthStatus,
+  printSuccess,
+  printError,
+  printInfo,
+  startSpinner,
+  succeedSpinner,
+  failSpinner,
+} from '../output.js';
+/**
+ * Create the auth command
+ */
+export function createAuthCommand(): Command {
+  const auth = new Command('auth')
+    .description('Manage authentication for Claude CLI and OpenAI API');
+  // Status subcommand
+  auth
+    .command('status')
+    .description('Show authentication status')
+    .action(async () => {
+      startSpinner('Checking authentication status...');
+      try {
+        const status = await getAuthStatusForDisplay();
+        succeedSpinner('Status retrieved');
+        printAuthStatus(status);
+        if (!status.claude.authenticated || !status.openai.authenticated) {
+          console.log();
+          printInfo('Run "popeye-cli auth login" to authenticate missing services.');
+        }
+      } catch (error) {
+        failSpinner('Failed to check status');
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+      }
+    });
+  // Login subcommand
+  auth
+    .command('login')
+    .description('Authenticate with services')
+    .argument('[service]', 'Service to authenticate (claude, openai, all)', 'all')
+    .option('--api-key <key>', 'OpenAI API key (for openai service)')
+    .action(async (service: 'claude' | 'openai' | 'all', options) => {
+      // Validate service
+      if (!['claude', 'openai', 'all'].includes(service)) {
+        printError(`Invalid service: ${service}. Use 'claude', 'openai', or 'all'.`);
+        process.exit(1);
+      }
+      printHeader('Authentication');
+      try {
+        // Handle API key for OpenAI
+        if ((service === 'openai' || service === 'all') && options.apiKey) {
+          startSpinner('Validating OpenAI API key...');
+          const success = await authenticateOpenAIWithKey(options.apiKey);
+          if (success) {
+            succeedSpinner('OpenAI API authenticated');
+          } else {
+            failSpinner('OpenAI API authentication failed');
+            if (service === 'openai') {
+              process.exit(1);
+            }
+          }
+          // If only OpenAI was requested, we're done
+          if (service === 'openai') {
+            return;
+          }
+          // Continue with Claude if 'all'
+          if (service === 'all') {
+            service = 'claude';
+          }
+        }
+        // Interactive authentication
+        const success = await authenticateService(service);
+        if (success) {
+          printSuccess('Authentication complete!');
+        } else {
+          printError('Authentication failed');
+          process.exit(1);
+        }
+      } catch (error) {
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+      }
+    });
+  // Logout subcommand
+  auth
+    .command('logout')
+    .description('Remove stored credentials')
+    .argument('[service]', 'Service to logout from (claude, openai, all)', 'all')
+    .action(async (service: 'claude' | 'openai' | 'all') => {
+      // Validate service
+      if (!['claude', 'openai', 'all'].includes(service)) {
+        printError(`Invalid service: ${service}. Use 'claude', 'openai', or 'all'.`);
+        process.exit(1);
+      }
+      try {
+        await logout(service);
+        printSuccess(`Logged out from ${service === 'all' ? 'all services' : service}`);
+      } catch (error) {
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+      }
+    });
+  // Claude-specific subcommand
+  auth
+    .command('claude')
+    .description('Authenticate with Claude CLI')
+    .action(async () => {
+      printHeader('Claude CLI Authentication');
+      const alreadyAuth = await isAuthenticated('claude');
+      if (alreadyAuth) {
+        printInfo('Already authenticated with Claude CLI');
+        return;
+      }
+      const success = await authenticateService('claude');
+      if (success) {
+        printSuccess('Claude CLI authenticated!');
+      } else {
+        printError('Claude CLI authentication failed');
+        process.exit(1);
+      }
+    });
+  // OpenAI-specific subcommand
+  auth
+    .command('openai')
+    .description('Authenticate with OpenAI API')
+    .option('--api-key <key>', 'OpenAI API key')
+    .action(async (options) => {
+      printHeader('OpenAI API Authentication');
+      if (options.apiKey) {
+        startSpinner('Validating API key...');
+        const success = await authenticateOpenAIWithKey(options.apiKey);
+        if (success) {
+          succeedSpinner('OpenAI API authenticated!');
+        } else {
+          failSpinner('Invalid API key');
+          process.exit(1);
+        }
+        return;
+      }
+      const alreadyAuth = await isAuthenticated('openai');
+      if (alreadyAuth) {
+        printInfo('Already authenticated with OpenAI API');
+        return;
+      }
+      const success = await authenticateService('openai');
+      if (success) {
+        printSuccess('OpenAI API authenticated!');
+      } else {
+        printError('OpenAI API authentication failed');
+        process.exit(1);
+      }
+    });
+  return auth;
+}

package/src/cli/commands/config.ts ADDED Viewed

@@ -0,0 +1,241 @@
+/**
+ * Config command
+ * Manage CLI configuration
+ */
+import { Command } from 'commander';
+import path from 'node:path';
+import { loadConfig, getConfigPath } from '../../config/index.js';
+import { DEFAULT_CONFIG } from '../../config/defaults.js';
+import {
+  printHeader,
+  printSection,
+  printSuccess,
+  printError,
+  printInfo,
+  printKeyValue,
+} from '../output.js';
+/**
+ * Create the config command
+ */
+export function createConfigCommand(): Command {
+  const config = new Command('config')
+    .description('Manage CLI configuration');
+  // Show current config
+  config
+    .command('show')
+    .description('Show current configuration')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+      try {
+        const loadedConfig = await loadConfig();
+        const configPath = getConfigPath();
+        if (options.json) {
+          console.log(JSON.stringify(loadedConfig, null, 2));
+          return;
+        }
+        printHeader('Current Configuration');
+        if (configPath) {
+          printInfo(`Config file: ${configPath}`);
+        } else {
+          printInfo('Using default configuration');
+        }
+        console.log();
+        printConfigSection('Consensus', loadedConfig.consensus);
+        printConfigSection('APIs', loadedConfig.apis);
+        printConfigSection('Project', loadedConfig.project);
+        printConfigSection('Directories', loadedConfig.directories);
+        printConfigSection('Output', loadedConfig.output);
+      } catch (error) {
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+      }
+    });
+  // Show defaults
+  config
+    .command('defaults')
+    .description('Show default configuration values')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+      if (options.json) {
+        console.log(JSON.stringify(DEFAULT_CONFIG, null, 2));
+        return;
+      }
+      printHeader('Default Configuration');
+      printConfigSection('Consensus', DEFAULT_CONFIG.consensus);
+      printConfigSection('APIs', DEFAULT_CONFIG.apis);
+      printConfigSection('Project', DEFAULT_CONFIG.project);
+      printConfigSection('Directories', DEFAULT_CONFIG.directories);
+      printConfigSection('Output', DEFAULT_CONFIG.output);
+    });
+  // Get a specific config value
+  config
+    .command('get')
+    .description('Get a specific configuration value')
+    .argument('<key>', 'Configuration key (e.g., consensus.threshold)')
+    .action(async (key: string) => {
+      try {
+        const loadedConfig = await loadConfig();
+        const value = getNestedValue(loadedConfig, key);
+        if (value === undefined) {
+          printError(`Configuration key not found: ${key}`);
+          process.exit(1);
+        }
+        if (typeof value === 'object') {
+          console.log(JSON.stringify(value, null, 2));
+        } else {
+          console.log(value);
+        }
+      } catch (error) {
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+      }
+    });
+  // Show config file path
+  config
+    .command('path')
+    .description('Show configuration file path')
+    .action(() => {
+      const configPath = getConfigPath();
+      if (configPath) {
+        console.log(configPath);
+      } else {
+        printInfo('No configuration file found');
+        printInfo('Create one at: .popeyerc, .popeyerc.json, .popeyerc.yaml, or popeye.config.js');
+      }
+    });
+  // Init config file
+  config
+    .command('init')
+    .description('Create a configuration file')
+    .option('-f, --format <format>', 'Config format (json, yaml)', 'json')
+    .action(async (options) => {
+      const { promises: fs } = await import('node:fs');
+      const format = options.format;
+      let filename: string;
+      let content: string;
+      if (format === 'yaml') {
+        filename = '.popeyerc.yaml';
+        content = generateYamlConfig();
+      } else {
+        filename = '.popeyerc.json';
+        content = JSON.stringify(DEFAULT_CONFIG, null, 2);
+      }
+      const filepath = path.join(process.cwd(), filename);
+      try {
+        // Check if file exists
+        try {
+          await fs.access(filepath);
+          printError(`Configuration file already exists: ${filepath}`);
+          process.exit(1);
+        } catch {
+          // File doesn't exist, good to create
+        }
+        await fs.writeFile(filepath, content, 'utf-8');
+        printSuccess(`Created configuration file: ${filepath}`);
+      } catch (error) {
+        printError(error instanceof Error ? error.message : 'Failed to create config file');
+        process.exit(1);
+      }
+    });
+  return config;
+}
+/**
+ * Print a configuration section
+ */
+function printConfigSection(name: string, section: Record<string, unknown>): void {
+  printSection(name);
+  for (const [key, value] of Object.entries(section)) {
+    if (typeof value === 'object' && value !== null) {
+      console.log(`  ${key}:`);
+      for (const [subKey, subValue] of Object.entries(value as Record<string, unknown>)) {
+        printKeyValue(`    ${subKey}`, String(subValue));
+      }
+    } else {
+      printKeyValue(`  ${key}`, String(value));
+    }
+  }
+  console.log();
+}
+/**
+ * Get a nested value from an object using dot notation
+ */
+function getNestedValue(obj: Record<string, unknown>, path: string): unknown {
+  const keys = path.split('.');
+  let current: unknown = obj;
+  for (const key of keys) {
+    if (current === null || current === undefined) {
+      return undefined;
+    }
+    if (typeof current !== 'object') {
+      return undefined;
+    }
+    current = (current as Record<string, unknown>)[key];
+  }
+  return current;
+}
+/**
+ * Generate YAML configuration content
+ */
+function generateYamlConfig(): string {
+  return `# Popeye CLI Configuration
+# See documentation for all available options
+# Consensus settings
+consensus:
+  threshold: 95
+  maxIterations: 5
+  temperature: 0.3
+  maxTokens: 4096
+# API settings
+apis:
+  openai:
+    model: gpt-4o
+    timeout: 120000
+# Project defaults
+project:
+  defaultLanguage: python
+  defaultName: my-project
+# Directory settings
+directories:
+  output: ./output
+  state: .popeye
+# Output settings
+output:
+  verbose: false
+  colors: true
+  progress: true
+`;
+}