Skip to content
erk-exec logo

erk exec Guide

erk-exec

Guide for erk exec subcommands. Use when running erk exec commands to understand syntax, find the right command for a task, or learn common workflows. Always check syntax with -h or load this skill before running erk exec commands.

SKILL.md

Full skill instructions

erk exec Guide

Quick Start

Before running any erk exec command, check syntax with -h:

erk exec <command> -h

Commands by Workflow

PR Review Operations

When addressing PR review comments or resolving threads:

CommandPurpose
get-pr-review-commentsFetch review comments (use --pr N)
resolve-review-threadResolve a thread (use --thread-id)
reply-to-discussion-commentReply to discussion comment
get-pr-discussion-commentsFetch discussion comments

Typical workflow:

  1. erk exec get-pr-review-comments --pr 123
  2. Make code changes
  3. erk exec resolve-review-thread --thread-id PRRT_xxx

Plan Operations

When working with erk-plan issues:

CommandPurpose
plan-save-to-issueSave plan to GitHub issue
get-plan-metadataGet metadata from plan issue
setup-impl-from-issueSet up .impl/ from issue
plan-submit-for-reviewExtract plan content for PR review
plan-create-review-branchCreate review branch with plan
get-issue-bodyFetch issue body (REST API)
update-issue-bodyUpdate issue body (REST API)

Session Operations

When working with Claude Code sessions:

CommandPurpose
list-sessionsList sessions for current project
preprocess-sessionCompress session for analysis
upload-sessionUpload session to gist
download-remote-sessionDownload session from gist

Marker Operations

For inter-process communication:

CommandPurpose
marker createCreate marker file
marker existsCheck if marker exists
marker readRead marker content
marker deleteDelete marker file

All marker commands require --session-id.

Full Reference

For complete syntax details on all 65+ commands:

@reference.md