Skip to content
Kindgi

Guides

Short, task-focused pages. Each assumes the basics from Start, shows TypeScript and Python side by side, and was run as written against the version of Kindgi these docs describe.

  • Tools: write a tool in TypeScript or Python, call an HTTP API without code, give a tool a secret, mark it read-only, and use an MCP server's tools.
  • Agents: write an agent, give it input, get a typed answer, choose its model, hold a conversation and cap what a turn may spend.
  • Models: connect Anthropic, Gemini on Vertex AI, an OpenAI-compatible endpoint, or a model you serve yourself.
  • Flows: pass data between steps, branch, loop, run steps in parallel, retry, wait for a person, and dry-run a flow.
  • Runs: start runs from the CLI or your app, retry safely, follow them live (from the browser too), read their journal, cancel and list them.
  • Webhooks: get a signed run.finished request when a run ends, verify it in your app, and test and replay deliveries.
  • Guardrails: check an agent's answers, give a check its settings, and choose whether a failure stops the turn.
  • Approvals: have a person approve what an agent does before it happens.
  • Secrets and env: where a pack's settings and secrets live on your machine and in a deployment, and how your code gets them.
  • Cost and provenance: trace an answer to the model and tool calls behind it, and what each call cost.