Docs

CLI reference

Every call command: check, local, run as a command, manifest, docs and init.

pip install callables installs the call command. Run it from the repo root. The old shipfn command is an alias.

call check

call check
call check --json

Lists every problem a deploy would hit, with a fix for each. Exit code 1 means the deploy would fail. --json prints the issues as JSON for scripts and agents.

call <function>

call weekly_report --region EMEA --days 30
call backups run --env staging
call backups run --help

Every function is a CLI command, and every group a sub-command. Each input is a flag: days becomes --days, a bool becomes --dry-run/--no-dry-run, and a list takes several values. Add --help to see them. Results print as aligned columns in a terminal and as JSON when piped.

call local

call local weekly_report -i region=EMEA -i days=30
call local clean_contacts -i [email protected]
call local backups.run -i env=staging --json

Runs a function on this machine with the same input validation as the platform. Values are parsed as JSON when possible, and @path passes a file. Output files land in ./callables-output/. --json prints one JSON object on stdout with ok, value, files, error and field_errors, and the function's own prints go to stderr.

call manifest

call manifest

Prints the JSON the platform reads: every function, its options and each input's JSON Schema. Local-only commands are left out.

call docs

Prints the guide to writing functions that ships with the installed SDK.

call init

call init

Sets up a repo: an example function, a requirements.txt if there's none, callables-output/ in .gitignore, and instructions for coding agents. See coding agents. Safe to run again: it only refreshes the files it owns.