---

name: epic-cli description: Use the Epic CLI for project management, issue tracking, PR workflows, git worktrees, and debugging. Triggers on requests like "create a project", "start an issue", "work on PR", "create worktree", or "add debug statements".

Epic CLI

Overview

Epic CLI is a project and issue management tool that integrates with GitHub. It handles project creation, issue tracking, PR workflows, git worktrees, and debugging utilities.

Commands

Project Management

Create new projects with GitHub repository:

Copyepic project new my-awesome-project
epic project new org/repo-name
epic project new my-web-app --web    # Use web template

Issue Management

Issue IDs can be: markdown file path, issue number, or prefix-number (e.g., SCA-8).

PR Management

Start working on a pull request:

Copyepic pr start 359            # Creates worktree + tmux session
epic pr start 359 --no-tmux  # Creates worktree only

Worktree

Open a shell in a worktree directory:

Copyepic worktree <branch-name>

Ask (LLM Query)

Query an LLM for assistance:

Copyepic ask "What is the purpose of git worktrees?"
epic ask "Explain async/await" --model gpt-4o

Available models: gpt-4.1 (default), gpt-4.1-mini, gpt-4.1-nano, gpt-4o, o1-mini, o1

Debug

Add/remove debug statements and diagnostic tools:

Copyepic debug add <function-name> <file-path>      # Add debug statement
epic debug remove <function-name> <file-path>   # Remove debug statement
epic debug remove-all                           # Remove all console.debug from project
epic debug check-gitignore                      # Check .gitignore for worktrees
epic debug check-gitignore --fix                # Fix .gitignore if needed

Draft

Create draft files:

Copyepic draft new

Issue File Format

Issues are stored in docs/issues/ with pattern {prefix}-{number}-{slug}.md. Contains:

• Title and GitHub issue number (if synced)
• Status
• Description
• Functional and Technical specifications
• Task checklist

Common Workflows

Start working on an issue:

Copyepic issue start SCA-8

This creates a worktree, tmux session, runs claude, and switches to the session.

Create and sync a new issue:

Copyepic issue new "Add dark mode support"

Review open issues:

Copyepic issue list open

Work on a PR:

Copyepic pr start 359