@revotools/cli 0.3.0 → 0.5.0

package/dist/revo

@@ -8,7 +8,7 @@ set -euo pipefail
 # Exit cleanly on SIGPIPE (e.g., revo clone | grep, revo status | head)
 trap 'exit 0' PIPE
 
-REVO_VERSION="0.3.0"
+REVO_VERSION="0.5.0"
 
 
 # === lib/ui.sh ===
@@ -794,8 +794,52 @@ config_init() {
     # Write config
     yaml_write "$REVO_CONFIG_FILE"
 
-    # Create .gitignore
-    printf 'repos/\n.revo/\n' > "$dir/.gitignore"
+    # Merge revo's required entries into .gitignore without clobbering
+    # any existing user entries.
+    config_ensure_gitignore "$dir/.gitignore"
+
+    return 0
+}
+
+# Ensure the given .gitignore contains the entries revo needs
+# (`repos/` and `.revo/`). Existing content is preserved; only missing
+# entries are appended. Creates the file if it doesn't exist.
+# Usage: config_ensure_gitignore "/path/to/.gitignore"
+config_ensure_gitignore() {
+    local gitignore="$1"
+    local needed
+    needed=$(printf 'repos/\n.revo/\n')
+
+    if [[ ! -f "$gitignore" ]]; then
+        printf '%s\n' "$needed" > "$gitignore"
+        return 0
+    fi
+
+    # Append only the entries that aren't already present (exact line match,
+    # ignoring leading/trailing whitespace and comments).
+    local entry has_entry needs_newline=0
+    # If the file is non-empty and doesn't end in a newline, we need to add
+    # one before appending so we don't merge into an existing line.
+    if [[ -s "$gitignore" ]] && [[ -n "$(tail -c1 "$gitignore" 2>/dev/null)" ]]; then
+        needs_newline=1
+    fi
+
+    local appended=0
+    while IFS= read -r entry; do
+        [[ -z "$entry" ]] && continue
+        has_entry=$(awk -v e="$entry" '
+            { sub(/^[[:space:]]+/, ""); sub(/[[:space:]]+$/, "") }
+            $0 == e { found = 1; exit }
+            END { exit !found }
+        ' "$gitignore" && printf 'yes' || printf 'no')
+        if [[ "$has_entry" == "no" ]]; then
+            if [[ $appended -eq 0 ]] && [[ $needs_newline -eq 1 ]]; then
+                printf '\n' >> "$gitignore"
+            fi
+            printf '%s\n' "$entry" >> "$gitignore"
+            appended=1
+        fi
+    done <<< "$needed"
 
     return 0
 }
@@ -1515,45 +1559,13 @@ _init_scan_existing() {
     fi
 }
 
-# Write a Claude-first onboarding CLAUDE.md, or append a revo section if the
-# user already has their own CLAUDE.md in the workspace root.
+# Write a Claude-first onboarding CLAUDE.md if and only if the workspace
+# root has no CLAUDE.md yet. Existing files are left alone — `revo context`
+# will append its marker-wrapped auto block once repos are added.
 _init_write_claude_md() {
     local out="$REVO_WORKSPACE_ROOT/CLAUDE.md"
 
-    if [[ -f "$out" ]] && ! grep -q "managed by revo" "$out" 2>/dev/null; then
-        if grep -q "Workspace Tool: revo" "$out" 2>/dev/null; then
-            return 0
-        fi
-        cat >> "$out" << 'EOF'
-
----
-
-## Workspace Tool: revo
-
-This workspace uses revo to manage multiple repos.
-Source: https://github.com/jippylong12/revo
-
-### Setup commands
-- `revo add <git-url> --tags <tags> [--depends-on <repo>]` — add a repo to workspace
-- `revo clone` — clone all configured repos
-- `revo context` — scan repos and regenerate the workspace context section
-
-### Daily commands
-- `revo status` — branch and dirty state across all repos
-- `revo sync` — pull latest across all repos
-- `revo feature <name>` — create feature branch across all repos
-- `revo commit "msg"` — commit all dirty repos with same message
-- `revo push` — push all repos
-- `revo pr "title"` — create coordinated PRs via gh CLI
-- `revo exec "cmd" --tag <tag>` — run command in filtered repos
-
-### Working in this workspace
-- Repos live in the repos/ subdirectory (or wherever configured in revo.yaml)
-- Edit files across repos directly
-- Check .revo/features/ for active feature briefs
-- Follow dependency order when making cross-repo changes
-EOF
-        ui_step_done "Appended revo section to existing CLAUDE.md"
+    if [[ -f "$out" ]]; then
         return 0
     fi
 
@@ -1693,16 +1705,18 @@ cmd_init() {
         fi
     fi
 
-    # Write the Claude-first onboarding CLAUDE.md (or append to user's own).
-    _init_write_claude_md
-
-    # If we detected repos, immediately generate the full workspace context.
+    # If we detected repos, hand off to cmd_context — it now wraps its output
+    # in BEGIN/END markers and preserves any user content in CLAUDE.md, so we
+    # don't need the onboarding placeholder. When no repos were detected,
+    # write the placeholder so Claude has something to read.
     if [[ $detected_count -gt 0 ]]; then
         ui_bar_line
         cmd_context
         return 0
     fi
 
+    _init_write_claude_md
+
     ui_outro "Workspace initialized! Run 'revo add <url>' to add repositories."
     return 0
 }
@@ -2752,15 +2766,75 @@ _context_topo_sort() {
     return 0
 }
 
-# Write the workspace CLAUDE.md to the given path.
+# Markers used to delimit revo's auto-generated block inside the workspace
+# CLAUDE.md. Anything between these markers is owned by `revo context` and
+# replaced on every regeneration. Anything outside is preserved untouched.
+CONTEXT_BEGIN_MARKER='<!-- BEGIN revo:auto - regenerated by `revo context`, do not edit between markers -->'
+CONTEXT_END_MARKER='<!-- END revo:auto -->'
+
+# Splice an auto-generated block into the target CLAUDE.md without
+# clobbering user content.
+#  - If target doesn't exist: copy auto file to target.
+#  - If target has BEGIN+END markers: replace the marker block in place.
+#  - Otherwise: append the auto block (with a separator) at the end.
+# Usage: _context_merge_into "/tmp/auto" "/path/to/CLAUDE.md"
+_context_merge_into() {
+    local auto_file="$1"
+    local target="$2"
+
+    if [[ ! -f "$target" ]]; then
+        cp "$auto_file" "$target"
+        return 0
+    fi
+
+    if grep -qF "$CONTEXT_BEGIN_MARKER" "$target" 2>/dev/null \
+        && grep -qF "$CONTEXT_END_MARKER" "$target" 2>/dev/null; then
+        local merged
+        merged=$(mktemp -t revo-merge.XXXXXX)
+        awk -v auto="$auto_file" -v begin="$CONTEXT_BEGIN_MARKER" -v end="$CONTEXT_END_MARKER" '
+            BEGIN { in_block = 0 }
+            index($0, begin) == 1 {
+                in_block = 1
+                while ((getline line < auto) > 0) print line
+                close(auto)
+                next
+            }
+            index($0, end) == 1 && in_block {
+                in_block = 0
+                next
+            }
+            !in_block { print }
+        ' "$target" > "$merged"
+        mv "$merged" "$target"
+        return 0
+    fi
+
+    # No markers — append at the end with a blank-line separator. If the
+    # existing file doesn't end in a newline, add one first so we don't merge
+    # into the user's last line.
+    if [[ -s "$target" ]] && [[ -n "$(tail -c1 "$target" 2>/dev/null)" ]]; then
+        printf '\n' >> "$target"
+    fi
+    printf '\n' >> "$target"
+    cat "$auto_file" >> "$target"
+    return 0
+}
+
+# Write the workspace CLAUDE.md to the given path. The auto-generated content
+# is wrapped in BEGIN/END markers and spliced into any existing CLAUDE.md so
+# user content above and below the markers is preserved across regenerations.
 # Usage: _context_write_file "/path/to/CLAUDE.md"
 _context_write_file() {
-    local output="$1"
+    local target="$1"
     local workspace
     workspace=$(config_workspace_name)
 
-    # Start file
+    local output
+    output=$(mktemp -t revo-auto.XXXXXX)
+
+    # Start auto block (markers + header)
     {
+        printf '%s\n' "$CONTEXT_BEGIN_MARKER"
         printf '# Workspace Context (auto-generated by revo)\n'
         printf '\n'
         printf 'This workspace contains multiple repositories managed by revo.\n'
@@ -2768,8 +2842,9 @@ _context_write_file() {
             printf 'Workspace: **%s**\n' "$workspace"
         fi
         printf '\n'
-        printf '> This file is regenerated by `revo context`. Manual edits below the\n'
-        printf '> `## Agent Instructions` section will be preserved across regeneration.\n'
+        printf '> This block is auto-generated by `revo context`. Edits between the\n'
+        printf '> BEGIN/END markers will be lost on regeneration. Add your own content\n'
+        printf '> above or below the markers.\n'
         printf '\n'
         printf '## Repos\n'
         printf '\n'
@@ -2927,6 +3002,15 @@ _context_write_file() {
         printf -- '- `revo exec "cmd" [--tag t]` — run command in filtered repos\n'
         printf -- '- `revo checkout <branch> [--tag t]` — switch branch across repos\n'
         printf '\n'
+        printf '**Issues (cross-repo, via gh CLI):**\n'
+        printf -- '- `revo issue list [--tag t] [--state open|closed|all] [--label L] [--json]` — list issues across repos\n'
+        printf -- '- `revo issue create --repo <name> "title" [--body b] [--label L] [--feature F]` — create in one repo\n'
+        printf -- '- `revo issue create --tag <t> "title" [--body b] [--feature F]` — create in every matching repo, cross-referenced\n'
+        printf '\n'
+        printf 'Use `--json` on `revo issue list` to get a flat JSON array (each entry has\n'
+        printf 'a `repo` field) — easy to filter or pipe into jq when reasoning about\n'
+        printf 'cross-repo issue state.\n'
+        printf '\n'
         printf '### Tag filtering\n'
         printf '\n'
         printf 'All commands support `--tag <tag>` to target specific repos:\n'
@@ -2946,7 +3030,13 @@ _context_write_file() {
         printf 'revo commit "feat: my feature"   # commits all dirty repos\n'
         printf 'revo pr "My feature"             # coordinated PRs\n'
         printf '```\n'
+        printf '\n'
+        printf '%s\n' "$CONTEXT_END_MARKER"
     } >> "$output"
+
+    # Splice the auto block into the target file, preserving any user content.
+    _context_merge_into "$output" "$target"
+    rm -f "$output"
 }
 
 cmd_context() {
@@ -3577,6 +3667,433 @@ cmd_pr() {
     return 0
 }
 
+# === lib/commands/issue.sh ===
+# Revo CLI - issue command
+# List and create GitHub issues across workspace repos via the gh CLI.
+
+cmd_issue() {
+    local subcommand="${1:-}"
+    [[ $# -gt 0 ]] && shift
+
+    case "$subcommand" in
+        list|ls)
+            _issue_list "$@"
+            ;;
+        create|new)
+            _issue_create "$@"
+            ;;
+        --help|-h|help|"")
+            _issue_help
+            return 0
+            ;;
+        *)
+            ui_step_error "Unknown subcommand: $subcommand"
+            _issue_help
+            return 1
+            ;;
+    esac
+}
+
+_issue_help() {
+    cat << 'EOF'
+Usage: revo issue <subcommand> [options]
+
+Subcommands:
+  list                                    List issues across workspace repos
+  create                                  Create issue(s) in workspace repos
+
+revo issue list [options]
+  --tag TAG                Filter repos by tag
+  --state open|closed|all  Issue state (default: open)
+  --label LABEL            Filter by label
+  --limit N                Per-repo limit (default: 30)
+  --json                   Emit a flat JSON array (one entry per issue,
+                           with a "repo" field)
+
+revo issue create (--repo NAME | --tag TAG) "TITLE" [options]
+  --repo NAME              Target a single repo by path basename
+  --tag TAG                Target every repo matching the tag (cross-references
+                           all created issues in each body)
+  --body BODY              Issue body (default: revo-generated stub)
+  --label L,L              Comma-separated labels
+  --assignee USER          GitHub username to assign
+  --feature NAME           Append issue links to .revo/features/NAME.md and
+                           reference the brief from each issue body
+EOF
+}
+
+# --- list ----------------------------------------------------------------
+
+_issue_list() {
+    local tag=""
+    local state="open"
+    local label=""
+    local limit="30"
+    local as_json=0
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag) tag="$2"; shift 2 ;;
+            --state) state="$2"; shift 2 ;;
+            --label) label="$2"; shift 2 ;;
+            --limit) limit="$2"; shift 2 ;;
+            --json) as_json=1; shift ;;
+            --help|-h) _issue_help; return 0 ;;
+            *) ui_step_error "Unknown option: $1"; return 1 ;;
+        esac
+    done
+
+    if ! command -v gh >/dev/null 2>&1; then
+        ui_step_error "gh CLI not found. Install from https://cli.github.com/"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    local repos
+    repos=$(config_get_repos "$tag")
+    if [[ -z "$repos" ]]; then
+        if [[ $as_json -eq 1 ]]; then
+            printf '[]\n'
+            return 0
+        fi
+        ui_step_error "No repositories configured"
+        return 1
+    fi
+
+    # Build the per-repo gh args once
+    local gh_extra=()
+    if [[ -n "$label" ]]; then
+        gh_extra+=( --label "$label" )
+    fi
+
+    if [[ $as_json -eq 1 ]]; then
+        _issue_list_json "$repos" "$state" "$limit" "${gh_extra[@]}"
+        return $?
+    fi
+
+    _issue_list_human "$repos" "$state" "$limit" "${gh_extra[@]}"
+}
+
+# Print a flat JSON array of issues across all repos. Each entry has a
+# "repo" field added in addition to the gh-provided fields. Output goes to
+# stdout, errors are silent (we want callers like Claude to be able to
+# pipe into jq).
+_issue_list_json() {
+    local repos="$1"
+    local state="$2"
+    local limit="$3"
+    shift 3
+    local gh_extra=( "$@" )
+
+    local entries=""
+    local first=1
+
+    local repo
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+        [[ ! -d "$full_path" ]] && continue
+
+        # gh's --jq runs the embedded jq engine and emits one compact JSON
+        # value per line by default. We map each issue, prepend a "repo"
+        # field, and stream the results into our concatenated array.
+        local lines
+        if lines=$(cd "$full_path" && gh issue list \
+            --state "$state" --limit "$limit" "${gh_extra[@]}" \
+            --json number,title,state,labels,assignees,url,updatedAt,author \
+            --jq ".[] | {repo: \"$path\"} + ." 2>/dev/null); then
+            local line
+            while IFS= read -r line; do
+                [[ -z "$line" ]] && continue
+                if [[ $first -eq 1 ]]; then
+                    entries="$line"
+                    first=0
+                else
+                    entries="$entries,$line"
+                fi
+            done <<< "$lines"
+        fi
+    done <<< "$repos"
+
+    printf '[%s]\n' "$entries"
+    return 0
+}
+
+# Print a human-readable per-repo summary of issues. Each repo gets its
+# own block separated by ui_bar_line.
+_issue_list_human() {
+    local repos="$1"
+    local state="$2"
+    local limit="$3"
+    shift 3
+    local gh_extra=( "$@" )
+
+    ui_intro "Revo - Issues ($state)"
+
+    local total=0
+    local repo_count=0
+    local skip_count=0
+
+    local repo
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        ui_bar_line
+        ui_step "$path"
+
+        local count_output
+        if ! count_output=$(cd "$full_path" && gh issue list \
+            --state "$state" --limit "$limit" "${gh_extra[@]}" \
+            --json number --jq 'length' 2>&1); then
+            ui_step_error "Failed: $count_output"
+            continue
+        fi
+
+        local repo_total="${count_output:-0}"
+        if [[ "$repo_total" == "0" ]]; then
+            printf '%s  %s\n' "$(ui_bar)" "$(ui_dim "No $state issues")"
+            continue
+        fi
+
+        local pretty
+        if pretty=$(cd "$full_path" && gh issue list \
+            --state "$state" --limit "$limit" "${gh_extra[@]}" 2>&1); then
+            local line
+            while IFS= read -r line; do
+                printf '%s  %s\n' "$(ui_bar)" "$line"
+            done <<< "$pretty"
+        fi
+
+        total=$((total + repo_total))
+        repo_count=$((repo_count + 1))
+    done <<< "$repos"
+
+    ui_bar_line
+    local msg="Found $total issue(s) across $repo_count repo(s)"
+    [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+    ui_outro "$msg"
+    return 0
+}
+
+# --- create --------------------------------------------------------------
+
+_issue_create() {
+    local title=""
+    local repo=""
+    local tag=""
+    local body=""
+    local labels=""
+    local assignee=""
+    local feature=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --repo) repo="$2"; shift 2 ;;
+            --tag) tag="$2"; shift 2 ;;
+            --body) body="$2"; shift 2 ;;
+            --label) labels="$2"; shift 2 ;;
+            --assignee) assignee="$2"; shift 2 ;;
+            --feature) feature="$2"; shift 2 ;;
+            --help|-h) _issue_help; return 0 ;;
+            -*) ui_step_error "Unknown option: $1"; return 1 ;;
+            *)
+                if [[ -z "$title" ]]; then
+                    title="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$title" ]]; then
+        ui_step_error "Usage: revo issue create (--repo NAME | --tag TAG) \"TITLE\""
+        return 1
+    fi
+
+    if [[ -z "$repo" ]] && [[ -z "$tag" ]]; then
+        ui_step_error "Either --repo or --tag is required"
+        return 1
+    fi
+
+    if [[ -n "$repo" ]] && [[ -n "$tag" ]]; then
+        ui_step_error "Use either --repo or --tag, not both"
+        return 1
+    fi
+
+    if ! command -v gh >/dev/null 2>&1; then
+        ui_step_error "gh CLI not found. Install from https://cli.github.com/"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    # Resolve target repo paths
+    local target_paths=()
+    if [[ -n "$repo" ]]; then
+        local idx
+        idx=$(yaml_find_by_name "$repo")
+        if [[ $idx -lt 0 ]]; then
+            ui_step_error "Repo not found in revo.yaml: $repo"
+            return 1
+        fi
+        target_paths+=("$repo")
+    else
+        local repos
+        repos=$(config_get_repos "$tag")
+        local r
+        while IFS= read -r r; do
+            [[ -z "$r" ]] && continue
+            local p
+            p=$(yaml_get_path "$r")
+            target_paths+=("$p")
+        done <<< "$repos"
+    fi
+
+    if [[ ${#target_paths[@]} -eq 0 ]]; then
+        ui_step_error "No matching repos"
+        return 1
+    fi
+
+    ui_intro "Revo - Create issue: $title"
+
+    # Validate feature brief if --feature was given
+    local feature_brief=""
+    if [[ -n "$feature" ]]; then
+        feature_brief="$REVO_WORKSPACE_ROOT/.revo/features/$feature.md"
+        if [[ ! -f "$feature_brief" ]]; then
+            ui_step_error "Feature brief not found: .revo/features/$feature.md"
+            ui_info "$(ui_dim "Run 'revo feature $feature' first to create it")"
+            return 1
+        fi
+    fi
+
+    # Build the initial body that all created issues share
+    local effective_body="$body"
+    if [[ -z "$effective_body" ]]; then
+        effective_body="Created by \`revo issue create\`."
+    fi
+    if [[ -n "$feature" ]]; then
+        effective_body="$effective_body"$'\n\n'"Part of feature: \`$feature\` (see \`.revo/features/$feature.md\`)"
+    fi
+
+    # --- Pass 1: create issues -------------------------------------------
+    local issue_paths=()
+    local issue_urls=()
+    local issue_numbers=()
+    local fail_count=0
+    local skip_count=0
+
+    local p
+    for p in "${target_paths[@]}"; do
+        local full_path="$REVO_REPOS_DIR/$p"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$p"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        local gh_args=( --title "$title" --body "$effective_body" )
+        if [[ -n "$labels" ]]; then
+            gh_args+=( --label "$labels" )
+        fi
+        if [[ -n "$assignee" ]]; then
+            gh_args+=( --assignee "$assignee" )
+        fi
+
+        local output
+        if output=$(cd "$full_path" && gh issue create "${gh_args[@]}" 2>&1); then
+            local url
+            url=$(printf '%s' "$output" | grep -Eo 'https://github\.com/[^ ]+/issues/[0-9]+' | tail -1)
+            if [[ -z "$url" ]]; then
+                url="$output"
+            fi
+            local number="${url##*/}"
+            issue_paths+=("$p")
+            issue_urls+=("$url")
+            issue_numbers+=("$number")
+            ui_step_done "Created:" "$p → $url"
+        else
+            ui_step_error "Failed: $p"
+            ui_info "$(ui_dim "$output")"
+            fail_count=$((fail_count + 1))
+        fi
+    done
+
+    # --- Pass 2: cross-references ----------------------------------------
+    if [[ ${#issue_paths[@]} -gt 1 ]]; then
+        ui_bar_line
+        ui_step "Linking issues with cross-references..."
+
+        local xref
+        xref=$'\n\n---\n**Coordinated issues (revo):**\n'
+        local i
+        for ((i = 0; i < ${#issue_paths[@]}; i++)); do
+            xref+="- ${issue_paths[$i]}: ${issue_urls[$i]}"$'\n'
+        done
+
+        for ((i = 0; i < ${#issue_paths[@]}; i++)); do
+            local repo_path="${issue_paths[$i]}"
+            local issue_number="${issue_numbers[$i]}"
+            local full_path="$REVO_REPOS_DIR/$repo_path"
+            local combined_body="$effective_body$xref"
+
+            if (cd "$full_path" && gh issue edit "$issue_number" --body "$combined_body" >/dev/null 2>&1); then
+                ui_step_done "Linked:" "$repo_path"
+            else
+                ui_step_error "Failed to link: $repo_path"
+            fi
+        done
+    fi
+
+    # --- Pass 3: append to feature brief ---------------------------------
+    if [[ -n "$feature_brief" ]] && [[ ${#issue_paths[@]} -gt 0 ]]; then
+        ui_bar_line
+        ui_step "Appending to feature brief: $feature"
+        {
+            printf '\n## Issues (created by revo)\n\n'
+            local i
+            for ((i = 0; i < ${#issue_paths[@]}; i++)); do
+                printf -- '- **%s**: %s\n' "${issue_paths[$i]}" "${issue_urls[$i]}"
+            done
+        } >> "$feature_brief"
+        ui_step_done "Updated:" ".revo/features/$feature.md"
+    fi
+
+    ui_bar_line
+
+    # Print URLs to stdout (LLM-friendly: one URL per line, parseable)
+    local i
+    for ((i = 0; i < ${#issue_urls[@]}; i++)); do
+        printf '%s\n' "${issue_urls[$i]}"
+    done
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Created ${#issue_paths[@]} issue(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+        return 0
+    else
+        ui_outro_cancel "${#issue_paths[@]} created, $fail_count failed"
+        return 1
+    fi
+}
+
 # === Main ===
 # --- Help ---
 show_help() {
@@ -3603,6 +4120,8 @@ Claude-first commands:
   commit MSG [--tag TAG]      Commit changes across dirty repos
   push [--tag TAG]            Push branches across repositories
   pr TITLE [--tag TAG]        Create coordinated PRs via gh CLI
+  issue list [options]        List issues across workspace repos
+  issue create [options] TITLE Create issue(s) in workspace repos
 
 Options:
   --tag TAG       Filter repositories by tag
@@ -3624,6 +4143,10 @@ Examples:
   revo commit "wire up clock endpoint"
   revo push
   revo pr "Clock endpoint for students" --tag backend
+  revo issue list --state open                       # all open issues
+  revo issue list --tag backend --json               # JSON for Claude/jq
+  revo issue create --repo backend "Add stats endpoint"
+  revo issue create --tag mobile --feature stats "Add statistics screen"
 
 Documentation: https://github.com/jippylong12/revo
 EOF
@@ -3692,6 +4215,9 @@ main() {
         pr)
             cmd_pr "$@"
             ;;
+        issue|issues)
+            cmd_issue "$@"
+            ;;
         --help|-h|help)
             show_help
             ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revotools/cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Claude-first multi-repo workspace manager (fork of Mars)",
   "bin": {
     "revo": "./dist/revo"