Skip to content

mel-cdn/ciopen

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

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors