Skip to content

Pi ​

Pi is one of Z.E.N.'s three built-in providers, alongside Claude and Codex. You can use Pi to run any node, set it as your workflow default, or mix it into a workflow that uses different providers per step.

Use Pi for a single node ​

yaml
nodes:
  - id: summarize
    type: prompt
    provider: pi
    model: pi-default
    prompt: |
      Summarize the morning Slack into a five-bullet brief.

The provider: pi field tells Z.E.N. which provider to call for this node. Everything else (variables, dependencies, output capture) works the same as any other prompt node.

Use Pi as your default ​

In ~/.zen/config.yaml:

yaml
assistants:
  default: pi
  pi:
    model: pi-default

Every node that doesn't override provider: will use Pi. Override on the nodes where you specifically want Claude or Codex.

Configuration ​

Pi reads its credentials from the standard provider config block. The shared shape (model selection, additional directories, setting sources) is in Configuration. Same fields apply.

What you can do with Pi ​

Anything you'd do with Claude or Codex. Run a single node with Pi as the provider, set it as your default, or mix it across a workflow when one step is better suited to Pi than the others. The provider sits behind the same node interface as the rest.

AI that follows a recipe, not a conversation.