ciopen

Quickly open CI pipelines from your Git repository.

ciopen lets you open your CI pipelines or repository pages straight from the terminal — works with GitHub, GitLab, Bitbucket, Azure DevOps (and more coming soon!).

Check out the docs:

• PyPI
• GitHub

⚡ Features

Open CI pipeline in your default browser:

$ ciopen

💻 Installation

Requirements:

• Python >=3.11
• Git installed and available in your PATH

Using pip

$ pip install ciopen

Using pip (editable / dev mode)

$ git clone https://github.com/mel-cdn/ciopen.git
$ cd ciopen
$ pipenv shell                  # or activate your virtualenv
$ ./scripts/run-checks.sh       # Install dependencies and run checks

🛠️ Usage Examples

Show helpful CLI documentation:

$ ciopen --help

Usage: ciopen [OPTIONS] COMMAND [ARGS]...

Quickly open CI pipelines from your Git repository.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.                                              │
│ --show-completion             Show completion for the current shell, to copy it or customize the installation.       │
│ --help                        Show this message and exit.                                                            │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ version   Show ciopen version                                                                                        │
│ info      Show ciopen information                                                                                    │
│ doctor    Check if everything is set up right                                                                        │
│ provider  Show which CI provider is detected                                                                         │
│ repo      Open the main page of this repository                                                                      │
│ pr        Open the pull requests page of this repository                                                             │
│ jira      Open the Jira ticket linked to the current branch                                                          │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Set your Jira base URL once, then open the ticket linked to your current branch:

$ ciopen jira set-base-url https://your-org.atlassian.net
Jira base URL set to https://your-org.atlassian.net

$ ciopen jira show
Jira base URL: https://your-org.atlassian.net

$ ciopen jira unset-base-url
Jira base URL unset.

$ ciopen jira set-base-url https://your-org.atlassian.net
Jira base URL set to https://your-org.atlassian.net

$ git checkout -b feature/JIRA-1234-add-login
$ ciopen jira
Opening https://your-org.atlassian.net/browse/JIRA-1234

ciopen jira looks for an uppercase ticket key (e.g. JIRA-1234) anywhere in the current branch name — JIRA-1234-branch-name, JIRA-1234_branch_name, feature/JIRA-1234 all work.

Open your repository's main page:

$ ciopen repo

Opening https://github.com/mel-cdn/ciopen

Run diagnostics to check everything is set up right:

$ ciopen doctor

ciopen 0.1.2
Running diagnostics...

✅ Git installed
✅ Inside a Git repository
✅ Remote origin found
✅ CI Provider detected

Environment details:

Provider                : GitHub
Repository slug         : mel-cdn/ciopen
Current branch          : main
Repository URL          : https://github.com/mel-cdn/ciopen
Pipeline URL            : https://github.com/mel-cdn/ciopen/actions
Pull Request URL        : https://github.com/mel-cdn/ciopen/pulls

💡 Notes

• Works with HTTPS and SSH Git remotes.
• Detects CI provider automatically.
• Can be extended with more CI providers easily.
• Designed for casual, fast CLI usage.

🔮 Future Plans

• Add support for custom CI/CD providers, e.g., CircleCI, Jenkins, AWS CodeBuild, etc.
• JSON output for scripts and automation
• Auto-detect Git branch and multiple pipelines
• Additional CLI shortcuts for common CI/CD tasks

🤝 Contributing

ciopen is open for contributions!

All contributions are welcome — whether it’s new features, bug fixes, or improving docs.

1. Clone the repository: git clone https://github.com/mel-cdn/ciopen.git
2. Create a new branch: git checkout -b my-new-feature
3. Install dependencies: ./scripts/run-checks.sh
4. Make your changes
5. Run it locally — the editable install from step 3 puts ciopen on your PATH:

   $ ciopen <command>
   

6. Submit a pull request

Made with ❤️ for developers who love fast, terminal-first CI access.