Unified command-line client for the Nubster developer platform, starting with repository management.
nub is the official CLI for the Nubster platform. It provides authentication,
repository operations, and a git credential helper, all through a single binary
with both human-readable and machine-readable (--json) output.
nub is sponsored by Nubster.
Alpha. The command set and output format are not yet stable. Breaking changes may occur on minor version bumps until v1.0.
# Authenticate with your personal access token
echo "<your-token>" | nub auth login --with-token
# Create a repository
nub repo create --name my-project
# List repositories
nub repo list
# Clone a repository
nub repo clone my-project
# Register nub as a git credential helper
nub auth setup-gitGlobal flags available on every command:
| Flag | Effect |
|---|---|
--host <HOST> |
Override the platform host for this invocation |
--json |
Emit machine-readable JSON instead of human output |
--no-color |
Disable ANSI color output |
Managing repositories, authentication, and git integration through three separate
tools is friction. nub collapses the common workflows for the Nubster platform
into a single binary: log in once, clone, create, and list repositories, and let
the built-in git credential helper handle token refresh transparently.
- A general-purpose git wrapper.
nubcallsgitunder the hood for clone operations but does not replicate git commands. - A server-side tool.
nubis a client that talks to the Nubster control-plane REST API. - Stable for scripting yet. Until v1.0, the output format and command structure may change on minor releases.
Run nub --help (or nub <command> --help) for the full command reference.
Structured guides (tutorials, how-to, reference, explanation) will be published
as the command set stabilizes toward v1.0.
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
All contributors must sign the Nubster CLA. The CLA Assistant bot will prompt you automatically on your first PR.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT License (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in nub by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.