boardwalk-overviewlisted
Install: claude install-skill boardwalk-labs/plugins
# What Boardwalk is
Boardwalk runs **agent workflows**: TypeScript or Python programs that call models, run on
schedules or webhooks, and keep a permanent record of every run. A workflow is plain code, so you
author it in your own editor, with your own packages and tests, and ship it with one deploy.
It is **the control plane for agent workflows**: the place an org builds, versions, triggers, and
runs them, with durability, secrets, budgets, and full run history handled for you. It is code-first,
not a no-code builder and not a chatbot. You write the program; Boardwalk runs it unattended and
keeps the trace.
## A workflow is a typed function
**A Boardwalk workflow is a `run` function plus a small descriptor.** No YAML, no node editor, no
framework to subclass. Two files: the function does the work, and `workflow.jsonc` tells the
platform how to deploy it.
`src/index.ts`:
```ts
import { agent, secrets } from "@boardwalk-labs/workflow";
export default async function run(): Promise<string> {
const token = await secrets.get("GITHUB_TOKEN");
const issues = await fetch("https://api.github.com/issues", {
headers: { Authorization: `Bearer ${token}` },
}).then((r) => r.text());
return await agent(`Summarize these open issues for a morning digest:\n${issues}`);
}
```
`workflow.jsonc`:
```jsonc
{
"$schema": "https://boardwalk.sh/schemas/workflow.json",
"slug": "morning-digest",
"triggers": [{ "kind": "cron", "expr": "0 9 * * 1-5" }], // when it runs
"pe