cli

module
v0.1.0-alpha.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 13, 2026 License: Apache-2.0

README

Braidplane CLI

The Apache-2.0 command-line client for Braidplane. It manages API resources and validates pipeline specifications locally. Braidplane is pre-v1; server features and API compatibility depend on the server version you target.

Install

Download the archive for your operating system and architecture from Releases. Extract it and put the braidplane executable on your PATH.

To build from source, clone this repository and use the Go toolchain pinned in go.mod:

go build -trimpath -o braidplane ./cmd/braidplane
./braidplane --help

Usage

Live API commands require a Braidplane account and API endpoint. Local pipeline validation does not require a server or credentials.

braidplane login --help
braidplane pipeline validate --local --file examples/multi-source-roots.example.yaml

Use the command help for authentication options. Saved authentication uses the operating system credential store; do not put credentials into pipeline files.

Releases

Release archives include the binary, license, dependency notices, this README and canonical source receipt. Compare an archive with checksums.txt and verify its GitHub provenance:

gh attestation verify <archive> --repo Braidplane/cli

Contributions

Public pull requests are not accepted for direct merge. Please open an issue for bug reports and suggestions, excluding credentials and private operational data.

License

This module is licensed under Apache-2.0; see LICENSE. Dependencies retain their own licenses. This license covers the CLI, not other Braidplane products, and does not grant trademark rights.

Directories

Path Synopsis
cmd
braidplane command
internal
apiclient
Package apiclient provides primitives to interact with the openapi HTTP API.
Package apiclient provides primitives to interact with the openapi HTTP API.
pkg
pipeline/graph
Package graph owns normalized pipeline DAG semantics.
Package graph owns normalized pipeline DAG semantics.
pipeline/spec
Package spec owns the canonical pipeline specification shape and YAML/JSON file decoding.
Package spec owns the canonical pipeline specification shape and YAML/JSON file decoding.
xerror
Package xerror provides a unified error type for the application.
Package xerror provides a unified error type for the application.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL