CLI Commands Reference

This page documents every command, argument, and option available in the slack-ticket CLI. All commands support --help for quick reference.

General Usage

slack-ticket [command] [options]

Commands Overview

setup

Interactive wizard for first-time configuration. Safe to re-run to update values.

slack-ticket setup

When to use: After installation or when updating API keys or default repository settings.

create — Generate GitHub Issue

The core command—fetches a Slack thread and creates a structured GitHub issue using AI.

slack-ticket create <slack-thread-url> [options]

Arguments

Example: slack-ticket create https://myworkspace.slack.com/archives/C12345/p1679090123456789

Options

Examples

# Basic usage with default settings
slack-ticket create https://yourworkspace.slack.com/archives/C123/p123

# Fetch deeper thread context (up to 10 messages)
slack-ticket create <url> --depth 10

# Create with specific severity and component
slack-ticket create <url> --severity high --component backend

# Override repository for this specific issue
slack-ticket create <url> --repo your-org/other-repo

# Preview what would be generated without creating
slack-ticket create <url> --dry-run

update — Append to Existing Issue

Add new Slack messages to an existing GitHub issue, keeping context alive as discussions evolve.

slack-ticket update <issue-number> <slack-message-url...> [options]

Arguments

Options

Examples

# Update issue with new Slack messages
slack-ticket update 42 https://yourworkspace.slack.com/archives/C123/p456

# Add as a comment instead of updating the issue body
slack-ticket update 42 <url> --comment

# Multiple Slack messages at once
slack-ticket update 42 <url1> <url2> <url3>

doctor — Diagnostics

Validate all configured tokens and permissions. Run this when experiencing issues.

slack-ticket doctor

Checks:

• Slack token validity and bot channel access
• GitHub token validity and repository permissions
• AI provider connectivity and authentication

Example output:

✓ Slack: Token valid, channels accessible
✓ GitHub: Token valid, repo permissions confirmed
✓ AI Provider: Connection successful

config view — Display Configuration

Print current configuration with sensitive tokens masked.

slack-ticket config view

Useful for verifying settings without exposing API keys.

config edit — Edit Configuration

Open configuration file in your system’s default editor.

slack-ticket config edit

This uses the $EDITOR environment variable (defaults to vi on most systems).

Common edits:

• Adjust label keyword mappings
• Change default thread depth
• Modify severity thresholds

Global Options

Exit Codes

Tips for Teams

1. Use --dry-run to preview AI-generated issues before creating
2. Use --yes in CI/CD pipelines to skip prompts
3. Run doctor if authentication errors occur
4. Combine with shell scripts for batch processing multiple threads

Learn more about AI analysis or the creation workflow.