ciopen 0.1.0

Open CI pipelines from your current Git repository

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 on your default browser:

$ ciopen

---

💻 Installation

Requirements:

• Python >=3.10
• Git installed and available in your PATH
• Access to the Git remote of the repository you want to open

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
$ ./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.0.5
 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.