portaki-cli 1.0.0

Portaki module CLI (portaki) — init, build, lint, test, and OCI publish
portaki-cli-1.0.0 is not a library.

Authors write modules against portaki-sdk. At build time this binary compiles to wasm32, merges proc-macro emissions from OUT_DIR/portaki-emissions/, and packages OCI layers for registries such as GHCR.

Install

cargo install portaki-cli
# or tip of main:
cargo install --git https://github.com/PortakiApp/portaki-sdk --locked portaki-cli

Requires the Wasm target:

rustup target add wasm32-unknown-unknown

Commands

Command Contract
portaki init Scaffold a module from a template
portaki build Compile Wasm + merge emissions → manifest.json
portaki lint Validate capabilities, connectors, i18n keys
portaki test Forward to cargo test in the module crate
portaki publish Push OCI artifact to a container registry
portaki catalog Dump the SDUI primitive catalog
portaki inspect Inspect a published OCI artifact
portaki docs / dev Docs helper / local mock gateway (evolves with the SDK)

Typical workflow

cd modules/weather
portaki build --release
portaki lint
PORTAKI_PUBLISH_VERSION=0.3.5 portaki publish --registry ghcr.io/portakiapp

Image name: ghcr.io/portakiapp/portaki-modules-<module-id>:<semver>.

Official modules: portaki-modules.

Related crates

Crate Role
portaki-sdk Host APIs + SDUI
portaki-sdk-macros Manifest emissions
portaki-connectors Typed connector ops
portaki-test-utils Mock host for tests

License

Apache-2.0 · Copyright 2026 Syntax Labs