pigo

pigo

A faithful, slim, pure-Go port of Mario Zechner's MIT-licensed pi coding agent, built by Ordalie as an SDK-first Go module and a single static CLI binary. Byte-compatible with upstream pi's session format, wire protocols, config files, and extension examples at the pinned upstream version in UPSTREAM.lock; every divergence is recorded in docs/DECISIONS.md. The pigo binary deliberately coexists with upstream's pi; this module is unrelated to the older github.com/dimetron/pi-go project.

Install

curl -fsSL https://raw.githubusercontent.com/OrdalieTech/pigo/main/scripts/install.sh | sh

This installs pigo to ~/.local/bin after verifying the release checksum. Override the directory with PIGO_INSTALL_DIR; alternatively, with Go ≥ 1.26.5:

go install github.com/OrdalieTech/pigo/cmd/pigo@latest

Update

Run pigo update. It never replaces its running binary; it prints the exact installer or Go command for your installation, while pigo update --extensions updates installed pi packages.

First session

export OPENAI_API_KEY=sk-...          # or ANTHROPIC_API_KEY, or run `pigo login`
pigo                                  # interactive TUI
pigo -p "explain this repository"    # headless print mode

Sessions are plain JSONL, interchangeable with upstream pi: a session written by pigo opens in TS pi and vice versa. pigo --mode rpc speaks upstream's RPC protocol; upstream's own RPC test suite runs unmodified against it.

Embed the SDK

import "github.com/OrdalieTech/pigo/codingagent"

result, err := codingagent.NewAgentSession(codingagent.AgentSessionOptions{})
if err != nil { log.Fatal(err) }
defer result.Session.Dispose()
result.Session.Prompt(context.Background(), "list the files here")

Thirteen runnable examples live in codingagent/examples, from a minimal session to custom tools, providers, and session runtimes — 01_minimal runs offline against the bundled faux provider.

Run an upstream extension

pigo executes many upstream TypeScript extensions unmodified in an embedded JS runtime. Fetch the pirate example from the pinned upstream revision and load it:

curl -fsSLO https://raw.githubusercontent.com/earendil-works/pi/20be4b18d4c57487f8993d2762bace129f0cf7c6/packages/coding-agent/examples/extensions/pirate.ts
pigo --extension ./pirate.ts

Run /pirate in the TUI to exercise the extension.

61 of upstream's 69 single-file examples run as-is. In a locked snapshot of the 44 most-downloaded valid Pi packages, 24 load stably in both runtimes and 20 expose exactly the same observed tools and commands; six of seven safe command handlers and Piolium's real knowledge-base workflow also match. See the ecosystem matrix, the example matrix, and the bridge guide for the exact package-by-package result and remaining runtime ceilings. .pi/extensions/ in a trusted project and the global agent directory are discovered like upstream.

Provenance

Upstream pi is © Mario Zechner, MIT — this port tracks the exact commit in UPSTREAM.lock and regenerates its conformance goldens from upstream source (make fixtures-check). pigo is MIT too; see LICENSE, CONTRIBUTING.md, and SECURITY.md.

Every GitHub release includes a checksummed pigo_<version>_source.tar.gz. To verify that source independently, download it with checksums.txt, run sha256sum -c checksums.txt, extract it, and run CGO_ENABLED=0 go build -buildvcs=false ./cmd/pigo; release CI performs the same rebuild before publishing. The flag is required because a source archive intentionally contains no .git metadata.