Shimpz CLI

shimpz checks and tests file-backed Assistant Powers locally without Docker. It installs a pinned uv in its private cache, manages Python 3.14, and runs the public shimpz Python SDK from the Assistant's pyproject.toml.

Install

Install with Cargo:

cargo install shimpz-cli --locked

Prebuilt binaries for Linux, macOS, and Windows are available in GitHub Releases. Both installation paths provide the shimpz command.

Use

shimpz auth
shimpz new assistant hello-assistant
shimpz check
shimpz test create-dns --input '{"zone":"example.com"}'
shimpz upgrade

shimpz auth opens the default browser for OAuth authorization and also prints the URL and user code in the terminal. shimpz auth status validates the exact Accounts session online, while shimpz auth logout revokes the complete rotating token family. Local credentials are stored in the current OS user configuration directory with owner-only permissions.

shimpz new assistant <name> creates a minimal Python Assistant with one Hello World Power. Python is the default language; it can also be selected explicitly with --language python.

shimpz upgrade checks the latest stable GitHub release and replaces the current executable only when a newer version is available.

Account tokens are read from environment variables and never accepted as CLI arguments. For example, account cloudflare uses SHIMPZ_ACCOUNT_CLOUDFLARE.

The crates.io package is named shimpz-cli; the installed command is shimpz.

License

Apache-2.0.