moiraweave-cli 0.3.1

MoiraWeave developer CLI

MoiraWeave CLI

Developer CLI for creating, running, and operating MoiraWeave workspaces.

Why this repository exists

moiraweave-cli is the entry point for platform users. It provides a single command surface for:

• workspace initialization
• step scaffolding and catalog integration
• pipeline creation and validation
• local runtime orchestration
• deployment commands and job inspection

Install and Update (uv-style)

Install from PyPI

uv tool install moiraweave-cli
moira --version
moira --help

Upgrade to latest

uv tool upgrade moiraweave-cli

Pin to a specific version

uv tool install moiraweave-cli==0.1.1

Reinstall cleanly

uv tool uninstall moiraweave-cli
uv tool install moiraweave-cli

Install from GitHub (main branch)

uv tool install "git+https://github.com/moiraweave-labs/moiraweave-cli"

Install from local source (for contributors)

uv tool install --editable .

Verify resolution and tool path

uv tool list
which moira

Fallback (if you do not use uv)

pipx install moiraweave-cli
pipx upgrade moiraweave-cli

Quickstart

# 1) Initialize a workspace
moira project init
cd my-project-moira

# 2) Create a custom step
moira step new my-task my-impl

# 3) Create and validate a pipeline
moira pipeline new my-pipeline
moira pipeline validate my-pipeline

# 4) Run locally
moira pipeline dev my-pipeline

Workspace ownership model

Your product code lives in your own workspace repository, not in upstream MoiraWeave repos:

your-company-moira/
  moiraweave.yaml
  .env
  src/                 # your product code
  notebooks/           # optional user assets
  .moiraweave/
    pipelines/
    steps/
    tasks/
    deploy/

MoiraWeave keeps generated runtime scaffolding under .moiraweave/ to avoid mixing platform artifacts with user application code, following the same hidden-workspace pattern used by modern developer tooling.

Development

uv sync --frozen
uv run ruff check moira_cli tests
uv run mypy moira_cli
uv run pytest

Releases

• release.yml manages automated versioning/changelog updates via Release Please.
• publish.yml publishes release artifacts to PyPI.

Related repositories

• moiraweave-core: runtime services and infrastructure
• moiraweave-steps: official step catalog
• moiraweave-docs: documentation site
• .github: org-wide policies and templates