Home

agent-playbooks

agent-playbooks shows how to use NoETL as a local AI agent framework: Claude agents written as YAML playbooks, run by the noetl CLI on your own machine, started by a systemd timer instead of a resident daemon.

Last refreshed: 2026-10-16

Status

Piece	State
Single-pass template rendering (closes the re-expansion gap)	released in noetl CLI 5.3.1 (noetl/cli#98)
Single render for local shell / http steps	released in noetl CLI 5.3.2 (noetl/cli#100)
kind: agent tool, both frameworks	released in noetl-tools 4.1.0 (noetl/tools#112)
CLI local-runtime support	released in noetl CLI 5.1.0 (noetl/cli#95), with noetl-executor 0.11.0
Credential store, http credential aliases, Google OAuth	released in noetl CLI 5.2.0 (noetl/cli#96); needed by Connect Gmail
Agent cost controls (thinking, effort, prompt caching, max_tokens errors)	released in noetl CLI 5.3.0 (noetl/cli#97) on noetl-tools 4.2.0 (noetl/tools#113)
Playbooks in this repo	verified live on 2026-10-16: framework: claude on an API key and framework: claude-code on a Claude subscription

Install noetl 5.1.0 or newer: see Tutorial step 1.

Pages

Page	Read it when you want to
Tutorial	run the inbox triage, write your own agent playbook, schedule it
Connect Gmail	triage your real Gmail accounts (OAuth setup, one credential per account)
Architecture	understand how a kind: agent step executes, end to end
Configuration Reference	look up every kind: agent field and the step result shape
Security	know what the agent can and cannot touch, and why
Troubleshooting	decode an error message

The two frameworks in one table

	framework: claude	framework: claude-code
Runs	Anthropic Messages API, called from Rust	the official claude CLI, headless
Billing	API credits	the CLI's signed-in account (Pro/Max included)
Who runs tools	NoETL: each tool is a playbook	Claude Code: only allowed_tools / mcp_config
Credential in playbook	auth: {type: api_key, credential: anthropic}	none

Related

• noetl/tools wiki: the tool registry kind: agent is part of
• noetl/cli wiki: the noetl run --runtime local runner