Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 30, 2026

The CLI documentation referenced a gh aw campaign command that was never implemented. Users attempting to use documented commands like gh aw campaign list or gh aw campaign status would encounter "unknown command" errors.

Changes

  • CLI documentation (docs/src/content/docs/setup/cli.md): Removed "Agentic campaigns" section documenting the non-existent command
  • Package docs (pkg/cli/doc.go): Removed campaign command from available commands list

Notes

Campaign functionality remains accessible via the create-agentic-campaign label workflow (documented in campaign guides). This change only removes documentation for the CLI command that was removed from the implementation.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>[cli-consistency] Missing 'campaign' command documented but not implemented</issue_title>
<issue_description>## Issue Description

Priority: High
Type: Missing feature / Documentation mismatch

Problem

The CLI documentation at docs/src/content/docs/setup/cli.md extensively documents a campaign command (lines 408-420), but this command is not implemented in the codebase.

Current State (Documentation)

From docs/src/content/docs/setup/cli.md:

#### `campaign`

Manage campaign definitions. See [Agentic Campaigns Guide](/gh-aw/guides/campaigns/) for complete documentation.

**Quick Reference:**
- `gh aw campaign` - List campaigns
- `gh aw campaign status` - Show live status
- `gh aw campaign new (id)` - Create new campaign
- `gh aw campaign validate` - Validate specs

**Options:** `--json`

Alternative: create an issue with the `create-agentic-campaign` label to trigger automated campaign creation ([docs](/gh-aw/guides/campaigns/)).

Actual State (Source Code)

Evidence from code analysis:

  1. Not in main.go: The campaign command is not registered in cmd/gh-aw/main.go (checked lines 1-628)
  2. No command constructor: Search for NewCampaignCommand in pkg/cli/*.go returned no results
  3. No command file: Only found pkg/cli/workflows/example-campaign.md (example workflow, not command)

Impact

  • Users following documentation will encounter "unknown command: campaign" errors
  • Documentation claims functionality that doesn't exist
  • Confusing user experience when trying documented features

Suggested Fix

Option 1 (Preferred): Remove campaign command documentation until implemented

  • Remove lines 408-420 from docs/src/content/docs/setup/cli.md
  • Keep the alternative method (create-agentic-campaign label) which appears to be the actual implementation

Option 2: Implement the campaign command

  • Create pkg/cli/campaign_command.go with subcommands: list, status, new, validate
  • Register in cmd/gh-aw/main.go
  • Add to appropriate command group (likely "analysis" or "execution")

Related Code

AI generated by CLI Consistency Checker

Comments on the Issue (you are @copilot in this section)

@pelikhan Option 1 ; the command has been removed

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits January 30, 2026 15:06
Fixes #12740

The campaign command is not implemented in the CLI. The campaign feature
is accessed via the create-agentic-campaign label workflow, not through
a CLI command. Removing the misleading documentation as suggested by
the maintainer.

- Removed campaign command section from cli.md (lines 406-420)
- Verified documentation builds successfully
- No other references to "gh aw campaign" command found

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
- Remove outdated campaign command reference from pkg/cli/doc.go
- Update package description to remove "managing campaigns"
- Ensures consistency with CLI command removal

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add implementation for missing campaign command in CLI Remove undocumented campaign CLI command from documentation Jan 30, 2026
Copilot AI requested a review from pelikhan January 30, 2026 15:09
@pelikhan pelikhan marked this pull request as ready for review January 30, 2026 15:14
@pelikhan pelikhan merged commit 79174da into main Jan 30, 2026
1 check passed
@pelikhan pelikhan deleted the copilot/add-campaign-command-implementation branch January 30, 2026 15:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[cli-consistency] Missing 'campaign' command documented but not implemented

2 participants