Skip to content

noteraorg/cli

Repository files navigation

Notera CLI

Command-line interface for the Notera Workflow API. Deploy and manage workflows that automate tasks like data transfers, alerts, and business processes.

Installation

Homebrew (macOS / Linux)

brew install noteraorg/tap/notera

Scoop (Windows)

scoop bucket add notera https://github.com/noteraorg/scoop-bucket
scoop install notera

Debian / Ubuntu

Download the .deb package from the latest release:

sudo dpkg -i notera_*_linux_amd64.deb

Fedora / RHEL

Download the .rpm package from the latest release:

sudo rpm -i notera_*_linux_amd64.rpm

Nix

nix profile install github:noteraorg/cli

Or add to your flake inputs:

inputs.notera.url = "github:noteraorg/cli";

Binary download

Pre-built binaries for Linux, macOS, and Windows (amd64/arm64) are available on the releases page.

Build from source

go install github.com/noteraorg/cli/cmd/notera@latest

Quick start

Authenticate

notera login

This opens your browser for authentication. On a remote server, use:

notera login --no-browser

You'll get a URL to open in your local browser, then paste the callback URL back.

For non-interactive environments, pass a token directly:

notera login --token <access-token>

Create a workflow

notera workflows create --name "Daily sync" --description "Sync data from ERP to warehouse"

Build and deploy

Create a directory with a Dockerfile, then:

notera builds create <workflow-id> --path ./my-workflow

Trigger a run

notera runs trigger <workflow-id>

Schedule recurring runs

notera schedules create <workflow-id> --cron "0 9 * * 1-5" --timezone "Europe/Oslo"

View logs

notera runs logs <run-id>
notera builds logs <build-id>

Commands

Command Description
notera login Authenticate with the Notera API
notera logout Clear stored token
notera workflows list List all workflows
notera workflows get <id> Get workflow details
notera workflows create Create a new workflow
notera workflows update <id> Update a workflow
notera workflows delete <id> Delete a workflow
notera runs trigger <workflow-id> Trigger a workflow run
notera runs list <workflow-id> List runs for a workflow
notera runs get <id> Get run details
notera runs cancel <id> Cancel a running run
notera runs logs <id> Stream run logs
notera schedules create <workflow-id> Create a cron schedule
notera schedules list <workflow-id> List schedules
notera schedules update <id> Update a schedule
notera schedules delete <id> Delete a schedule
notera builds create <workflow-id> Build from a Dockerfile directory
notera builds get <id> Get build details
notera builds list <workflow-id> List builds
notera builds logs <id> Stream build logs

Output formats

Table output (default):

notera workflows list

JSON output:

notera --output json workflows list

Configuration

The CLI uses these defaults, overridable via environment variables or a config file at ~/.config/notera/config.json:

Setting Env var Default
API URL NOTERA_API_URL https://workflow.notera.no
Issuer URL NOTERA_ISSUER_URL https://id.notera.no
Client ID NOTERA_CLIENT_ID notera-cli
Client Secret NOTERA_CLIENT_SECRET (empty)

The --api-url flag overrides the API URL per command.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors