mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
245 lines
11 KiB
TypeScript
245 lines
11 KiB
TypeScript
import { Command } from 'commander';
|
|
import { viewCommand } from './commands/view.js';
|
|
import { serveCommand } from './commands/serve.js';
|
|
import { stopCommand } from './commands/stop.js';
|
|
import { installCommand } from './commands/install.js';
|
|
import { uninstallCommand } from './commands/uninstall.js';
|
|
import { upgradeCommand } from './commands/upgrade.js';
|
|
import { listCommand } from './commands/list.js';
|
|
import { toolCommand } from './commands/tool.js';
|
|
import { sessionCommand } from './commands/session.js';
|
|
import { cliCommand } from './commands/cli.js';
|
|
import { memoryCommand } from './commands/memory.js';
|
|
import { coreMemoryCommand } from './commands/core-memory.js';
|
|
import { hookCommand } from './commands/hook.js';
|
|
import { readFileSync, existsSync } from 'fs';
|
|
import { fileURLToPath } from 'url';
|
|
import { dirname, join } from 'path';
|
|
|
|
const __filename = fileURLToPath(import.meta.url);
|
|
const __dirname = dirname(__filename);
|
|
|
|
interface PackageInfo {
|
|
name: string;
|
|
version: string;
|
|
description?: string;
|
|
[key: string]: unknown;
|
|
}
|
|
|
|
/**
|
|
* Load package.json with error handling
|
|
* @returns Package info with version
|
|
*/
|
|
function loadPackageInfo(): PackageInfo {
|
|
const pkgPath = join(__dirname, '../package.json');
|
|
|
|
try {
|
|
if (!existsSync(pkgPath)) {
|
|
console.error('Fatal Error: package.json not found.');
|
|
console.error(`Expected location: ${pkgPath}`);
|
|
process.exit(1);
|
|
}
|
|
|
|
const content = readFileSync(pkgPath, 'utf8');
|
|
return JSON.parse(content) as PackageInfo;
|
|
} catch (error) {
|
|
if (error instanceof SyntaxError) {
|
|
console.error('Fatal Error: package.json contains invalid JSON.');
|
|
console.error(`Parse error: ${error.message}`);
|
|
} else if (error instanceof Error) {
|
|
console.error('Fatal Error: Could not read package.json.');
|
|
console.error(`Error: ${error.message}`);
|
|
}
|
|
process.exit(1);
|
|
}
|
|
}
|
|
|
|
const pkg = loadPackageInfo();
|
|
|
|
export function run(argv: string[]): void {
|
|
const program = new Command();
|
|
|
|
program
|
|
.name('ccw')
|
|
.description('Claude Code Workflow CLI - Dashboard and workflow tools')
|
|
.version(pkg.version);
|
|
|
|
// View command (server mode with live path switching)
|
|
program
|
|
.command('view')
|
|
.description('Open workflow dashboard server with live path switching')
|
|
.option('-p, --path <path>', 'Path to project directory', '.')
|
|
.option('--port <port>', 'Server port', '3456')
|
|
.option('--no-browser', 'Start server without opening browser')
|
|
.action(viewCommand);
|
|
|
|
// Serve command (alias for view)
|
|
program
|
|
.command('serve')
|
|
.description('Alias for view command')
|
|
.option('-p, --path <path>', 'Initial project directory')
|
|
.option('--port <port>', 'Server port', '3456')
|
|
.option('--no-browser', 'Start server without opening browser')
|
|
.action(serveCommand);
|
|
|
|
// Stop command
|
|
program
|
|
.command('stop')
|
|
.description('Stop the running CCW dashboard server')
|
|
.option('--port <port>', 'Server port', '3456')
|
|
.option('-f, --force', 'Force kill process on the port')
|
|
.action(stopCommand);
|
|
|
|
// Install command
|
|
program
|
|
.command('install')
|
|
.description('Install Claude Code Workflow to your system (includes .codex/prompts)')
|
|
.option('-m, --mode <mode>', 'Installation mode: Global or Path')
|
|
.option('-p, --path <path>', 'Installation path (for Path mode)')
|
|
.option('-f, --force', 'Force installation without prompts')
|
|
.action(installCommand);
|
|
|
|
// Uninstall command
|
|
program
|
|
.command('uninstall')
|
|
.description('Uninstall Claude Code Workflow')
|
|
.action(uninstallCommand);
|
|
|
|
// Upgrade command
|
|
program
|
|
.command('upgrade')
|
|
.description('Upgrade Claude Code Workflow installations')
|
|
.option('-a, --all', 'Upgrade all installations without prompting')
|
|
.action(upgradeCommand);
|
|
|
|
// List command
|
|
program
|
|
.command('list')
|
|
.description('List all installed Claude Code Workflow instances')
|
|
.action(listCommand);
|
|
|
|
// Tool command
|
|
program
|
|
.command('tool [subcommand] [args...]')
|
|
.description('Execute CCW tools')
|
|
.option('--path <path>', 'File path (for edit_file)')
|
|
.option('--old <text>', 'Old text to replace (for edit_file)')
|
|
.option('--new <text>', 'New text (for edit_file)')
|
|
.option('--action <action>', 'Action to perform (for codex_lens)')
|
|
.option('--query <query>', 'Search query (for codex_lens)')
|
|
.option('--limit <n>', 'Max results (for codex_lens)', '20')
|
|
.option('--file <file>', 'File path for symbol extraction (for codex_lens)')
|
|
.option('--files <files>', 'Comma-separated file paths (for codex_lens update)')
|
|
.option('--languages <langs>', 'Comma-separated languages (for codex_lens init)')
|
|
.action((subcommand, args, options) => toolCommand(subcommand, args, options));
|
|
|
|
// Session command
|
|
program
|
|
.command('session [subcommand] [args...]')
|
|
.description('Workflow session lifecycle management')
|
|
.option('--location <loc>', 'Session location: active|lite-plan|lite-fix (init); Filter: active|archived|both (list)')
|
|
.option('--type <type>', 'Content type or session type')
|
|
.option('--content <json>', 'Content for write/update')
|
|
.option('--task-id <id>', 'Task ID for task content')
|
|
.option('--filename <name>', 'Filename for process/chat/etc')
|
|
.option('--dimension <dim>', 'Dimension for review-dim')
|
|
.option('--iteration <iter>', 'Iteration for review-iter')
|
|
.option('--subdir <dir>', 'Subdirectory for mkdir')
|
|
.option('--raw', 'Output raw content only')
|
|
.option('--no-metadata', 'Exclude metadata from list')
|
|
.option('--no-update-status', 'Skip status update on archive')
|
|
.action((subcommand, args, options) => sessionCommand(subcommand, args, options));
|
|
|
|
// CLI command
|
|
program
|
|
.command('cli [subcommand] [args...]')
|
|
.description('Unified CLI tool executor (gemini/qwen/codex/claude)')
|
|
.option('-p, --prompt <prompt>', 'Prompt text (alternative to positional argument)')
|
|
.option('-f, --file <file>', 'Read prompt from file (best for multi-line prompts)')
|
|
.option('--tool <tool>', 'CLI tool to use', 'gemini')
|
|
.option('--mode <mode>', 'Execution mode: analysis, write, auto', 'analysis')
|
|
.option('--model <model>', 'Model override')
|
|
.option('--cd <path>', 'Working directory')
|
|
.option('--includeDirs <dirs>', 'Additional directories (--include-directories for gemini/qwen, --add-dir for codex/claude)')
|
|
.option('--timeout <ms>', 'Timeout in milliseconds', '300000')
|
|
.option('--no-stream', 'Disable streaming output')
|
|
.option('--limit <n>', 'History limit')
|
|
.option('--status <status>', 'Filter by status')
|
|
.option('--category <category>', 'Execution category: user, internal, insight', 'user')
|
|
.option('--resume [id]', 'Resume previous session (empty=last, or execution ID, or comma-separated IDs for merge)')
|
|
.option('--id <id>', 'Custom execution ID (e.g., IMPL-001-step1)')
|
|
.option('--no-native', 'Force prompt concatenation instead of native resume')
|
|
// Storage options
|
|
.option('--project <path>', 'Project path for storage operations')
|
|
.option('--force', 'Confirm destructive operations')
|
|
.option('--cli-history', 'Target CLI history storage')
|
|
.option('--memory', 'Target memory storage')
|
|
.option('--cache', 'Target cache storage')
|
|
.option('--config', 'Target config storage')
|
|
.action((subcommand, args, options) => cliCommand(subcommand, args, options));
|
|
|
|
// Memory command
|
|
program
|
|
.command('memory [subcommand] [args...]')
|
|
.description('Memory module for context tracking and prompt optimization')
|
|
.option('--type <type>', 'Entity type: file, module, topic (track) OR source type: core_memory, workflow, cli_history (search)')
|
|
.option('--action <action>', 'Action: read, write, mention')
|
|
.option('--value <value>', 'Entity value (file path, etc.)')
|
|
.option('--session <session>', 'Session ID')
|
|
.option('--stdin', 'Read input from stdin (for Claude Code hooks)')
|
|
.option('--source <source>', 'Import source: history, sessions, all', 'all')
|
|
.option('--project <project>', 'Project name filter')
|
|
.option('--limit <n>', 'Number of results (prompt search)', '20')
|
|
.option('--sort <field>', 'Sort by: heat, reads, writes', 'heat')
|
|
.option('--json', 'Output as JSON')
|
|
.option('--context <text>', 'Current task context')
|
|
.option('--older-than <age>', 'Age threshold for pruning', '30d')
|
|
.option('--dry-run', 'Preview without deleting')
|
|
.option('--id <id>', 'Memory/session ID (for embed command)')
|
|
.option('--force', 'Force re-embed all chunks')
|
|
.option('--batch-size <n>', 'Batch size for embedding', '8')
|
|
.option('--top-k <n>', 'Number of semantic search results', '10')
|
|
.option('--min-score <f>', 'Minimum similarity score for semantic search', '0.5')
|
|
.action((subcommand, args, options) => memoryCommand(subcommand, args, options));
|
|
|
|
// Core Memory command
|
|
program
|
|
.command('core-memory [subcommand] [args...]')
|
|
.description('Manage core memory entries for strategic context')
|
|
.option('--id <id>', 'Memory ID')
|
|
.option('--all', 'Archive all memories')
|
|
.option('--before <date>', 'Archive memories before date (YYYY-MM-DD)')
|
|
.option('--interactive', 'Interactive selection')
|
|
.option('--archived', 'List archived memories')
|
|
.option('--limit <n>', 'Number of results', '50')
|
|
.option('--json', 'Output as JSON')
|
|
.option('--force', 'Skip confirmation')
|
|
.option('--tool <tool>', 'Tool to use for summary: gemini, qwen', 'gemini')
|
|
.option('--auto', 'Run auto-clustering')
|
|
.option('--scope <scope>', 'Auto-cluster scope: all, recent, unclustered', 'recent')
|
|
.option('--create', 'Create new cluster')
|
|
.option('--name <name>', 'Cluster name')
|
|
.option('--members <ids>', 'Cluster member IDs (comma-separated)')
|
|
.option('--status <status>', 'Cluster status filter')
|
|
.option('--level <level>', 'Context level: metadata, keyFiles, full')
|
|
.option('--delete', 'Delete a cluster')
|
|
.option('--merge <ids>', 'Merge clusters into target (comma-separated source IDs)')
|
|
.option('--dedup', 'Deduplicate clusters by merging similar ones')
|
|
.option('--output <file>', 'Output file path for export')
|
|
.option('--overwrite', 'Overwrite existing memories when importing')
|
|
.option('--prefix <prefix>', 'Add prefix to imported memory IDs')
|
|
.action((subcommand, args, options) => coreMemoryCommand(subcommand, args, options));
|
|
|
|
// Hook command - CLI endpoint for Claude Code hooks
|
|
program
|
|
.command('hook [subcommand] [args...]')
|
|
.description('CLI endpoint for Claude Code hooks (session-context, notify)')
|
|
.option('--stdin', 'Read input from stdin (for Claude Code hooks)')
|
|
.option('--session-id <id>', 'Session ID')
|
|
.option('--prompt <text>', 'Prompt text')
|
|
.option('--type <type>', 'Context type: session-start, context')
|
|
.action((subcommand, args, options) => hookCommand(subcommand, args, options));
|
|
|
|
program.parse(argv);
|
|
}
|