Introduction

Ship is a macOS native client to GitHub Issues. It provides a unified view of issues across all of your GitHub organizations and repos. The purpose of Ship is to maximize your productivity with GitHub Issues by offering unprecedented speed and convenience without sacrificing any functionality or usability.

In general, anything that can be accomplished with Issues on github.com can also be accomplished using Ship and vice-versa. If you are not already familiar with the concepts and capabilities of GitHub Issues, the GitHub Mastering Issues Guide is a good place to start.

Table of Contents

• Getting started with Ship
  • Installation
  • Signing In
  • GitHub Organization Access
  • Selecting Repositories
  • Multiple Accounts
• Finding and Viewing Issues
  • The Sidebar
  • The Filter Bar
  • Hiding Issues from Ship
  • Smart Queries
  • Charting Issues
  • Using GitHub Projects
• Composing and Editing Issues
  • Composing Issues
  • Editing Issue Attributes
  • Issue Comments and Markdown Editing
  • File Attachments
  • Bulk Editing Issues
• Pull Requests
  • Filing a New Pull Request
  • Reviewing a Pull Request
  • Merging a Pull Request
• Tips and Tricks
  • Quickly search for an issue by title
  • Create a quick link to an issue for use in commit messages
  • Quickly open an issue from a commit message
  • Open an issue in Ship from a GitHub URL
  • Get a link to github.com
  • Quickly create new issues with templates
  • Easily create a new milestone in multiple repos
  • View multiple overview windows at once
• Migrating from Ship 1.0
  • Prerequisites
  • Configuring Migration Step by Step
• Uninstalling Ship
• Ship 2.0 Privacy and Data Security
  • System Overview
  • Third Party Services Used