Repository navigation
v0.1.0
oras .NET CLI v0.1.0
The first release of the oras .NET CLI — a cross-platform .NET 10 reimagining of the Go oras CLI for managing OCI artifacts in container registries.
⚠️ Early release — some commands have stubbed implementations. See Known Limitations for details.
Highlights
- ��️ Interactive TUI — run
oraswith no arguments to launch a rich terminal dashboard powered by Spectre.Console, featuring registry browsing, manifest inspection, and live progress - 📦 20 CLI commands — full command parity with the Go CLI (push, pull, attach, discover, copy, login/logout, manifest/blob/repo/tag operations, resolve)
- 🔐 Docker-compatible credentials — seamlessly uses
~/.docker/config.jsonand Docker credential helpers; existing Docker/Go CLI credentials work automatically - 🌍 Cross-platform binaries — self-contained single-file executables for 6 platforms (no .NET runtime required)
- 📊 Rich terminal output — colored tables, tree views, real-time progress bars with transfer speed and ETA
Fully Implemented Commands
| Command | Description |
|---|---|
oras login |
Authenticate with a container registry |
oras logout |
Remove registry credentials |
oras version |
Show CLI version, library version, .NET runtime, and platform |
Download
| Platform | File |
|---|---|
| Windows x64 | oras-win-x64.zip |
| Windows ARM64 | oras-win-arm64.zip |
| Linux x64 | oras-linux-x64.tar.gz |
| Linux ARM64 | oras-linux-arm64.tar.gz |
| macOS x64 (Intel) | oras-osx-x64.tar.gz |
| macOS ARM64 (Apple Silicon) | oras-osx-arm64.tar.gz |
Quick Start
`�ash
Linux/macOS
curl -LO https://github.com/shizhMSFT/oras-dotnet-cli/releases/download/v0.1.0/oras-linux-x64.tar.gz
tar -xzf oras-linux-x64.tar.gz && chmod +x oras-linux-x64
sudo mv oras-linux-x64 /usr/local/bin/oras
oras version
`
Built With
- .NET 10 — self-contained, high-performance runtime
- System.CommandLine 2.0.3 — modern CLI parsing
- Spectre.Console 0.50.0 — beautiful terminal rendering
- OrasProject.Oras 0.5.0 — official ORAS .NET library
Links
- 📖 Documentation
- 🔄 Migration Guide — switching from the Go CLI
- 🖥️ TUI Showcase — visual tour of the interactive UI