← ClaudeAtlas

boardwalk-overviewlisted

Orientation for an agent that is new to Boardwalk: what the platform is and how it fits together, before driving the CLI or writing a workflow. Boardwalk runs agent workflows, which are TypeScript or Python programs (not YAML, a GUI, or a chatbot) that call models on a schedule, webhook, or on demand. Use when a user mentions Boardwalk and the agent lacks the mental model. Points to boardwalk-use-cli (scaffold, run, ship) and write-good-loops (iterating loops).
boardwalk-labs/plugins · ★ 1 · AI & Automation · score 67
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