Skip to content

Commands

CoCode uses organized command groups for better structure:

  • repox - Repository processing commands
  • swe - Software Engineering analysis commands
  • validation - Pipeline validation commands
  • github - GitHub repository management

repox

Convert repository to text format.

cocode repox convert [OPTIONS] [REPO_PATH]
cocode repox repo [OPTIONS] [REPO_PATH]  # Alternative command name

Options:

  • -o, --output-dir - Output directory (default: ./results/, use stdout for console)
  • -n, --output-filename - Output filename
  • -i, --exclude-pattern - Gitignore patterns to exclude (repeatable)
  • -r, --include-pattern - Glob patterns to include (repeatable)
  • -pp, --path-pattern - Regex for path filtering
  • -p, --python-rule - Python processing: interface, imports, integral
  • -s, --output-style - Output format: repo_map, flat, tree, import_list

swe from-repo

Analyze repository with AI pipelines.

cocode swe from-repo [OPTIONS] PIPE_CODE REPO_PATH

Pipelines:

  • extract_fundamentals - Project overview
  • extract_onboarding_documentation - Onboarding docs
  • extract_environment_build - Build setup
  • extract_coding_standards - Code standards
  • extract_test_strategy - Testing approach
  • extract_collaboration - Team workflows

Options:

  • -o, --output-dir - Output directory
  • -n, --output-filename - Output filename
  • --dry - Dry run without API calls
  • Plus all filtering options from repox

swe from-file

Process text file with AI pipelines.

cocode swe from-file [OPTIONS] PIPE_CODE INPUT_FILE

Pipelines:

  • extract_features_recap - Summarize features
  • extract_fundamentals - Extract project info
  • extract_onboarding_documentation - Structure docs

swe from-repo-diff

Analyze git diffs with AI.

cocode swe from-repo-diff [OPTIONS] PIPE_CODE GIT_REF REPO_PATH

Main pipeline:

  • write_changelog - Generate changelog

Git references:

  • Tags: v1.0.0
  • Commits: abc123
  • Ranges: v1.0.0..v2.0.0
  • Relative: HEAD~10

swe doc-proofread

Proofread documentation against codebase to detect inconsistencies.

cocode swe doc-proofread [OPTIONS] REPO_PATH

Purpose: Detect critical inconsistencies between documentation and actual codebase that could break user code.

Options:

  • --doc-dir - Documentation directory to analyze (default: docs)
  • -o, --output-dir - Output directory (default: ./results/)
  • -n, --output-filename - Output filename
  • --dry - Dry run without API calls
  • Plus all filtering options from repox

github

GitHub repository management commands.

github auth

Check GitHub authentication status.

cocode github auth

Displays authenticated user info and API rate limits.

github repo-info

Get repository information.

cocode github repo-info REPO

Arguments: - REPO - Repository as owner/repo or repository ID

github check-branch

Check if a branch exists.

cocode github check-branch REPO BRANCH

Arguments: - REPO - Repository as owner/repo or repository ID - BRANCH - Branch name to check

github list-branches

List repository branches.

cocode github list-branches [OPTIONS] REPO

Arguments: - REPO - Repository as owner/repo or repository ID

Options: - --limit - Maximum branches to show (default: 10)

github sync-labels

Sync issue labels from JSON file.

cocode github sync-labels [OPTIONS] REPO LABELS_FILE

Arguments: - REPO - Repository as owner/repo or repository ID - LABELS_FILE - JSON file with label definitions

Options: - --dry-run - Preview changes without applying - --delete-extra - Remove labels not in JSON file

Label JSON format: 

[
  {
    "name": "bug",
    "color": "d73a4a",
    "description": "Something isn't working"
  }
]

swe doc-update

Update documentation based on code changes.

cocode swe doc-update [OPTIONS] GIT_REF REPO_PATH

Purpose: Automatically update docs and README files based on releases and code changes.

Git references:

  • Tags: v1.0.0
  • Commits: abc123
  • Ranges: v1.0.0..v2.0.0
  • Relative: HEAD~10

Options:

  • -o, --output-dir - Output directory (default: ./results/)
  • -n, --output-filename - Output filename
  • --dry - Dry run without API calls

GitHub commands

GitHub-related operations and utilities.

github auth

Check GitHub authentication status.

cocode github auth

Shows current authenticated user, rate limit info, and validates API access.

github check-branch

Check if a branch exists in a GitHub repository.

cocode github check-branch REPO BRANCH

Arguments: - REPO - Repository in format 'owner/repo' or repo ID - BRANCH - Branch name to check

github repo-info

Get basic information about a GitHub repository.

cocode github repo-info REPO

Arguments: - REPO - Repository in format 'owner/repo' or repo ID

Shows repository details including description, language, stars, forks, and creation date.

github list-branches

List branches in a GitHub repository.

cocode github list-branches [OPTIONS] REPO

Arguments: - REPO - Repository in format 'owner/repo' or repo ID

Options: - -l, --limit - Maximum number of branches to show (default: 10)

github sync-labels

Sync labels to a GitHub repository from a JSON file.

cocode github sync-labels [OPTIONS] REPO LABELS_FILE

Arguments: - REPO - Repository in format 'owner/repo' or repo ID - LABELS_FILE - Path to JSON file containing labels to sync

Options: - --dry-run - Show what would be done without making changes - --delete-extra - Delete labels not in the standard set

Other commands

  • cocode validate - Check setup
  • cocode help - Show help