Skip to content

Repository files navigation

ciopen

Python PyPI Build

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:


⚡ Features

Open CI pipeline on 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 all dependencies

🛠️ 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                                                      │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Open your repository's main page:

$ ciopen repo

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

Check if it's going to work with diagnostics:

$ ciopen doctor

ciopen 0.1.0
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: ./run-checks.sh
  4. Make your changes
  5. Submit a pull request

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

About

Quickly open CI pipelines from your Git repository.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages