v1.4.0 - ZenHub URLs & Multi-Repo Support

What's New

New Commands

• zh close <issue> [comment] - Close an issue (moves to Closed pipeline in ZenHub)
• zh reopen <issue> - Reopen a closed issue

ZenHub URLs

• Issue details, zh mine, and zh pipeline now show clickable ZenHub URLs by default
• URLs link directly to the issue in the ZenHub board
• Use --no-urls flag for compact output without URLs

Multi-Repository Workspace Support

• Now shows the repository name for each issue in zh mine and zh pipeline
• Correctly handles workspaces with multiple repositories
• Each issue links to its correct repo's ZenHub URL

Bug Fixes

• Fixed zh assign and zh unassign (ZenHub API payload changed)
• Skip assignment if user is already assigned to the issue
• Added brief delay before re-fetch to ensure updated data is returned

Example Output

$ zh mine daniel-pittman

Issues assigned to daniel-pittman (5):

  #98 │ msu-denver/sustainability-hub-research │ Product Backlog
    Video Post - Silly Dan Interview
    → https://app.zenhub.com/workspaces/sustainability-hub-xxx/issues/gh/msu-denver/sustainability-hub-research/98

Full Changelog

v1.3.0...v1.4.0

v1.3.0

What's New

New Features

• zh users - List all users who can be assigned to issues in the workspace
• zh mine [username] - Now accepts an optional username to see issues assigned to a specific user

Examples

# List all assignable users
zh users

# See issues assigned to yourself
zh mine

# See issues assigned to a specific user
zh mine daniel-pittman

Full Changelog

v1.2.0...v1.3.0

v1.2.0 - Comments & Attachments

What's New

Comment Command

Add comments to issues directly from the terminal:

# Inline comment
zh comment 42 "Fixed in PR #99"

# From file (great for detailed updates)
zh comment 42 -f ./investigation-notes.md

# From stdin (useful for automation)
echo "Build passed" | zh comment 42 --stdin

Attach Command

Opens the issue in your browser for drag-and-drop file uploads:

zh attach 42

Note: GitHub's API doesn't support programmatic file uploads to issues. This command provides a convenient shortcut to the web interface.

Bug Fix: zh mine

Fixed the assignee filter so zh mine now correctly returns issues assigned to you.

Improvement: Single Version Source

Version is now read from the VERSION file instead of being hardcoded in the script.

Full Changelog

v1.1.0...v1.2.0

v1.1.0 - Unassign Command

What's New

New Command: unassign

Remove assignees from issues when someone rolls off a ticket:

# Remove specific user
zh unassign 42 johndoe

# Remove all assignees
zh unassign 42

Improved Error Messages

Better guidance when running commands outside a git repository:

Error: Not in a git repository with a GitHub remote.

This command must be run from within a git repository that:
  1. Has a GitHub remote configured (origin)
  2. Is connected to a ZenHub workspace

To fix:
  - cd into your project directory
  - Ensure 'git remote -v' shows a GitHub URL

Full Changelog

v1.0.0...v1.1.0

v1.0.0 - Initial Release

ZenHub CLI v1.0.0

A powerful command-line interface for ZenHub. Manage issues, pipelines, sprints, and more directly from your terminal.

Features

• View & manage issues - See details, move between pipelines, set estimates
• Sprint planning - Board overview, pipeline management, bulk operations
• Prioritization - Reorder issues, set priorities, manage dependencies
• Create issues - Full support for types, labels, assignees, and descriptions
• AI-friendly - Designed for use with AI assistants like Claude

Installation

# Clone the repository
git clone https://github.com/daniel-pittman/zenhub-cli.git ~/.zenhub-cli

# Add to PATH
echo 'export PATH="$HOME/.zenhub-cli:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Or symlink
sudo ln -sf ~/.zenhub-cli/zh /usr/local/bin/zh

Requirements

• bash (v4.0+)
• curl
• jq (brew install jq)
• git
• gh (GitHub CLI - brew install gh)

Quick Start

# Configure tokens
mkdir -p ~/.config/zh
echo "ZH_TOKEN=your_token" > ~/.config/zh/config

# View your board
zh board

# See your issues
zh mine

# Move an issue
zh move 42 "In Progress"

See the README for full documentation.