With OpenShift Client CLI (oc), you can create applications and manage OpenShift resources. It is built on top of kubectl which means it provides its full capabilities to connect with any kubernetes compliant cluster, and on top adds commands simplifying interaction with an OpenShift cluster.

• CONTRIBUTING.md — code conventions, testing, PR process, CI, review expectations (shared across OpenShift Control Plane repos)
• ARCHITECTURE.md — design decisions, component relationships, the kubectl wrapper taxonomy
• AGENTS.md — instructions for AI coding agents

To build oc invoke make oc. At any time you can invoke make help and you'll get a list of all supported make sub-commands.

By default make oc builds the executable without debugging symbols. To include debugging symbols, run make STRIP_DEBUGGING_SYMBOLS=false oc.

In order to build oc, you will need the GSSAPI sources. On a Fedora/CentOS/RHEL workstation, install them with:

dnf install krb5-devel gpgme-devel libassuan-devel

For macOS, install build dependencies with:

brew install heimdal gpgme

All PRs must pass automated checks — go fmt, go vet, unit tests, and e2e tests against a real cluster.

Locally you can run verification and unit tests with:

make verify
make test

Dependencies are managed through Go Modules. When updating any dependency:

1. go mod tidy
2. go mod vendor

If you've found a security issue that you'd like to disclose confidentially, please contact Red Hat's Product Security team. Details at https://access.redhat.com/security/team/contact

Do not file security issues as public GitHub issues.

oc is licensed under the Apache License, Version 2.0.