diff --git a/cmd/gh-aw/main.go b/cmd/gh-aw/main.go index 2490e57e44..e4a8165350 100644 --- a/cmd/gh-aw/main.go +++ b/cmd/gh-aw/main.go @@ -199,7 +199,7 @@ var disableCmd = &cobra.Command{ Use: "disable [workflow]...", Short: "Disable agentic workflows and cancel any in-progress runs", Long: `Disable one or more workflows by ID, or all workflows if no IDs are provided. - +Any in-progress runs will be cancelled before disabling. ` + cli.WorkflowIDExplanation + ` Examples: @@ -355,7 +355,7 @@ Examples: gh aw run daily-perf-improver gh aw run daily-perf-improver.md # Alternative format gh aw run daily-perf-improver --ref main # Run on specific branch - gh aw run daily-perf-improver --repeat 3 # Run 3 times total + gh aw run daily-perf-improver --repeat 3 # Run 4 times total (1 initial + 3 repeats) gh aw run daily-perf-improver --enable-if-needed # Enable if disabled, run, then restore state gh aw run daily-perf-improver --auto-merge-prs # Auto-merge any PRs created during execution gh aw run daily-perf-improver -F name=value -F env=prod # Pass workflow inputs @@ -656,7 +656,7 @@ Use "` + string(constants.CLIExtensionPrefix) + ` help all" to show help for all disableCmd.ValidArgsFunction = cli.CompleteWorkflowNames // Add flags to run command - runCmd.Flags().Int("repeat", 0, "Number of times to repeat running workflows (0 = run once)") + runCmd.Flags().Int("repeat", 0, "Number of additional times to run after the initial execution (e.g., --repeat 3 runs 4 times total)") runCmd.Flags().Bool("enable-if-needed", false, "Enable the workflow before running if needed, and restore state afterward") runCmd.Flags().StringP("engine", "e", "", "Override AI engine (claude, codex, copilot, custom)") runCmd.Flags().StringP("repo", "r", "", "Target repository ([HOST/]owner/repo format). Defaults to current repository") diff --git a/pkg/cli/fix_command.go b/pkg/cli/fix_command.go index 89bf17300c..27b9cd6a9f 100644 --- a/pkg/cli/fix_command.go +++ b/pkg/cli/fix_command.go @@ -38,15 +38,7 @@ func NewFixCommand() *cobra.Command { This command applies a registry of codemods that automatically update deprecated fields and migrate to new syntax. Codemods preserve formatting and comments as much as possible. -Available codemods: - • timeout-minutes-migration: Replaces 'timeout_minutes' with 'timeout-minutes' - • network-firewall-migration: Removes deprecated 'network.firewall' field - • sandbox-false-to-agent-false: Converts 'sandbox: false' to 'sandbox.agent: false' - • safe-inputs-mode-removal: Removes deprecated 'safe-inputs.mode' field - • schedule-at-to-around-migration: Converts 'daily at TIME' to 'daily around TIME' - • delete-schema-file: Deletes deprecated .github/aw/schemas/agentic-workflow.json - • delete-old-agents: Deletes old workflow-specific .agent.md files from .github/agents/ - • delete-old-templates: Removes old template files from pkg/cli/templates/ +Use --list-codemods to see all available codemods and their descriptions. If no workflows are specified, all Markdown files in .github/workflows will be processed. diff --git a/pkg/cli/project_command.go b/pkg/cli/project_command.go index 27f22ea766..876b818462 100644 --- a/pkg/cli/project_command.go +++ b/pkg/cli/project_command.go @@ -68,9 +68,9 @@ Authentication Requirements: See https://github.github.com/gh-aw/reference/auth/. Project Setup: - Use --with-project-setup to automatically create: - - Standard views (Progress Board, Task Tracker, Roadmap) - - Custom fields (Tracker Id, Worker Workflow, Target Repo, Priority, Size, dates) + Use --with-project-setup to automatically create: + - Standard views (Progress Board, Task Tracker, Roadmap) + - Custom fields (Tracker Id, Worker Workflow, Target Repo, Priority, Size, dates) - Enhanced Status field with "Review Required" option Examples: diff --git a/pkg/cli/trial_command.go b/pkg/cli/trial_command.go index 09663e9a44..a0ba966f31 100644 --- a/pkg/cli/trial_command.go +++ b/pkg/cli/trial_command.go @@ -94,7 +94,7 @@ Repository mode examples: ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --clone-repo myorg/myrepo # Clone myorg/myrepo contents into host Repeat and cleanup examples: - ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --repeat 3 # Run 3 times total + ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --repeat 3 # Run 4 times total (1 initial + 3 repeats) ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --delete-host-repo-after # Delete repo after completion ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --host-repo my-trial # Custom host repo ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --dry-run # Show what would be done without changes @@ -187,7 +187,7 @@ Trial results are saved both locally (in trials/ directory) and in the host repo cmd.Flags().Bool("dry-run", false, "Show what would be done without making any changes") cmd.Flags().Int("timeout", 30, "Execution timeout in minutes (default: 30)") cmd.Flags().String("trigger-context", "", "Trigger context URL (e.g., GitHub issue URL) for issue-triggered workflows") - cmd.Flags().Int("repeat", 0, "Number of times to repeat running workflows (0 = run once)") + cmd.Flags().Int("repeat", 0, "Number of additional times to run after the initial execution (e.g., --repeat 3 runs 4 times total)") cmd.Flags().Bool("auto-merge-prs", false, "Auto-merge any pull requests created during trial execution") addEngineFlag(cmd) cmd.Flags().String("append", "", "Append extra content to the end of agentic workflow on installation")