PostGrip Agent — Go SDK
Run shell commands, container workloads, and durable workflows on the PostGrip Agent runtime service from your Go code.
Current release: v0.11.0
Quick start → GitHub pkg.go.dev
What this is
A Go library that lets you talk to the PostGrip Agent runtime service. You enqueue tasks (shell commands, containers, workflows, schedules), or you run a worker that picks up tasks and executes your registered workflow / activity functions.
The SDK ships as five focused sub-packages under go.postgrip.io/sdk. You only import what you need — most apps that just enqueue tasks need only client; only worker processes need worker + workflow + activity.
| Package | What’s in it |
|---|---|
client |
Connection, Client, the Task / Workflow / Schedule sub-clients. |
worker |
The polling agent that leases tasks and dispatches your registered functions. |
workflow |
The Context interface workflows receive, plus options and signal channels. |
activity |
The Func shape for activities and helpers (GetInfo, Heartbeat, Milestone, Stdout, Stderr). |
failure |
Structured failure types (Application, Cancelled, Timeout, TaskFailed). |
Polyglot
This SDK is one of three. The TypeScript and Python siblings implement the same model against the same wire protocol, so a workflow started by a Python client can be picked up by a Go worker and vice versa.
- agent-sdk-typescript
- agent-sdk-python
- agent-sdk-protocol — the shared wire shapes
Where to next
- Installation —
go getand module-path notes. - Quick start — copy-paste examples for enqueueing tasks and running a worker.
- Packages — what each sub-package owns and how they fit together.
- Workflow runtime — the durable replay model in depth: suspension, determinism, ContinueAsNew.
- API reference — pointer to the auto-generated godoc on pkg.go.dev.