Skip to content

Latest commit

 

History

History
82 lines (51 loc) · 3.48 KB

File metadata and controls

82 lines (51 loc) · 3.48 KB

Copia CLI

CI Go Release License: AGPL-3.0 codecov

copia-cli is Copia on the command line. It brings repositories, issues, pull requests, and other Copia concepts to the terminal next to where you are already working with git and your code.

Copia CLI is supported for users on Copia Cloud, with support for Linux, macOS, and Windows.

Documentation

For installation options see below, for usage instructions see the manual.

Contributing

If anything feels off, or if you feel that some functionality is missing, please check out the contributing page. There you will find instructions for sharing your feedback, building the tool locally, and submitting pull requests to the project.

Installation

Build from source

See here on how to build Copia CLI from source.

Quick Start

# Authenticate
$ copia-cli auth login --host app.copia.io --token YOUR_TOKEN

# List your repos
$ copia-cli repo list

# Create an issue
$ copia-cli issue create --title "Fix sensor mapping" --label bug

# Open a PR
$ copia-cli pr create --title "feat: add safety interlock" --base develop

# Merge it
$ copia-cli pr merge 7 --merge --delete-branch

Shell Completion

Shell completion is available for Bash, Zsh, Fish, and PowerShell. See copia-cli completion --help or the manual for setup instructions.

Roadmap

  • Phase 1 (MVP): auth, repo list/view/clone, issue CRUD, pr CRUD, label list/create — Done
  • Phase 2 (Workflow): release CRUD, repo create/delete/fork, pr review/diff/checkout, issue edit, Homebrew tap — Done
  • Phase 3 (Power Features): api escape hatch, search, orgs, notifications, -R/--repo flag, completion, Jekyll manual, AGPL license — Done
  • Phase 4 (Nice to Have): winget, OS keyring, aliases, browse, status dashboard, ssh-key, pr checks, scheduled integration tests

License

AGPL-3.0 — see LICENSE-COMMERCIAL.md for commercial licensing options.