pig

package module
v0.5.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2026 License: MIT Imports: 4 Imported by: 0

README

PiG

CI CodeQL OpenSSF Scorecard OpenSSF Best Practices REUSE status Go Reference Minimum Go version Latest release Pi port progress Follow PiG on X Join r/PiGCodingAgent

PiG is Pi, the minimal and extensible coding agent for the terminal, rebuilt in Go as one native binary. It starts quickly, needs no Node.js, and runs Pi's TypeScript extensions unchanged. You can also write extensions in Go, Rust, or Python, and bundle extensions, skills, and prompts into a Piglet: one named agent you can share or build into its own executable.

PiG is a pre-stable 0.x release. Core paths are ported and checked against Pi 1.4.0+74f46864 with paired parity scenarios; edge cases are still hardening. See the port status and file map for current scope and evidence.

If PiG behaves differently from Pi, that is either a bug or a documented divergence. Windows support is a preview.

Install

On macOS, Linux, or Android with Termux (arm64):

curl -fsSL https://pi-in-go.dev/install.sh | sh

On Windows, in PowerShell:

irm https://pi-in-go.dev/install.ps1 | iex

With npm, on any supported platform:

npm install -g @pi-in-go/pig

With Go:

go install github.com/MichaelKinsy/PiG/cmd/pig@latest

You can also download an archive from GitHub Releases or build from source. pi-in-go.dev/install covers every method, including updates and uninstalling.

Quick start

Start PiG in the directory where you want it to work, run /login to connect a subscription or set your provider's API key (for example OPENAI_API_KEY), then ask it something:

cd /path/to/project
pig

Interactive /login masks secret input by default. Turn off Mask secret input in /settings to restore Pi's plain-text typing and submitted input (D80). See login privacy.

The documentation covers everything else, starting with the quickstart. You can also ask PiG to explain itself.

Upstream Pi

Pi is the reference implementation. PiG follows Pi's behavior and design unless a Go constraint or an approved product-neutral requirement makes a difference necessary.

Use the upstream project for Pi itself:

PiG is not an official Pi release. The Pi maintainers do not endorse PiG.

Origins

Michael Kinsy created PiG working at Hewlett Packard Enterprise.

PiG is maintained as an independent open-source project. Project decisions, issues, and contributions belong in this repository. See docs/project/GOVERNANCE.md and docs/project/MAINTAINERS.md.

Compatibility philosophy

PiG adds a Go implementation to the Pi ecosystem and follows the Pi reference implementation.

  • Preserve observable compatibility with Pi.
  • Treat the pinned Pi release as the reference behavior.
  • Minimize unnecessary divergence.
  • Record each intentional user-visible or interoperability difference.
  • Prefer changes that reduce the cost of the next upstream sync.
  • Share generally useful findings with the broader ecosystem when the contribution route permits it.

The pinned Pi build is 1.4.0+74f46864, commit 74f46864025c68504cd10c89eeb626b7e3d64cea of the main branch. The pin names the behavior oracle. It does not claim that every upstream change is already ported: test/parity/coverage.md reports verified behavior, and the upgrade ledgers under test/parity/upstream-sync/ list each upstream change and its disposition.

PiG's current package scope covers Pi's agent, AI, coding-agent, and TUI packages. It does not implement Pi's experimental remote Session packages or its standalone telemetry and evaluation packages. See docs/parity/PORT_MAP.md for the exact boundary.

Project facts

  • Binary: pig
  • Go module: github.com/MichaelKinsy/PiG
  • Configuration root: ~/.pig/, or PIG_HOME
  • Agent directory: ~/.pig/agent, or PIG_CODING_AGENT_DIR
  • Pi version pin: .upstream/pin (a release tag or a pinned commit; PI_UPSTREAM_REF=<tag|commit> overrides it for one run, make pin-bump moves it)
  • Local upstream mirror: .upstream/current/
  • Main verification gate: make check
  • Full verification and coverage refresh: make verify

pig --version prints PiG's version as <PiG release>+<Pi release>, for example 0.5.3+1.4.0+74f46864 (D63): the Pi release is semver build metadata, so the version sorts as the PiG release. pig version prints the PiG release and the pinned Pi release as separate fields. Neither command reads user configuration.

Repository map

Path Responsibility
agent/ Pi-compatible Agent loop, messages, and harness Session state.
ai/ Pi-compatible providers, model catalog, authentication, and streaming types.
coding/ Public coding-agent SDK, extension contracts, Package support, and Piglet support.
tui/ Public terminal components, rendering, input, and terminal lifecycle.
cmd/pig/ Stock PiG command-line application and RPC process surface.
internal/ Private implementation used by Stock PiG. External modules cannot import it.
extensions/ Go, Rust, Python, and declaration-only TypeScript extension SDKs.
piglets/ Explicit agent compositions such as PiG Standard and Pig Porter.
test/parity/ Pinned Pi correspondence, scenarios, inventories, and generated evidence.
test/ Integration, extension-conformance, clean-repository, and upstream-contract tests.
docs/ Maintainer references and the static public documentation site.
examples/ Small extension and embedding examples.
automation/ Build, generation, CI, release, layout, and maintainer tooling.

PiG aligns public package boundaries with Pi's agent, ai, coding-agent, and tui packages. Go files within a package follow cohesive implementation responsibilities instead of mirroring TypeScript file mechanics. docs/parity/PORT_MAP.md records every source correspondence.

Stock PiG and compositions

Stock PiG is the product-neutral binary built from this repository. It does not activate PiG Standard Resources, product authentication, product APIs, or deployment-specific behavior.

A Piglet explicitly selects Resources, tools, discovery, defaults, and environment requirements for one agent. A Package distributes Resources. A Package never owns or activates a Piglet. A Piglet Binary is a direct executable build output for one pinned Piglet composition.

PiG Standard is the explicit Piglet at piglets/standard/pig-standard.yaml. It currently selects the extension-provided PiG login, sprite catalogue, and PiG Runner. Run it from source with:

pig --piglet piglets/standard/pig-standard.yaml

Stock PiG never selects this composition implicitly. A Package can distribute its Resources, but a Package cannot own or activate the Piglet.

See CONTEXT.md and docs/README.md for the project terms and documentation map.

Security boundary

PiG runs with the permissions of the user who starts it. PiG does not provide a security sandbox for model output, tools, extensions, skills, hooks, or shell commands.

Use a container, virtual machine, or another operating-system boundary when you need isolation. Load extensions and project instructions only from sources you trust. See .github/SECURITY.md.

Install with npm

Install the command with npm (Node.js 18 or newer):

npm install -g @pi-in-go/pig
pig --version

Or run it once without installing:

npx @pi-in-go/pig --version

pig itself is the native binary: npm installs the matching platform package (@pi-in-go/pig-<os>-<cpu>, for macOS, Linux and Windows on x64 and arm64, and Android on arm64 for Termux) as an optional dependency, and Node.js runs only a small launcher. Do not install with --omit=optional or --no-optional, which leaves the binary out. Update with npm update -g @pi-in-go/pig and uninstall with npm uninstall -g @pi-in-go/pig. pig update does not replace an npm-installed binary; update through npm.

Install with Go

Install the command without a source checkout with Go 1.26 or newer:

go install github.com/MichaelKinsy/PiG/cmd/pig@latest

Go writes the pig executable to GOBIN, or to the bin directory of the first GOPATH entry when GOBIN is unset: $(go env GOPATH)/bin, which is ~/go/bin by default (%USERPROFILE%\go\bin on Windows). Add that directory to PATH. With an older Go 1.21 or later and the default GOTOOLCHAIN=auto, Go downloads a new enough toolchain automatically. Release binaries are built with Go 1.27.3.

Use an exact release such as @v0.2.0 when reproducibility matters. Update a Go installation by running go install again. Each release tags the root module (v0.2.0) and the Go extension SDK module (extensions/sdk/v0.2.0) on the same commit; go install needs both.

Build from source

PiG currently supports source builds on Linux, macOS, and Windows. Do not treat a platform as release-supported until its native release verification passes.

Requirements:

  • Go 1.27.3
  • Git
  • macOS 13 or later for native macOS builds
  • Node.js 24.22.1 and npm 12.1.0 for parity tooling
  • Python 3.12 for Python SDK tests
  • Rust 1.97.1 for Rust SDK tests
  • tmux for terminal parity tests on Unix

Build the binary:

go build -o bin/pig ./cmd/pig
./bin/pig --version

Prepare the exact Pi comparator and source mirror:

make upstream-mirror

Run the main local gate:

make check

The upstream-mirror target installs the Pi comparator of the pin: the lockfile-pinned package for a release tag, or a build of the pinned commit. It retrieves the exact Pi source and verifies its commit against .upstream/pin.

Contract model

A ported row means that code exists. It does not prove behavioral compatibility. A non-deferred scenario must exercise and assert the mapped behavior.

Extensions

PiG supports Go, Rust, Python, and Node extension factories through its public extension host. Extensions can register tools, commands, event handlers, flags, shortcuts, providers, and user-interface contributions.

Node extensions use Pi's TypeScript extension API. PiG supplies compatible runtime modules. The declaration-only package in extensions/sdk-ts adds types for PiG-only extension capabilities without replacing Pi's TypeScript runtime.

Start with:

Use pig extension init <directory> to scaffold an extension. Use pig install <path> --validate-only --json to validate it.

Supply-chain evidence

PiG treats scanner output as evidence input, not as proof by itself. Release preparation builds a validated dependency inventory and artifact-specific SPDX SBOMs. Reviewers reconcile scanner findings with Go modules, npm locks, Python metadata, Rust locks, embedded assets, generated data, and release contents.

See docs/supply-chain.md for the inventory, SBOM, vulnerability, license, signing, and provenance requirements.

Project policies

Acknowledgements

PiG would not exist without Pi and the work of its maintainers and contributors. Their design and open-source work provide the reference that PiG follows.

Thank you to everyone who contributes to Pi and PiG. Maintainers are listed in docs/project/MAINTAINERS.md, every contributor appears on GitHub's contributors page, and the changelog credits each fix to the person who reported or contributed it.

Star History

Star History Chart

Documentation

Overview

Package pig exposes build-time-embedded resources for the pig binary.

This is the only file at module root; runtime code lives in cmd/, internal/, coding/. Its sole purpose is to host `//go:embed` directives that need access to files at the repo root (Go embed cannot traverse to parent directories from a sub-package).

Currently embeds: - CHANGELOG.md, surfaced via the `/changelog` slash command.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Changelog

func Changelog() string

Changelog returns the bundled CHANGELOG.md, inflated on each call and not cached. Read by internal/codingagent's `/changelog` slash handler and the startup What's New.

Types

This section is empty.

Directories

Path Synopsis
Package agent provides the core agent loop and message types.
Package agent provides the core agent loop and message types.
Package ai provides provider abstractions, model definitions, and auth storage for pig.
Package ai provides provider abstractions, model definitions, and auth storage for pig.
automation
ci/allocbase command
Command allocbase ratchets the allocations per operation of the repository's Go benchmarks.
Command allocbase ratchets the allocations per operation of the repository's Go benchmarks.
ci/anytrap command
Command anytrap counts (outside test, build and example tooling, and vendored third-party code) the places that decode JSON into an interface-typed value: encoding/json's (and the extension SDK copy's, extensions/sdk/json) Unmarshal, UnmarshalRead, UnmarshalDecode and Decoder.Decode with an `any`, `map[string]any`, `[]any` or a type parameter as the destination.
Command anytrap counts (outside test, build and example tooling, and vendored third-party code) the places that decode JSON into an interface-typed value: encoding/json's (and the extension SDK copy's, extensions/sdk/json) Unmarshal, UnmarshalRead, UnmarshalDecode and Decoder.Decode with an `any`, `map[string]any`, `[]any` or a type parameter as the destination.
ci/bugledger command
Command bugledger generates the public bug fix ledger from the project's ground truth: the commit history since the previous release, the "Fixed" sections of CHANGELOG.md and changelog.d, and the divergence records that mark a Pi defect fixed ahead of Pi.
Command bugledger generates the public bug fix ledger from the project's ground truth: the commit history since the previous release, the "Fixed" sections of CHANGELOG.md and changelog.d, and the divergence records that mark a Pi defect fixed ahead of Pi.
ci/cargotarget command
Command cargotarget prints the persistent Cargo target directory a test package uses (internal/testenv.SharedCargoTargetDir), so make test-warm builds the Rust SDK dependencies into the same directory the tests reuse.
Command cargotarget prints the persistent Cargo target directory a test package uses (internal/testenv.SharedCargoTargetDir), so make test-warm builds the Rust SDK dependencies into the same directory the tests reuse.
ci/changelogfrag command
Command changelogfrag checks the user-facing changelog fragments in changelog.d, prints the Unreleased changelog they make up, and folds them into a release section of CHANGELOG.md.
Command changelogfrag checks the user-facing changelog fragments in changelog.d, prints the Unreleased changelog they make up, and folds them into a release section of CHANGELOG.md.
ci/divguard command
Command divguard fails CI on hidden, arbitrary divergences from Pi: invented limits, timeouts and defaults, silent exits, swallowed errors and dropped events that no docs/parity/DIVERGENCES.md entry records.
Command divguard fails CI on hidden, arbitrary divergences from Pi: invented limits, timeouts and defaults, silent exits, swallowed errors and dropped events that no docs/parity/DIVERGENCES.md entry records.
ci/divsplit command
Command divsplit generates docs/parity/DIVERGENCES.md from the one-file-per-record sources in docs/parity/divergences, and checks that the committed ledger equals what the sources produce.
Command divsplit generates docs/parity/DIVERGENCES.md from the one-file-per-record sources in docs/parity/divergences, and checks that the committed ledger equals what the sources produce.
ci/perflint command
Command perflint finds known Go performance antipatterns in non-test code and ratchets them like anytrap and port-lint:
Command perflint finds known Go performance antipatterns in non-test code and ratchets them like anytrap and port-lint:
ci/portlint command
Command portlint runs the porting anti-pattern analyzers over the module and fails on any finding the baseline does not list.
Command portlint runs the porting anti-pattern analyzers over the module and fails on any finding the baseline does not list.
ci/portlint/checks
Package checks holds the porting anti-pattern analyzers behind `make port-lint`.
Package checks holds the porting anti-pattern analyzers behind `make port-lint`.
ci/portlint/vettool command
Command vettool runs the portlint analyzers as a `go vet -vettool`, for an editor or an ad hoc run on one package:
Command vettool runs the portlint analyzers as a `go vet -vettool`, for an editor or an ad hoc run on one package:
ci/sdkapidiff command
Command sdkapidiff fails when the extension SDK makes an incompatible API change since its last release that has no upgrade rule or no release note.
Command sdkapidiff fails when the extension SDK makes an incompatible API change since its last release that has no upgrade rule or no release note.
ci/slopmetrics command
Command slopmetrics measures two code-quality signals from SlopCodeBench (arXiv:2603.24755) over the repository's hand-written Go code:
Command slopmetrics measures two code-quality signals from SlopCodeBench (arXiv:2603.24755) over the repository's hand-written Go code:
layout/scan command
Command scan parses tracked Go files without evaluating build constraints.
Command scan parses tracked Go files without evaluating build constraints.
portlens command
Command portlens renders a static HTML report of the port: the Pi pin and ledger health, the port map, divergences, the bug ledger, and evals and benchmarks.
Command portlens renders a static HTML report of the port: the Pi pin and ledger health, the port map, divergences, the bug ledger, and evals and benchmarks.
release/modulehash
Package modulehash computes the Go publication hashes of tracked module files.
Package modulehash computes the Go publication hashes of tracked module files.
release/modulesize command
Modulesize gates the root module zip that `go install github.com/MichaelKinsy/PiG/cmd/pig@<version>` downloads.
Modulesize gates the root module zip that `go install github.com/MichaelKinsy/PiG/cmd/pig@<version>` downloads.
release/set-version command
Set-version synchronizes repository release pins without publishing anything.
Set-version synchronizes repository release pins without publishing anything.
bench
durableperf command
Command durableperf runs the durable-bench workload (github.com/clavia-labs/durable-bench) on PiG's Go Durable over SQLite.
Command durableperf runs the durable-bench workload (github.com/clavia-labs/durable-bench) on PiG's Go Durable over SQLite.
k8s/cmd/k8sbench command
Command k8sbench runs PiG benchmarks on Kubernetes: one Job per session, PiG and the reference interleaved in the same pod on the same pinned cores, results in durable-report's tracker format.
Command k8sbench runs PiG benchmarks on Kubernetes: one Job per session, PiG and the reference interleaved in the same pod on the same pinned cores, results in durable-report's tracker format.
sessionscale
Package sessionscale writes synthetic long-lived Pi session files and the agent directory that resumes them, so the memory and per-prompt cost of a resumed session can be measured on Pi and PiG with the same bytes.
Package sessionscale writes synthetic long-lived Pi session files and the agent directory that resumes them, so the memory and per-prompt cost of a resumed session can be measured on Pi and PiG with the same bytes.
sessionscale/cmd/pigprobe command
Command pigprobe is cmd/pig with two additions for measurement: SIGUSR1 writes a heap profile (after a collection) to $SESSIONSCALE_HEAP_DIR/heap-<n>.pprof, then an empty heap-<n>.pprof.done marker; SIGUSR2 starts a CPU profile to $SESSIONSCALE_HEAP_DIR/cpu-<n>.pprof and the next SIGUSR2 stops it (then cpu-<n>.pprof.done).
Command pigprobe is cmd/pig with two additions for measurement: SIGUSR1 writes a heap profile (after a collection) to $SESSIONSCALE_HEAP_DIR/heap-<n>.pprof, then an empty heap-<n>.pprof.done marker; SIGUSR2 starts a CPU profile to $SESSIONSCALE_HEAP_DIR/cpu-<n>.pprof and the next SIGUSR2 stops it (then cpu-<n>.pprof.done).
sessionscale/cmd/sessionscale command
Command sessionscale writes and measures long-lived session fixtures (see package sessionscale).
Command sessionscale writes and measures long-lived session fixtures (see package sessionscale).
Package chord ports Pi's @earendil-works/chord root export base: strict JSON copies, the shared Context (a context.Context, see chord/context), and replicated state, either authoritative and mutable (NewReplicatedState) or a publication-only view of an external revision source (AttachReplicatedStateSource).
Package chord ports Pi's @earendil-works/chord root export base: strict JSON copies, the shared Context (a context.Context, see chord/context), and replicated state, either authoritative and mutable (NewReplicatedState) or a publication-only view of an external revision source (AttachReplicatedStateSource).
context
Package chordctx ports packages/chord/src/context/index.ts (`@earendil-works/chord/context`) onto context.Context.
Package chordctx ports packages/chord/src/context/index.ts (`@earendil-works/chord/context`) onto context.Context.
delta
Package delta ports @earendil-works/chord/delta (packages/chord/src/delta): immutable JSON revisions, exact operation batches for ordered replicas, the operation applier, the path-interning wire codec, revision diffing, and the revision tracker.
Package delta ports @earendil-works/chord/delta (packages/chord/src/delta): immutable JSON revisions, exact operation batches for ordered replicas, the operation applier, the path-interning wire codec, revision diffing, and the revision tracker.
host
Package host ports the Chord host runtime of Pi's @earendil-works/chord root export (packages/chord/src): contracts, hosts, objects, cells, roots, plugins, hot reload and links.
Package host ports the Chord host runtime of Pi's @earendil-works/chord root export (packages/chord/src): contracts, hosts, objects, cells, roots, plugins, hot reload and links.
sqlite
Package sqlite ports Pi's @earendil-works/chord/sqlite: the portable SQLite database facade, the atomic migration runner and schema-prefix validation that durable storage and other Chord hosts share.
Package sqlite ports Pi's @earendil-works/chord/sqlite: the portable SQLite database facade, the atomic migration runner and schema-prefix validation that durable storage and other Chord hosts share.
sqlite/cloudflare
Package cloudflare adapts the SQLite storage of a Cloudflare Durable Object to the portable Chord SQLite facade.
Package cloudflare adapts the SQLite storage of a Cloudflare Durable Object to the portable Chord SQLite facade.
sqlite/node
Package node adapts a native SQLite connection to the portable Chord SQLite facade.
Package node adapts a native SQLite connection to the portable Chord SQLite facade.
telemetrysqlite
Package telemetrysqlite ports Pi's @earendil-works/chord/telemetry-sqlite: a portable, buffered SQLite telemetry recorder and the TelemetryStore queries over its committed rows.
Package telemetrysqlite ports Pi's @earendil-works/chord/telemetry-sqlite: a portable, buffered SQLite telemetry recorder and the TelemetryStore queries over its committed rows.
cmd
check-model-data command
Command check-model-data validates a hydrated upstream model catalog before generation.
Command check-model-data validates a hydrated upstream model catalog before generation.
gen-classifier-models command
Command gen-classifier-models imports the CLASSIFIER_MODELS export of a published Pi models.generated.js and emits ai/classifier_models_generated.go.
Command gen-classifier-models imports the CLASSIFIER_MODELS export of a published Pi models.generated.js and emits ai/classifier_models_generated.go.
gen-models command
Command gen-models reads upstream pi's catalog and emits ai/models_generated.go.
Command gen-models reads upstream pi's catalog and emits ai/models_generated.go.
generate-schemas command
Command generate-schemas writes the JSON Schema artifacts of the configuration files (models.json, settings.json, keybindings.json and themes) to schemas/.
Command generate-schemas writes the JSON Schema artifacts of the configuration files (models.json, settings.json, keybindings.json and themes) to schemas/.
pig command
Command pig provides the PiG coding agent CLI.
Command pig provides the PiG coding agent CLI.
pig-eval-extension command
Command pig-eval-extension is the extension the eval harness loads into the pig process under test.
Command pig-eval-extension is the extension the eval harness loads into the pig process under test.
pig-evals command
Command pig-evals runs PiG's documentation evals, the Go port of Pi's packages/evals.
Command pig-evals runs PiG's documentation evals, the Go port of Pi's packages/evals.
Package codemode runs a model-written JavaScript script against a table of host tools and globals.
Package codemode runs a model-written JavaScript script against a table of host tools and globals.
cloudflare
Package cloudflare is the Cloudflare entry of codemode: the remote end of a remote sandbox as a Durable Object, and the inline sandbox with the QuickJS module the host bundled.
Package cloudflare is the Cloudflare entry of codemode: the remote end of a remote sandbox as a Durable Object, and the inline sandbox with the QuickJS module the host bundled.
cloudflare/cmd/codemodewasm command
Command codemodewasm is the codemode module of the Cloudflare Worker host: package codemode built with TinyGo as a WASI reactor (see durable/core/host/cf/tools/build-codemode-wasm.sh).
Command codemodewasm is the codemode module of the Cloudflare Worker host: package codemode built with TinyGo as a WASI reactor (see durable/core/host/cf/tools/build-codemode-wasm.sh).
Package coding is the public SDK for embedding the pig coding agent as a Go library.
Package coding is the public SDK for embedding the pig coding agent as a Go library.
cli
Package cli is the pig command line as a library: Main runs it for an argument list, as Pi's main(args, options) does (main.ts:573).
Package cli is the pig command line as a library: Main runs it for an argument list, as Pi's main(args, options) does (main.ts:573).
extension
Package extension defines the contract every pig extension speaks.
Package extension defines the contract every pig extension speaks.
extension/builtin
Package builtin is the registry of upstream's built-in extensions that PiG implements natively: the `builtin:<name>` extension paths of codemode and tool-search (docs/specs/builtin-codemode-tool-search.md).
Package builtin is the registry of upstream's built-in extensions that PiG implements natively: the `builtin:<name>` extension paths of codemode and tool-search (docs/specs/builtin-codemode-tool-search.md).
extension/builtin/codemode
Package codemode is the built-in `codemode` extension: the tool that lets the model write JavaScript that calls other tools.
Package codemode is the built-in `codemode` extension: the tool that lets the model write JavaScript that calls other tools.
extension/builtin/toolsearch
Package toolsearch is the built-in `tool_search` extension: tool discovery with a BM25 ranker over tool metadata, shared by `searchTools()` in codemode scripts and the optional `tool_search` tool.
Package toolsearch is the built-in `tool_search` extension: tool discovery with a BM25 ranker over tool metadata, shared by `searchTools()` in codemode scripts and the optional `tool_search` tool.
extension/extensiontest
Package extensiontest provides test doubles for the extension.API surface.
Package extensiontest provides test doubles for the extension.API surface.
extension/factoryload
Package factoryload runs the compiled-in extension factories of a binary: Go code that the source of the binary's own main package passes to it by value (docs/specs/extension-factory-trust.md).
Package factoryload runs the compiled-in extension factories of a binary: Go code that the source of the binary's own main package passes to it by value (docs/specs/extension-factory-trust.md).
extension/host/cellpack
Package cellpack is the Piglet-Binary-side counterpart to the host's prebuilt-cell seam (runtimecell.PrebuiltResolver).
Package cellpack is the Piglet-Binary-side counterpart to the host's prebuilt-cell seam (runtimecell.PrebuiltResolver).
extension/host/fusepack
Package fusepack holds Go extensions fused into a Piglet Binary.
Package fusepack holds Go extensions fused into a Piglet Binary.
extension/host/inproc
Package inproc implements the in-process Go dispatch runner for extensions.
Package inproc implements the in-process Go dispatch runner for extensions.
extension/host/runtimecell
Package runtimecell builds and resolves packed extension runtime cells.
Package runtimecell builds and resolves packed extension runtime cells.
extension/host/subprocess
Package subprocess implements pig's out-of-process extension transport: extensions communicate over a local stream socket with length-prefixed JSON framing.
Package subprocess implements pig's out-of-process extension transport: extensions communicate over a local stream socket with length-prefixed JSON framing.
extension/host/subprocess/internal/noderuntimegen command
Command noderuntimegen packages the Node runtime and its content identity reproducibly.
Command noderuntimegen packages the Node runtime and its content identity reproducibly.
extension/host/subprocess/internal/noderuntimepack
Package noderuntimepack stores the embedded Node runtime as a few solid zstd blocks.
Package noderuntimepack stores the embedded Node runtime as a few solid zstd blocks.
extension/host/subprocess/internal/noderuntimepeers
Package noderuntimepeers generates the host peer packages of the Node runtime archive: package.json and entry modules under runtime-node/harness/node_modules.
Package noderuntimepeers generates the host peer packages of the Node runtime archive: package.json and entry modules under runtime-node/harness/node_modules.
extension/host/tsruntime
Package tsruntime selects the runtime that runs PiG's TypeScript and JavaScript extension host.
Package tsruntime selects the runtime that runs PiG's TypeScript and JavaScript extension host.
extension/installresolver
Package installresolver is Pig's product-neutral seam for contributed package-source behavior.
Package installresolver is Pig's product-neutral seam for contributed package-source behavior.
extension/markdowntransform
Package markdowntransform holds the display-only Markdown transformer contract and its chain.
Package markdowntransform holds the display-only Markdown transformer contract and its chain.
extension/pigsdk
Package pigsdk stages Pig's extension SDKs (Go, Python, and Rust) into the config root so out-of-tree extension builds and packed runtime cells can use the API that matches the running binary.
Package pigsdk stages Pig's extension SDKs (Go, Python, and Rust) into the config root so out-of-tree extension builds and packed runtime cells can use the API that matches the running binary.
extension/source
Package source resolves an authorized extension path into one conventional factory or exact isolated standalone definition.
Package source resolves an authorized extension path into one conventional factory or exact isolated standalone definition.
extensionset
Package extensionset holds the in-process half of the extension set DefaultResourceLoader loads: the inline and built-in extension factories (resource-loader.ts loadExtensionFactories, loadExtensionPaths' `builtin:` branch) and omitReplacedExtensions.
Package extensionset holds the in-process half of the extension set DefaultResourceLoader loads: the inline and built-in extension factories (resource-loader.ts loadExtensionFactories, loadExtensionPaths' `builtin:` branch) and omitReplacedExtensions.
hookconfig
Package hookconfig parses and validates command hook files shared by Package validation and the runtime hook bridge.
Package hookconfig parses and validates command hook files shared by Package validation and the runtime hook bridge.
mcpext
Package mcpext is the built-in MCP integration (`builtin:mcp`).
Package mcpext is the built-in MCP integration (`builtin:mcp`).
packagecontent
Ports packages/coding-agent/src/core/package-manager.ts.
Ports packages/coding-agent/src/core/package-manager.ts.
piglet
Package piglet provides piglet-based capability scoping for pig sessions.
Package piglet provides piglet-based capability scoping for pig sessions.
piglet/artifact
Package artifact defines executable Piglet component plans and artifact records.
Package artifact defines executable Piglet component plans and artifact records.
piglet/internal/genstripids command
Command genstripids writes internal/pigstrip/ids_generated.go, the table of stable IDs a Piglet strip list may name, and the matching ID enums of coding/piglet/piglet.schema.json.
Command genstripids writes internal/pigstrip/ids_generated.go, the table of stable IDs a Piglet strip list may name, and the matching ID enums of coding/piglet/piglet.schema.json.
piglet/release
Package release verifies and installs signed Piglet Binary releases.
Package release verifies and installs signed Piglet Binary releases.
piglet/signature
Package signature signs and verifies Piglet Binaries.
Package signature signs and verifies Piglet Binaries.
pigletbuild
Package pigletbuild validates Piglet closure and builds source or binary Piglet artifacts.
Package pigletbuild validates Piglet closure and builds source or binary Piglet artifacts.
pigletbuild/binarypiglet
Package binarypiglet holds the Piglet and resolution record embedded in a Piglet Binary.
Package binarypiglet holds the Piglet and resolution record embedded in a Piglet Binary.
piglogin
Package piglogin is PiG's built-in sprite login: the sprite's 16-by-14 pig, which the startup header shows in Pi's logo slot, the full login art (the 12-pixel "PiG." hero wordmark with its drop shadow beside that pig) that /sprite preview shows, the sprites `/sprite` chooses from, and the selection kept under $PIG_HOME/state/pig-standard/login.json.
Package piglogin is PiG's built-in sprite login: the sprite's 16-by-14 pig, which the startup header shows in Pi's logo slot, the full login art (the 12-pixel "PiG." hero wordmark with its drop shadow beside that pig) that /sprite preview shows, the sprites `/sprite` chooses from, and the selection kept under $PIG_HOME/state/pig-standard/login.json.
rpcclient
Ports packages/coding-agent/src/modes/rpc/jsonl.ts
Ports packages/coding-agent/src/modes/rpc/jsonl.ts
secretresolver
Package secretresolver provides the product-neutral resolver seam for typed Piglet secret refs.
Package secretresolver provides the product-neutral resolver seam for typed Piglet secret refs.
source
Package source parses the source-reference vocabulary shared by package installation and Pig piglet resource origins.
Package source parses the source-reference vocabulary shared by package installation and Pig piglet resource origins.
Package durable ports the root module of Pi's @earendil-works/pi-durable: the durable conversation, task, and document runtime types, the ID kinds, the errors, the built-in entry kinds, document and task definitions, and the tool-output truncation helpers.
Package durable ports the root module of Pi's @earendil-works/pi-durable: the durable conversation, task, and document runtime types, the ID kinds, the errors, the built-in entry kinds, document and task definitions, and the tool-output truncation helpers.
codemode
Package codemode is durable code mode: a tool that runs model-written JavaScript in a QuickJS sandbox, whose script survives a restart.
Package codemode is durable code mode: a tool that runs model-written JavaScript in a QuickJS sandbox, whose script survives a restart.
core
Package core is PiG's synchronous Durable core (docs/plan/durable-core, ADR-0001): one deterministic state machine per Session that takes an ABI 1 event and returns a step of commits, reads, notices and effects.
Package core is PiG's synchronous Durable core (docs/plan/durable-core, ADR-0001): one deterministic state machine per Session that takes an ABI 1 event and returns a step of commits, reads, notices and effects.
core/abi
Package abi is the Durable core host ABI 1 (docs/plan/durable-core/ABI.md): the event, step and value types, their wire codecs, the step builder every core package emits into, and ID, the abi_id every build exports.
Package abi is the Durable core host ABI 1 (docs/plan/durable-core/ABI.md): the event, step and value types, their wire codecs, the step builder every core package emits into, and ID, the abi_id every build exports.
core/abi/abitest
Package abitest reads ABI event scripts and runs them through a native core.
Package abitest reads ABI event scripts and runs them through a native core.
core/abi/payload
Package payload holds the JSON shapes of ABI 1 event and effect payloads as hosts send and read them (ABI sections 5-7).
Package payload holds the JSON shapes of ABI 1 event and effect payloads as hosts send and read them (ABI sections 5-7).
core/abi/spec
Package spec holds the normative tables of ABI 1 (docs/plan/durable-core/ABI.md sections 4-8) and computes abi_id, the sha256 of their canonical rendering.
Package spec holds the normative tables of ABI 1 (docs/plan/durable-core/ABI.md sections 4-8) and computes abi_id, the sha256 of their canonical rendering.
core/abi/spec/cmd/abigen command
Command abigen writes durable/core/abi/id.go (the abi_id constant the core exports) and durable/core/abi/abi.json (the tables and abi_id the JavaScript hosts read) from the tables in package spec.
Command abigen writes durable/core/abi/id.go (the abi_id constant the core exports) and durable/core/abi/abi.json (the tables and abi_id the JavaScript hosts read) from the tables in package spec.
core/budget/coldhints command
Command coldhints marks the functions that the first turn of a session runs in a core built by build-wasm.sh, as WebAssembly compilation hints, so that a host that enables hints compiles them with Liftoff when it compiles the module instead of one at a time on its first call.
Command coldhints marks the functions that the first turn of a session runs in a core built by build-wasm.sh, as WebAssembly compilation hints, so that a host that enables hints compiles them with Liftoff when it compiles the module instead of one at a time on its first call.
core/budget/tinygo/patchdata command
Command patchdata writes the start address of .data, and the ranges of the globals that hold no heap pointers, into a TinyGo core built with the runtime fork in budget/tinygo.
Command patchdata writes the start address of .data, and the ranges of the globals that hold no heap pointers, into a TinyGo core built with the runtime fork in budget/tinygo.
core/cmd/corenative command
Command corenative serves the Durable core, built natively, to a host in another process over two FIFOs: the same exports as the WASI reactor (cmd/corewasm), one request and one response at a time.
Command corenative serves the Durable core, built natively, to a host in another process over two FIFOs: the same exports as the WASI reactor (cmd/corewasm), one request and one response at a time.
core/contracttest
Package contracttest is the Go side of the Durable core conformance gate (docs/plan/durable-core/CONTRACT.md sections 5-7).
Package contracttest is the Go side of the Durable core conformance gate (docs/plan/durable-core/CONTRACT.md sections 5-7).
core/contracttest/boundary
Package boundary checks that the production core links none of the reflection-driven standard-library packages TinyGo cannot build faithfully (go list -deps over the core packages, the Go and the Wasm configuration).
Package boundary checks that the production core links none of the reflection-driven standard-library packages TinyGo cannot build faithfully (go list -deps over the core packages, the Go and the Wasm configuration).
core/contracttest/cmd/benchhost command
Command benchhost runs the durable-bench scenario (CONTRACT section 6: W1, W2, W4c, X1 and the H handoff rows) on the production Durable core packages as a native bench host.
Command benchhost runs the durable-bench scenario (CONTRACT section 6: W1, W2, W4c, X1 and the H handoff rows) on the production Durable core packages as a native bench host.
core/contracttest/cmd/countgate command
Command countgate measures what the Durable core costs on a recorded workload (package counts): bytes allocated, mallocs, Wasm instructions on an instrumented module, native instructions under callgrind, and the growth of the live set per turn.
Command countgate measures what the Durable core costs on a recorded workload (package counts): bytes allocated, mallocs, Wasm instructions on an instrumented module, native instructions under callgrind, and the growth of the live set per turn.
core/contracttest/cmd/replayhost command
Command replayhost is a script-driven stand-in for a native Durable core host: it applies the statements of a recorded trace to a SQLite store, one transaction per commit, and writes its own trace with contracttest.Writer.
Command replayhost is a script-driven stand-in for a native Durable core host: it applies the statements of a recorded trace to a SQLite store, one transaction per commit, and writes its own trace with contracttest.Writer.
core/contracttest/cmd/scprovider command
Command scprovider serves the core's write encoder to the storage conformance suite (CONTRACT 3.10, the SC row): the suite's Storage is pi-durable's SqliteStorage for every read, and this process for commit and mintId.
Command scprovider serves the core's write encoder to the storage conformance suite (CONTRACT 3.10, the SC row): the suite's Storage is pi-durable's SqliteStorage for every read, and this process for commit and mintId.
core/contracttest/counts
Package counts is the Durable core's deterministic count gate (Durable plan 2, item 9) and its flight recorder format.
Package counts is the Durable core's deterministic count gate (Durable plan 2, item 9) and its flight recorder format.
core/contracttest/fuel
Package fuel meters a WebAssembly module: Instrument rewrites a module so that every basic block adds its own length to a counter, the Wasm instruction count the count gate ratchets (docs/plan/durable-core, Durable plan 2 item 9).
Package fuel meters a WebAssembly module: Instrument rewrites a module so that every basic block adds its own length to a counter, the Wasm instruction count the count gate ratchets (docs/plan/durable-core, Durable plan 2 item 9).
core/contracttest/guard
Package guard bounds a native host process of the conformance gate: a request that runs too long, a heap that grows past a limit, or a parent that has gone.
Package guard bounds a native host process of the conformance gate: a request that runs too long, a heap that grows past a limit, or a parent that has gone.
core/contracttest/storehost
Package storehost is the synchronous SQLite host of ABI section 3 for the store alone: tooling that drives store.Store (the benchmark engine, the storage-conformance provider) applies a step's commits and answers its reads with it.
Package storehost is the synchronous SQLite host of ABI section 3 for the store alone: tooling that drives store.Store (the benchmark engine, the storage-conformance provider) applies a step's commits and answers its reads with it.
core/docs
Package docs holds the built-in conversation documents of src/harness/agent.ts and provider.ts that no machine owns: pi.agent and pi.provider, and the conversation-creation step for pi.agent.
Package docs holds the built-in conversation documents of src/harness/agent.ts and provider.ts that no machine owns: pi.agent and pi.provider, and the conversation-creation step for pi.agent.
core/driver
Package driver holds the native Go effect executors of the Durable core (docs/plan/durable-core/ABI.md section 6, ADR-0001 D17).
Package driver holds the native Go effect executors of the Durable core (docs/plan/durable-core/ABI.md section 6, ADR-0001 D17).
core/history
Package history is the transcript half of the Durable core: entries, forks, head markers, context edits, compaction ranges and reset, and the context derivation that turns them into the model's messages.
Package history is the transcript half of the Durable core: entries, forks, head markers, context edits, compaction ranges and reset, and the context derivation that turns them into the model's messages.
core/history/internal/buildcheck command
Command buildcheck links the history package into a program so that TinyGo (-target=wasip1 -scheduler=none), Go wasip1 and native Go build the same source.
Command buildcheck links the history package into a program so that TinyGo (-target=wasip1 -scheduler=none), Go wasip1 and native Go build the same source.
core/inbox
Package inbox is the Session-side submission queue of src/harness/inbox.ts and submissions.ts: the built-in pi.inbox document, the boundaries that place queued items, and admission, abort and withdrawal of submissions.
Package inbox is the Session-side submission queue of src/harness/inbox.ts and submissions.ts: the built-in pi.inbox document, the boundaries that place queued items, and admission, abort and withdrawal of submissions.
core/internal/delta
Package delta ports Chord's immutable JSON deltas (@earendil-works/chord 1.0.4 `delta`: operations, the immutable applier and the overlay draft tracker) onto the ordered value model of package jv.
Package delta ports Chord's immutable JSON deltas (@earendil-works/chord 1.0.4 `delta`: operations, the immutable applier and the overlay draft tracker) onto the ordered value model of package jv.
core/jv
Package jv is the ordered JSON value model of the Durable core's session layer.
Package jv is the ordered JSON value model of the Durable core's session layer.
core/probe
Package probe is a small ABI 1 core that exists to test hosts.
Package probe is a small ABI 1 core that exists to test hosts.
core/rec
Package rec is the record layer for the records the core rewrites: pi-durable's conversation, task, submission and document records (spec §2, §3.2, §5.1, §6), written in pi-durable main da866ada's shapes and read tolerantly from 1.0.4 and newer stores (CONTRACT section 2.3).
Package rec is the record layer for the records the core rewrites: pi-durable's conversation, task, submission and document records (spec §2, §3.2, §5.1, §6), written in pi-durable main da866ada's shapes and read tolerantly from 1.0.4 and newer stores (CONTRACT section 2.3).
core/session
Package session is the Durable core's Session layer: the Session line, the transaction that stages one atomic commit (conversations, entries, tasks, submissions and documents), the document cache, and the task scheduler.
Package session is the Durable core's Session layer: the Session line, the transaction that stages one atomic commit (conversations, entries, tasks, submissions and documents), the document cache, and the task scheduler.
core/session/cmd/tgprobe command
Command tgprobe links the session layer's packages so the TinyGo build can prove they compile without reflection.
Command tgprobe links the session layer's packages so the TinyGo build can prove they compile without reflection.
core/session/hopcost
Package hopcost derives, in microtask ticks, how long Pi's Storage adapters take, so the core can park a line job on a hops chain as long as Pi's job (ABI.md section 5.3).
Package hopcost derives, in microtask ticks, how long Pi's Storage adapters take, so the core can park a line job on a hops chain as long as Pi's job (ABI.md section 5.3).
core/session/sessiontest
Package sessiontest provides an in-memory session.Store that keeps all committed state, as pi-durable's MemoryStorage does.
Package sessiontest provides an in-memory session.Store that keeps all committed state, as pi-durable's MemoryStorage does.
core/sqlhost
Package sqlhost is the native Go host of the Durable core (docs/plan/durable-core/ABI.md section 11, ADR-0001 D17).
Package sqlhost is the native Go host of the Durable core (docs/plan/durable-core/ABI.md section 11, ADR-0001 D17).
core/sqlhost/cmd/bench command
Command bench is the native candidate of the Durable conformance gate (durable/contract/impls/native.mjs): the bench scenario (durable/contract/scenarios/bench.mjs) run through the native session on the core, with its statements written as a trace of statements only (contracttest.Writer), which the Node tools replay onto the starting store.
Command bench is the native candidate of the Durable conformance gate (durable/contract/impls/native.mjs): the bench scenario (durable/contract/scenarios/bench.mjs) run through the native session on the core, with its statements written as a trace of statements only (contracttest.Writer), which the Node tools replay onto the starting store.
core/store
Package store owns pi-durable's SQLite format inside the core: the SQL table, the rows every commit writes (CONTRACT section 3.1, row identity with pi-durable main), the single-writer guard, the in-memory metadata, cold open of the live state (ADR D5), loads of committed non-live records, and the pig_ sidecar (ADR D6).
Package store owns pi-durable's SQLite format inside the core: the SQL table, the rows every commit writes (CONTRACT section 3.1, row identity with pi-durable main), the single-writer guard, the in-memory metadata, cold open of the live state (ADR D5), loads of committed non-live records, and the pig_ sidecar (ADR D6).
core/turn
Ports packages/ai/src/utils/overflow.ts (OVERFLOW_PATTERNS, NON_OVERFLOW_PATTERNS) Ports packages/ai/src/utils/retry.ts (RETRYABLE_PROVIDER_ERROR_PATTERN, NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN)
Ports packages/ai/src/utils/overflow.ts (OVERFLOW_PATTERNS, NON_OVERFLOW_PATTERNS) Ports packages/ai/src/utils/retry.ts (RETRYABLE_PROVIDER_ERROR_PATTERN, NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN)
durabletest
Package durabletest holds runner-independent conformance cases and benchmark workloads for durable.Storage implementations.
Package durabletest holds runner-independent conformance cases and benchmark workloads for durable.Storage implementations.
env
Package env declares the portable execution environment of pi-durable: a file system and a shell that tools and prompt sections use through a conversation's environment.
Package env declares the portable execution environment of pi-durable: a file system and a shell that tools and prompt sections use through a conversation's environment.
env/node
Package node is the local execution environment of pi-durable: NodeExecutionEnv runs on the host file system and shell.
Package node is the local execution environment of pi-durable: NodeExecutionEnv runs on the host file system and shell.
images
Package images is the image processor of pi-durable: it prepares the images read returns so the model can take them.
Package images is the image processor of pi-durable: it prepares the images read returns so the model can take them.
images/cloudflare
Package cloudflare is the image processor for Cloudflare Workers and Durable Objects.
Package cloudflare is the image processor for Cloudflare Workers and Durable Objects.
images/node
Package node is the image processor for hosts that load Photon's WebAssembly from an installed package.
Package node is the image processor for hosts that load Photon's WebAssembly from an installed package.
internal/detach
Package detach deep-copies the durable records that cross a storage or Harness boundary, so the copy shares no mutable memory with what it was read from.
Package detach deep-copies the durable records that cross a storage or Harness boundary, so the copy shares no mutable memory with what it was read from.
internal/entryscan
Package entryscan is the read-only range seam between the Harness context derivation and the storages that retain decoded entries.
Package entryscan is the read-only range seam between the Harness context derivation and the storages that retain decoded entries.
internal/ordered
Package ordered gives the dynamic JSON members of a decoded Go value the key order of their JSON text.
Package ordered gives the dynamic JSON members of a decoded Go value the key order of their JSON text.
internal/schemabackup
Package schemabackup copies a file-backed durable SQLite store before PiG upgrades its schema (D188).
Package schemabackup copies a file-backed durable SQLite store before PiG upgrades its schema (D188).
internal/search
Package search ranks tools for code mode's searchTools() and the tool_search tool with BM25.
Package search ranks tools for code mode's searchTools() and the tool_search tool with BM25.
session
Package session ports the pi-durable Session kernel: one mutation line, the loaded document tracker cache, transactions, document forks, and committed publication and observation.
Package session ports the pi-durable Session kernel: one mutation line, the loaded document tracker cache, transactions, document forks, and committed publication and observation.
session/sessiontest
Package sessiontest holds the shared Session test support: a controlled memory storage and an opened Session kernel with its publications.
Package sessiontest holds the shared Session test support: a controlled memory storage and an opened Session kernel with its publications.
storage
Package storage holds the in-memory reference implementation of the durable Storage contract.
Package storage holds the in-memory reference implementation of the durable Storage contract.
storage/internal/ops
Package ops replays stored Chord operation batches for the storage backends.
Package ops replays stored Chord operation batches for the storage backends.
storage/internal/scan
Package scan resolves the order and position of a built-in storage scan.
Package scan resolves the order and position of a built-in storage scan.
storage/internal/serial
Package serial is the one operation queue of the SQLite database adapters: operations run in call order and a transaction holds the queue until it settles (Pi's SerialQueue and the promise chain of NodeSqliteDatabase).
Package serial is the one operation queue of the SQLite database adapters: operations run in call order and a transaction holds the queue until it settles (Pi's SerialQueue and the promise chain of NodeSqliteDatabase).
storage/internal/writes
Package writes normalizes durable storage writes for the storage backends.
Package writes normalizes durable storage writes for the storage backends.
storage/jsonl
Package jsonl is the portable JSONL implementation of the durable Storage contract: one main commit log and per-document and per-task sidecar logs in one directory, accessed through a file system capability.
Package jsonl is the portable JSONL implementation of the durable Storage contract: one main commit log and per-document and per-task sidecar logs in one directory, accessed through a file system capability.
storage/jsonl/node
Package node opens JSONL durable storage on the local file system, the Go counterpart of Pi's Node JSONL adapter.
Package node opens JSONL durable storage on the local file system, the Go counterpart of Pi's Node JSONL adapter.
storage/sqlite
Package sqlite is the portable SQLite storage core of pi-durable: the durable schema, its migrations, and SqliteStorage.
Package sqlite is the portable SQLite storage core of pi-durable: the durable schema, its migrations, and SqliteStorage.
storage/sqlite/cloudflare
Package cloudflare opens durable storage on the SQLite storage of a Cloudflare Durable Object.
Package cloudflare opens durable storage on the SQLite storage of a Cloudflare Durable Object.
storage/sqlite/node
Package node opens durable storage on a native SQLite connection.
Package node opens durable storage on a native SQLite connection.
tools
Package tools is the coding tools of pi-durable: read, write, edit and bash over an execution environment.
Package tools is the coding tools of pi-durable: read, write, edit and bash over an execution environment.
toolsearch
Package toolsearch is the `tool_search` tool, a copy of the coding agent's: the model searches the deferred tools it is not offered yet, and the matches are loaded with the addTools control, so the next request offers them.
Package toolsearch is the `tool_search` tool, a copy of the coding agent's: the model searches the deferred tools it is not offered yet, and the matches are loaded with the addTools control, so the next request offers them.
env
Package env is the remote execution environment of Pi Durable: an agent's tools run on another machine, usually over SSH, while the Durable worker, its storage and credentials stay local.
Package env is the remote execution environment of Pi Durable: an agent's tools run on another machine, usually over SSH, while the Durable worker, its storage and credentials stay local.
cmd/pi-env command
Command pi-env is the remote execution environment daemon of Pi Durable: it serves the pi-env protocol on stdin and stdout.
Command pi-env is the remote execution environment daemon of Pi Durable: it serves the pi-env protocol on stdin and stdout.
daemon
Package daemon is pi-env's daemon: it gives a Pi Durable host an execution environment on this machine over a framed protocol on stdin and stdout, usually started through ssh as `pi-env serve --token <hex>`.
Package daemon is pi-env's daemon: it gives a Pi Durable host an execution environment on this machine over a framed protocol on stdin and stdout, usually started through ssh as `pi-env serve --token <hex>`.
examples
mcp-headless command
Command mcp-headless connects to one MCP server over stdio, prints the tools it offers, and exits.
Command mcp-headless connects to one MCP server over stdio, prints the tools it offers, and exits.
mcp-headless-full command
Command mcp-headless-full is the size baseline of examples/mcp-headless: it imports the full coding/mcpext package, which links the terminal UI through coding/extension.
Command mcp-headless-full is the size baseline of examples/mcp-headless: it imports the full coding/mcpext package, which links the terminal UI through coding/extension.
sdk command
Command sdk-example is a minimal demonstration of embedding the pig coding agent as a Go library via the public `coding` package.
Command sdk-example is a minimal demonstration of embedding the pig coding agent as a Go library via the public `coding` package.
extensions
sdk-py
Package pysdk carries the Python extension SDK sources so an installed pig can stage a buildable copy to disk.
Package pysdk carries the Python extension SDK sources so an installed pig can stage a buildable copy to disk.
sdk-rs
Package rssdk carries the Rust extension SDK sources so an installed pig can stage a buildable copy to disk.
Package rssdk carries the Rust extension SDK sources so an installed pig can stage a buildable copy to disk.
sdk module
internal
bodyreadhook
Package bodyreadhook lets a test fixture synchronize with a provider's HTTP connection reads.
Package bodyreadhook lets a test fixture synchronize with a provider's HTTP connection reads.
bodyreadhook/readbarrier
Package readbarrier synchronizes a test fixture server with the owned provider transport's socket reads.
Package readbarrier synchronizes a test fixture server with the owned provider transport's socket reads.
boundarywire
Package boundarywire lets the subprocess handlers of one turn_end or agent_before_settle dispatch share the encoding of the context preview.
Package boundarywire lets the subprocess handlers of one turn_end or agent_before_settle dispatch share the encoding of the context preview.
buildprogress
Package buildprogress reports product-neutral diagnostics for explicit builds.
Package buildprogress reports product-neutral diagnostics for explicit builds.
bytesize
Package bytesize parses the byte sizes PiG commands accept, such as 5GiB.
Package bytesize parses the byte sizes PiG commands accept, such as 5GiB.
changeobservers
Package changeobservers is the list of callbacks an owner of replicated state runs after the state changes, so the extension host can push it to the runtimes that replicate it.
Package changeobservers is the list of callbacks an owner of replicated state runs after the state changes, so the extension host can push it to the runtimes that replicate it.
childwait
Waiting for a child's output pipes after it exits.
Waiting for a child's output pipes after it exits.
chord/chordjson
Package chordjson ports packages/chord/src/json.ts: strict-JSON checking and alias-free copying.
Package chordjson ports packages/chord/src/json.ts: strict-JSON checking and alias-free copying.
coding/pigidentity
Package pigidentity holds the product identity PiG sends to services in place of Pi's.
Package pigidentity holds the product identity PiG sends to services in place of Pi's.
coding/pigversion
Package pigversion provides PiG and upstream Pi version pins to packages that cannot import coding.
Package pigversion provides PiG and upstream Pi version pins to packages that cannot import coding.
codingagent
Model picker auth-filter scope toggle.
Model picker auth-filter scope toggle.
codingagent/compaction
Ports packages/coding-agent/src/core/compaction/branch-summarization.ts Branch summarization for tree navigation.
Ports packages/coding-agent/src/core/compaction/branch-summarization.ts Branch summarization for tree navigation.
codingagent/configschema
Package configschema renders the JSON Schema artifacts of Pi's configuration files (models.json, settings.json, keybindings.json and themes) from Go schema trees.
Package configschema renders the JSON Schema artifacts of Pi's configuration files (models.json, settings.json, keybindings.json and themes) from Go schema trees.
codingagent/export
Ports packages/coding-agent/src/core/export-html/ansi-to-html.ts
Ports packages/coding-agent/src/core/export-html/ansi-to-html.ts
codingagent/frontmatter
Package frontmatter parses YAML frontmatter blocks from markdown files.
Package frontmatter parses YAML frontmatter blocks from markdown files.
codingagent/llama
Package llama ports Pi's built-in llama.cpp extension (packages/coding-agent/src/extensions/llama/): the router HTTP/SSE client, Hugging Face search and download, the dynamic provider, the manager UI, and the /llama command.
Package llama ports Pi's built-in llama.cpp extension (packages/coding-agent/src/extensions/llama/): the router HTTP/SSE client, Hugging Face search and download, the dynamic provider, the manager UI, and the /llama command.
codingagent/prompts
Package prompts builds the default coding-agent system prompt.
Package prompts builds the default coding-agent system prompt.
codingagent/timings
Package timings is the startup timing instrumentation Pi enables with PI_TIMING=1.
Package timings is the startup timing instrumentation Pi enables with PI_TIMING=1.
codingagent/tools
tools/bash_executor.go: user bash execution (!cmd, RPC bash, SDK ExecuteBash).
tools/bash_executor.go: user bash execution (!cmd, RPC bash, SDK ExecuteBash).
compactiontypes
Package compactiontypes holds the compaction types that both the extension API and the compaction pipeline name: Pi's CompactionPreparation, CompactionSettings and FileOperations (core/compaction).
Package compactiontypes holds the compaction types that both the extension API and the compaction pipeline name: Pi's CompactionPreparation, CompactionSettings and FileOperations (core/compaction).
configroot
Package configroot resolves PiG's config root, the directory PiG keeps its settings, documentation bundle and state under.
Package configroot resolves PiG's config root, the directory PiG keeps its settings, documentation bundle and state under.
configvalue
Package configvalue mirrors upstream pi's packages/coding-agent/src/core/resolve-config-value.ts (v0.78.1).
Package configvalue mirrors upstream pi's packages/coding-agent/src/core/resolve-config-value.ts (v0.78.1).
contentdirs
Package contentdirs keeps content-addressed directories under a shared config root: one directory per build of an embedded bundle, named <base>-<hash>.
Package contentdirs keeps content-addressed directories under a shared config root: one directory per build of an embedded bundle, named <base>-<hash>.
crossspawn
Package crossspawn starts a program the way upstream's spawnProcess does (coding-agent utils/child-process.ts): Node's spawn on Unix, and on Windows the cross-spawn package, which checks shebang interpreters before selecting direct execution or escaped cmd.exe execution for command shims.
Package crossspawn starts a program the way upstream's spawnProcess does (coding-agent utils/child-process.ts): Node's spawn on Unix, and on Windows the cross-spawn package, which checks shebang interpreters before selecting direct execution or escaped cmd.exe execution for command shims.
ctxowner
Package ctxowner joins the lifetime of one context with the request values of another.
Package ctxowner joins the lifetime of one context with the request values of another.
ecmascript
Package ecmascript preserves JavaScript JSON and string semantics at native boundaries.
Package ecmascript preserves JavaScript JSON and string semantics at native boundaries.
entered
Package entered is the shared mechanism that keeps upstream's start and resume order across goroutines.
Package entered is the shared mechanism that keeps upstream's start and resume order across goroutines.
evals
Package evals ports Pi's documentation eval tooling: the task plan, the comparison command and its Docker runner, the paired comparison report, the harness's prompt and environment helpers, and the fixtures the evals use.
Package evals ports Pi's documentation eval tooling: the task plan, the comparison command and its Docker runner, the paired comparison report, the harness's prompt and environment helpers, and the fixtures the evals use.
evals/bridge
Package bridge connects the eval harness to the extension that runs inside the agent process under test.
Package bridge connects the eval harness to the extension that runs inside the agent process under test.
evals/evalsuites
Package evalsuites holds the eval suites of Pi's packages/evals/evals directory, written against the PiG Session harness.
Package evalsuites holds the eval suites of Pi's packages/evals/evals directory, written against the PiG Session harness.
eventwire
Package eventwire lets the subprocess handlers of one event dispatch share the encoding of an event that no handler changed.
Package eventwire lets the subprocess handlers of one event dispatch share the encoding of an event that no handler changed.
filelock
Package filelock is the advisory file lock the extension cache and the SDK staging take.
Package filelock is the advisory file lock the extension cache and the SDK staging take.
frontendpack
Package frontendpack holds the frontend member fused into a Piglet Binary (D91).
Package frontendpack holds the frontend member fused into a Piglet Binary (D91).
fspublish
Package fspublish makes a file available at a new path without replacing a file that is already there: a fully written stage at its final path (Publish), or an existing file at a second path (Duplicate).
Package fspublish makes a file available at a new path without replacing a file that is already there: a fully written stage at its final path (Publish), or an existing file at a second path (Duplicate).
fsretry
Package fsretry retries file system operations that Windows refuses for a short time while another process holds a file open.
Package fsretry retries file system operations that Windows refuses for a short time while another process holds a file open.
gcpolicy
Package gcpolicy is PiG's GC target for print, json and rpc runs.
Package gcpolicy is PiG's GC target for print, json and rpc runs.
goroutineid
Package goroutineid identifies the calling goroutine for synchronous reentry checks.
Package goroutineid identifies the calling goroutine for synchronous reentry checks.
handleryield
Package handleryield carries, through an extension event's dispatch context, the call a host makes when a handler stops running synchronously.
Package handleryield carries, through an extension event's dispatch context, the call a host makes when a handler stops running synchronously.
ignorerules
Package ignorerules applies .gitignore, .ignore, and .fdignore files the way upstream Pi's package manager does when it discovers package resources.
Package ignorerules applies .gitignore, .ignore, and .fdignore files the way upstream Pi's package manager does when it discovers package resources.
imageprocessing
Image resize + re-encode policy for CLI/LLM image attachments, plus the EXIF orientation reader (upstream exif-orientation.ts).
Image resize + re-encode policy for CLI/LLM image attachments, plus the EXIF orientation reader (upstream exif-orientation.ts).
installchange
Package installchange tells a running pig that the files it runs from changed on disk.
Package installchange tells a running pig that the files it runs from changed on disk.
jsarray
Package jsarray implements JavaScript Array semantics that ported code observes.
Package jsarray implements JavaScript Array semantics that ported code observes.
jsclock
Package jsclock is the process clock of JavaScript's Date.now() and performance.now(), with a replaceable source.
Package jsclock is the process clock of JavaScript's Date.now() and performance.now(), with a replaceable source.
jsdiff
Package jsdiff ports the parts of the npm `diff` package (jsdiff 8.0.4) that Pi calls: diffWords, which Pi's renderDiff uses for intra-line highlighting, and diffLines, behind the edit tool's display diff and patch.
Package jsdiff ports the parts of the npm `diff` package (jsdiff 8.0.4) that Pi calls: diffWords, which Pi's renderDiff uses for intra-line highlighting, and diffLines, behind the edit tool's display diff and patch.
jsjson
Package jsjson reads JSON the way JSON.parse and property access do where encoding/json differs.
Package jsjson reads JSON the way JSON.parse and property access do where encoding/json differs.
jsloop
Package jsloop holds the ordering primitives that stand in for the one JavaScript thread Pi runs on.
Package jsloop holds the ordering primitives that stand in for the one JavaScript thread Pi runs on.
jsmath
Package jsmath implements ECMAScript Math functions with the results V8 returns, where Go's math package rounds differently.
Package jsmath implements ECMAScript Math functions with the results V8 returns, where Go's math package rounds differently.
jsnumber
Package jsnumber implements ECMAScript numeric conversion and serialization for values that arrive as JSON.
Package jsnumber implements ECMAScript numeric conversion and serialization for values that arrive as JSON.
jsonparse
Package jsonparse reports ECMAScript JSON.parse syntax errors for rejected JSON text.
Package jsonparse reports ECMAScript JSON.parse syntax errors for rejected JSON text.
jsonstringify
Package jsonstringify implements ECMAScript serialization for parsed JSON data.
Package jsonstringify implements ECMAScript serialization for parsed JSON data.
jsonvalid
Package jsonvalid reports whether a byte slice is one valid JSON text, with the verdict of the encoding/json scanner that session files were first checked with: the RFC 8259 grammar, no control character in a string, any \u escape (a lone surrogate included), bytes of any encoding inside a string, and nesting of at most 10,000 levels.
Package jsonvalid reports whether a byte slice is one valid JSON text, with the verdict of the encoding/json scanner that session files were first checked with: the RFC 8259 grammar, no control character in a string, any \u escape (a lone surrogate included), bytes of any encoding inside a string, and nesting of at most 10,000 levels.
jsparity
Package jsparity writes JSON exactly as JavaScript's JSON.stringify writes it.
Package jsparity writes JSON exactly as JavaScript's JSON.stringify writes it.
jsstring
Package jsstring preserves JavaScript UTF-16 units at Go string boundaries.
Package jsstring preserves JavaScript UTF-16 units at Go string boundaries.
latex
Package latex renders a basic subset of LaTeX math as terminal-friendly Unicode text.
Package latex renders a basic subset of LaTeX math as terminal-friendly Unicode text.
latex/gentables command
Command gentables extracts the static lookup tables from upstream pi's tui/src/latex.ts into Go source (symbols.go), so the LaTeX->Unicode port never hand-transcribes ~230 symbol rows.
Command gentables extracts the static lookup tables from upstream pi's tui/src/latex.ts into Go source (symbols.go), so the LaTeX->Unicode port never hand-transcribes ~230 symbol rows.
lazyregexp
Package lazyregexp compiles a package-level regular expression when it is first used instead of when its package initializes.
Package lazyregexp compiles a package-level regular expression when it is first used instead of when its package initializes.
lineadmission
Package lineadmission reports the moment an ordered queue fixes an operation's position.
Package lineadmission reports the moment an ordered queue fixes an operation's position.
linkerexec
Package linkerexec starts programs on Android builds that forbid executing files in an app's data directory.
Package linkerexec starts programs on Android builds that forbid executing files in an app's data directory.
lockorder
Package lockorder is a lock-acquisition-order checker for instrumented test builds.
Package lockorder is a lock-acquisition-order checker for instrumented test builds.
managementhttp
Package managementhttp ports upstream coding-agent utils/management-http.ts: a bounded immediate retry for idempotent management requests (tool downloads, release lookups).
Package managementhttp ports upstream coding-agent utils/management-http.ts: a bounded immediate retry for idempotent management requests (tool downloads, release lookups).
mermaid
Package mermaid renders Mermaid diagrams as Unicode box-drawing art for terminals.
Package mermaid renders Mermaid diagrams as Unicode box-drawing art for terminals.
minimatch
Package minimatch ports minimatch 10.2.6 (the glob matcher Pi uses for model scopes and package resource filters): brace expansion, `!` negation, `**`, character classes, extglobs and dot handling.
Package minimatch ports minimatch 10.2.6 (the glob matcher Pi uses for model scopes and package resource filters): brace expansion, `!` negation, `**`, character classes, extglobs and dot handling.
nativeplatform
Package nativeplatform provides operating-system queries and native clipboard transfers.
Package nativeplatform provides operating-system queries and native clipboard transfers.
nodebase64
Package nodebase64 reads base64 text as Node's Buffer.from(text, "base64") does.
Package nodebase64 reads base64 text as Node's Buffer.from(text, "base64") does.
nodeerrno
Package nodeerrno maps operating-system errors to the error codes, descriptions and errnos Node reports for them.
Package nodeerrno maps operating-system errors to the error codes, descriptions and errnos Node reports for them.
nodefs
Package nodefs ports the fs contracts Pi relies on: the directory order of fs.readdirSync and fs.existsSync.
Package nodefs ports the fs contracts Pi relies on: the directory order of fs.readdirSync and fs.existsSync.
nodepath
Package nodepath ports the parts of Node's path module Pi resolves file paths with.
Package nodepath ports the parts of Node's path module Pi resolves file paths with.
nodesemver
Package nodesemver translates the npm semver package (semver 7.8.5) calls Pi's package manager makes.
Package nodesemver translates the npm semver package (semver 7.8.5) calls Pi's package manager makes.
nodespawn
Package nodespawn builds the Windows command line that Node's child_process.spawn(file, args) passes to CreateProcessW when neither shell nor windowsVerbatimArguments is set.
Package nodespawn builds the Windows command line that Node's child_process.spawn(file, args) passes to CreateProcessW when neither shell nor windowsVerbatimArguments is set.
nodeurl
Package nodeurl ports the Node URL host/path handling and fileURLToPath semantics used by PiG.
Package nodeurl ports the Node URL host/path handling and fileURLToPath semantics used by PiG.
npmpublish
Package npmpublish runs `npm publish` for Packages and Piglet source on the author's behalf.
Package npmpublish runs `npm publish` for Packages and Piglet source on the author's behalf.
npmpublish/npmtest
Package npmtest is a stand-in npm and registry for tests of npm publication.
Package npmtest is a stand-in npm and registry for tests of npm publication.
orderedjson
Package orderedjson holds JSON objects that keep their keys in the order they were read or set, the way a JavaScript object does.
Package orderedjson holds JSON objects that keep their keys in the order they were read or set, the way a JavaScript object does.
outputfiles
Package outputfiles creates the files pi writes so the model can use output it was not shown in full: the full text of truncated tool output, binary MCP resources and images shown by codemode scripts.
Package outputfiles creates the files pi writes so the model can use output it was not shown in full: the full text of truncated tool output, binary MCP resources and images shown by codemode scripts.
ownerfile
Package ownerfile makes files accessible to their owner only and checks that they are: mode 0600 and no group or other bits on POSIX, and on Windows, which has no mode bits, a DACL (D68).
Package ownerfile makes files accessible to their owner only and checks that they are: mode 0600 and no group or other bits on POSIX, and on Windows, which has no mode bits, a DACL (D68).
packagemanager
Package packagemanager resolves, installs and reads the Packages that settings configure.
Package packagemanager resolves, installs and reads the Packages that settings configure.
perfgate
Package perfgate checks count metrics against the ratchet ceilings in automation/perf/ratchet.toml.
Package perfgate checks count metrics against the ratchet ceilings in automation/perf/ratchet.toml.
pigdocs
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root.
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root.
pigsdklock
Package pigsdklock coordinates readers and writers of staged Pig extension SDKs within one configuration root.
Package pigsdklock coordinates readers and writers of staged Pig extension SDKs within one configuration root.
pigstrip
Package pigstrip is the one strip state of a PiG process: the built-ins this process runs without.
Package pigstrip is the one strip state of a PiG process: the built-ins this process runs without.
pigstrip/leakgate
Package leakgate holds the tables of the strip leak gates: the user-visible names of every strip ID, which the interactive gate (internal/codingagent TestStripLeakGate) and the CLI gate (cmd/pig TestStripLeakGate) look for on the surfaces a stripped built-in must leave.
Package leakgate holds the tables of the strip leak gates: the user-visible names of every strip ID, which the interactive gate (internal/codingagent TestStripLeakGate) and the CLI gate (cmd/pig TestStripLeakGate) look for on the surfaces a stripped built-in must leave.
pilock
Package pilock implements Pi's proper-lockfile directory-lock protocol for shared stores.
Package pilock implements Pi's proper-lockfile directory-lock protocol for shared stores.
pioracle
Package pioracle runs the compiled Pi modules vendored for the Node extension runtime against Go test inputs, so a test compares Pig with Pi itself rather than with a transcription of Pi's behavior.
Package pioracle runs the compiled Pi modules vendored for the Node extension runtime against Go test inputs, so a test compares Pig with Pi itself rather than with a transcription of Pi's behavior.
procpolicy
Package procpolicy is PiG's GOMAXPROCS policy.
Package procpolicy is PiG's GOMAXPROCS policy.
profiling
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
realpath
Package realpath resolves the symbolic links of a path, as filepath.EvalSymlinks does, for the paths startup canonicalizes at every run: the working directory, the home directory and their ancestors.
Package realpath resolves the symbolic links of a path, as filepath.EvalSymlinks does, for the paths startup canonicalizes at every run: the working directory, the home directory and their ancestors.
requestvalidity
Package requestvalidity checks the requests PiG sends to model providers against each provider's documented message contract.
Package requestvalidity checks the requests PiG sends to model providers against each provider's documented message contract.
resolvepath
Package resolvepath resolves user-supplied resource paths the way Pi's resolvePath does.
Package resolvepath resolves user-supplied resource paths the way Pi's resolvePath does.
scalarjson
Package scalarjson supports JSON-normalized scalar copies without serialization.
Package scalarjson supports JSON-normalized scalar copies without serialization.
sessionentry
Package sessionentry holds the session log's entry values (core/session-manager.ts SessionHeader, SessionEntry and the entry types).
Package sessionentry holds the session log's entry values (core/session-manager.ts SessionHeader, SessionEntry and the entry types).
shellconfig
Package shellconfig resolves the bash shell PiG runs commands through, mirroring upstream packages/coding-agent/src/utils/shell.ts getShellConfig and getBashShellConfig.
Package shellconfig resolves the bash shell PiG runs commands through, mirroring upstream packages/coding-agent/src/utils/shell.ts getShellConfig and getBashShellConfig.
stackprime
Package stackprime grows the calling goroutine's stack in one step.
Package stackprime grows the calling goroutine's stack in one step.
termuxenv
Package termuxenv prepares a PiG process for Termux on Android.
Package termuxenv prepares a PiG process for Termux on Android.
testbudget
Package testbudget sizes the deadlines tests use to bound a hang.
Package testbudget sizes the deadlines tests use to bound a hang.
testenv
Package testenv checks host capabilities a test needs, so a test runs wherever the host provides them and says why it skipped where the host does not.
Package testenv checks host capabilities a test needs, so a test runs wherever the host provides them and says why it skipped where the host does not.
testscaling
Package testscaling measures how the cost of a hot path grows with the size of the input that grows in a session (history length, message size, transcript lines, keys) and fails a test when the growth exceeds the declared bound.
Package testscaling measures how the cost of a hot path grows with the size of the input that grows in a session (history length, message size, transcript lines, keys) and fails a test when the growth exceeds the declared bound.
text
Package text ports upstream packages/coding-agent/src/utils/text.ts: the leading byte order mark helpers every Pi reader applies before parsing user-authored JSON, markdown, and text files.
Package text ports upstream packages/coding-agent/src/utils/text.ts: the leading byte order mark helpers every Pi reader applies before parsing user-authored JSON, markdown, and text files.
tlsdistrust
Package tlsdistrust refuses TLS connections whose verified certificate chain contains a CA key that is known to be compromised, or a root certificate that Mozilla removed from NSS after the October 2026 eMudhra incident (Mozilla bug 2083449).
Package tlsdistrust refuses TLS connections whose verified certificate chain contains a CA key that is known to be compromised, or a root certificate that Mozilla removed from NSS after the October 2026 eMudhra incident (Mozilla bug 2083449).
tlsdistrust/tlsdistrusttest
Package tlsdistrusttest holds the public certificates of the October 2026 eMudhra incident and builds, for tests only, a server certificate signed by a compromised intermediate.
Package tlsdistrusttest holds the public certificates of the October 2026 eMudhra incident and builds, for tests only, a server certificate signed by a compromised intermediate.
toolchain
Package toolchain locates the build tools PiG uses for compiled extension cells and Piglet Binaries, and installs a PiG-managed Go toolchain for users who installed only the pig binary.
Package toolchain locates the build tools PiG uses for compiled extension cells and Piglet Binaries, and installs a PiG-managed Go toolchain for users who installed only the pig binary.
truncate
Package truncate holds the line and byte walks of Pi's truncateHead and truncateTail (packages/coding-agent/src/core/tools/truncate.ts), shared by the tools' result truncation, the bash-execution block's context limit and durable's truncateHead, which import cycles keep in different packages.
Package truncate holds the line and byte walks of Pi's truncateHead and truncateTail (packages/coding-agent/src/core/tools/truncate.ts), shared by the tools' result truncation, the bash-execution block's context limit and durable's truncateHead, which import cycles keep in different packages.
tui/parity
Package parity provides the test harness for TUI byte-level and visible-state parity against upstream pi-tui.
Package parity provides the test harness for TUI byte-level and visible-state parity against upstream pi-tui.
tui/termsim
Package termsim is a headless ANSI terminal simulator for byte-level parity testing.
Package termsim is a headless ANSI terminal simulator for byte-level parity testing.
typebox
Package typebox ports the parts of TypeBox 1.3.27 Value that PiG needs over JSON Schema data: Check, Errors, Clean, Default and Clone, with the format registry and the keyword spellings TypeBox accepts.
Package typebox ports the parts of TypeBox 1.3.27 Value that PiG needs over JSON Schema data: Check, Errors, Clean, Default and Clone, with the format registry and the keyword spellings TypeBox accepts.
upstreammirror
Package upstreammirror checks that a checkout's Pi source mirror, .upstream/current, is the Pi build a ledger version names.
Package upstreammirror checks that a checkout's Pi source mirror, .upstream/current, is the Pi build a ledger version names.
usagetotals
Package usagetotals sums model usage records.
Package usagetotals sums model usage records.
wordsegmenter
Package wordsegmenter implements word segments used by the terminal editor.
Package wordsegmenter implements word segments used by the terminal editor.
yaml12
Package yaml12 ports the parts of eemeli/yaml 2.9.0 that Pi's frontmatter parser runs (lexer, parser, composer, core schema, error text), so frontmatter reads and fails as it does in Pi.
Package yaml12 ports the parts of eemeli/yaml 2.9.0 that Pi's frontmatter parser runs (lexer, parser, composer, core schema, error text), so frontmatter reads and fails as it does in Pi.
mcp
Package mcp is a small, standalone Model Context Protocol client.
Package mcp is a small, standalone Model Context Protocol client.
mcptest
Package mcptest holds test doubles for package mcp.
Package mcptest holds test doubles for package mcp.
oauth
Package oauth is the MCP OAuth client subset: protected-resource and authorization-server discovery, the PKCE authorization code flow, dynamic client registration, token refresh (one refresh shared by concurrent 401s), and step-up authorization for insufficient_scope.
Package oauth is the MCP OAuth client subset: protected-resource and authorization-server discovery, the PKCE authorization code flow, dynamic client registration, token refresh (one refresh shared by concurrent 401s), and step-up authorization for insufficient_scope.
Package telemetry provides backend-neutral span carriers, propagation, links, metrics and in-memory recording.
Package telemetry provides backend-neutral span carriers, propagation, links, metrics and in-memory recording.
telemetrytest
Package telemetrytest holds runner-independent conformance cases for telemetry.TelemetryContext adapters.
Package telemetrytest holds runner-independent conformance cases for telemetry.TelemetryContext adapters.
test
extension-conformance/sdkscenarios
Package sdkscenarios is the one table of SDK conformance scenarios.
Package sdkscenarios is the one table of SDK conformance scenarios.
extension-conformance/testfixture
Command sdk-fixture is a minimal SDK-based extension for integration testing.
Command sdk-fixture is a minimal SDK-based extension for integration testing.
extension-conformance/testfixture/childsession
Package childsession is the Go SDK extension of the child agent session conformance rows: it creates a session over the host's model runtime with a custom tool, subscribes, prompts, reads the transcript and state back and disposes.
Package childsession is the Go SDK extension of the child agent session conformance rows: it creates a session over the host's model runtime with a custom tool, subscribes, prompts, reads the transcript and state back and disposes.
extension-conformance/testfixture/cmd command
Command sdk-fixture runs the canonical Go SDK conformance extension over a subprocess socket.
Command sdk-fixture runs the canonical Go SDK conformance extension over a subprocess socket.
extension-conformance/testfixture/extensionapi
Package extensionapi is the Go SDK extension of the Pi 0.99.1 extension API conformance rows.
Package extensionapi is the Go SDK extension of the Pi 0.99.1 extension API conformance rows.
extension-conformance/testfixture/modeltypes
Package modeltypes is the Go SDK extension of the typed model operation conformance rows: ctx.modelRegistry's typed reads, getAvailableOfType, classify and registerVirtualModel, and the image and classifier implementations of a provider config and of a Provider object.
Package modeltypes is the Go SDK extension of the typed model operation conformance rows: ctx.modelRegistry's typed reads, getAvailableOfType, classify and registerVirtualModel, and the image and classifier implementations of a provider config and of a Provider object.
extension-conformance/testfixture/nestedevents
Package nestedevents is the Go SDK extension of the nested-event conformance row (TestRPCNestedEventsCompleteInEverySDK): one command sends a triggering message while a before_agent_start handler is subscribed, and one appends an entry and then names the session while a session_info_changed handler is subscribed.
Package nestedevents is the Go SDK extension of the nested-event conformance row (TestRPCNestedEventsCompleteInEverySDK): one command sends a triggering message while a before_agent_start handler is subscribed, and one appends an entry and then names the session while a session_info_changed handler is subscribed.
extension-conformance/testfixture/nestedevents/cmd command
Command nested-events runs the nested-event conformance row's Go extension as a standalone executable, so the host gives it its own isolated process.
Command nested-events runs the nested-event conformance row's Go extension as a standalone executable, so the host gives it its own isolated process.
extension-conformance/testfixture/nestedevents/pig command
Command nested-events-pig is pig with the nested-event conformance row's Go extension fused in, as a Piglet Binary fuses one (fusepack.Register): the host serves the extension named nested-go-fused in this process instead of building it.
Command nested-events-pig is pig with the nested-event conformance row's Go extension fused in, as a Piglet Binary fuses one (fusepack.Register): the host serves the extension named nested-go-fused in this process instead of building it.
extension-conformance/testfixture/sessiongraph
Package sessiongraph is the Go SDK extension of the session graph conformance rows (session_graph_test.go): Pi's SessionManager constructors, listing and log methods as an extension builds them.
Package sessiongraph is the Go SDK extension of the session graph conformance rows (session_graph_test.go): Pi's SessionManager constructors, listing and log methods as an extension builds them.
integration
Package integration holds end-to-end tests that drive the real `pig` binary through a tmux PTY and assert on captured pane output.
Package integration holds end-to-end tests that drive the real `pig` binary through a tmux PTY and assert on captured pane output.
journeys
Package journeys holds PiG's end-to-end journeys: long sessions in a real pseudo-terminal against a scripted provider, run on PiG and on the pinned Pi release, with provider requests, session files and rendered frames compared.
Package journeys holds PiG's end-to-end journeys: long sessions in a real pseudo-terminal against a scripted provider, run on PiG and on the pinned Pi release, with provider requests, session files and rendered frames compared.
journeys/cmd/probe command
Command probe drives PiG and Pi through a short script in a real terminal and prints each product's screen, to learn what an interaction looks like before writing a journey step.
Command probe drives PiG and Pi through a short script in a real terminal and prints each product's screen, to learn what an interaction looks like before writing a journey step.
longsession
Package longsession writes a long Pi session fixture: a version 3 session file whose active context holds a chosen number of tokens, the agent directory that declares a scripted model with a chosen context window, and a metadata record.
Package longsession writes a long Pi session fixture: a version 3 session file whose active context holds a chosen number of tokens, the agent directory that declares a scripted model with a chosen context window, and a metadata record.
longsession/cmd/longsession command
Command longsession writes long Pi session fixtures and measures a harness's memory with one loaded.
Command longsession writes long Pi session fixtures and measures a harness's memory with one loaded.
mcp-conformance/client command
Command client is the client under test for the official MCP client conformance suite.
Command client is the client under test for the official MCP client conformance suite.
mcp-conformance/run command
Command run runs the official MCP client conformance suite against PiG (../client) and compares every check with the committed baseline (../baseline.json).
Command run runs the official MCP client conformance suite against PiG (../client) and compares every check with the committed baseline (../baseline.json).
parity/closure
Package closure stores and verifies the evidence graph used to assess PiG's correspondence with the pinned Pi source.
Package closure stores and verifies the evidence graph used to assess PiG's correspondence with the pinned Pi source.
parity/cmd/asynccheck command
Command asynccheck proves that every upstream source file with Promise/async behavior has an explicit cross-language disposition and durable evidence.
Command asynccheck proves that every upstream source file with Promise/async behavior has an explicit cross-language disposition and durable evidence.
parity/cmd/checkparityran command
Command checkparityran answers one question: did the parity suite actually compare pig against a real pi, or did it just skip?
Command checkparityran answers one question: did the parity suite actually compare pig against a real pi, or did it just skip?
parity/cmd/coverage command
Command coverage produces a markdown report linking parity scenarios to docs/parity/PORT_MAP.md entries.
Command coverage produces a markdown report linking parity scenarios to docs/parity/PORT_MAP.md entries.
parity/cmd/customfactoryledger command
Command customfactoryledger derives the internal custom-UI factory draft ledger from the pinned upstream public interface inventory.
Command customfactoryledger derives the internal custom-UI factory draft ledger from the pinned upstream public interface inventory.
parity/cmd/familygaps command
Command familygaps reports, for one behavior family, which upstream PORT_MAP entries fall within its scope and which lack behavioral verification.
Command familygaps reports, for one behavior family, which upstream PORT_MAP entries fall within its scope and which lack behavioral verification.
parity/cmd/lint command
Command lint validates parity scenarios against quality rules that AGENTS.md declares.
Command lint validates parity scenarios against quality rules that AGENTS.md declares.
parity/cmd/methodrefs command
Command methodrefs reports, with type information, which functions call each method of one Go type.
Command methodrefs reports, with type information, which functions call each method of one Go type.
parity/cmd/portmapcheck command
Command portmapcheck derives the PORT_MAP ✅ ticks instead of trusting them.
Command portmapcheck derives the PORT_MAP ✅ ticks instead of trusting them.
parity/cmd/portmapskeleton command
Command portmapskeleton writes one marker-test skeleton per Pi file that has no `// pi:` marker test yet.
Command portmapskeleton writes one marker-test skeleton per Pi file that has no `// pi:` marker test yet.
parity/cmd/portreconcile command
Command portreconcile produces the honest gap ledger for the Pig port.
Command portreconcile produces the honest gap ledger for the Pig port.
parity/cmd/prodreach command
Command prodreach lists the functions that the PiG binary can reach, by rapid type analysis from the main function and the package initializers of the given main packages, and from the exported API of the given library packages.
Command prodreach lists the functions that the PiG binary can reach, by rapid type analysis from the main function and the package initializers of the given main packages, and from the exported API of the given library packages.
parity/cmd/sdksurface command
Command sdksurface generates docs/extension-sdk-surface.md: every extension-facing surface of Pi's extension API, read from the pinned upstream types.ts and the declarations it re-exports or exposes, with one column per PiG extension runtime (the Node runtime and the Go, Rust and Python SDKs).
Command sdksurface generates docs/extension-sdk-surface.md: every extension-facing surface of Pi's extension API, read from the pinned upstream types.ts and the declarations it re-exports or exposes, with one column per PiG extension runtime (the Node runtime and the Go, Rust and Python SDKs).
parity/cmd/testinventorycheck command
Command testinventorycheck validates the reviewed disposition mapping over the upstream-test inventory.
Command testinventorycheck validates the reviewed disposition mapping over the upstream-test inventory.
parity/cmd/testprune command
Command testprune inventories and classifies PiG's tests, measures the coverage a deletion batch would lose, and enforces the provenance ratchet for golden files and for expectations edited together with the code they test.
Command testprune inventories and classifies PiG's tests, measures the coverage a deletion batch would lose, and enforces the provenance ratchet for golden files and for expectations edited together with the code they test.
parity/cmd/upstreamdelta command
Command upstreamdelta proves that every changed upstream source file in a version leap received an explicit disposition and durable evidence.
Command upstreamdelta proves that every changed upstream source file in a version leap received an explicit disposition and durable evidence.
parity/correspondence
Package correspondence compares pinned Pi source interfaces with PiG targets and produces deterministic review packets.
Package correspondence compares pinned Pi source interfaces with PiG targets and produces deterministic review packets.
parity/interface-closure/autobind command
Command autobind is a deterministic gap detector for the Pi interface ledger.
Command autobind is a deterministic gap detector for the Pi interface ledger.
parity/interface-closure/autobind/rules
Package rules is the registry of deterministic mapping rules from Pi's TypeScript shapes to PiG's Go shapes.
Package rules is the registry of deterministic mapping rules from Pi's TypeScript shapes to PiG's Go shapes.
parity/interface-closure/breakdown/testrefs command
testrefs prints, per directory with Go tests, which identifiers each Test function reaches (itself plus same-package helper functions, depth 3) and whether it asserts (calls t.Error*/Fatal*/Fail*/assert/require).
testrefs prints, per directory with Go tests, which identifiers each Test function reaches (itself plus same-package helper functions, depth 3) and whether it asserts (calls t.Error*/Fatal*/Fail*/assert/require).
parity/interface-closure/stubfields command
Command stubfields generates the missing plain-data fields of Go structs from the interface-gap list.
Command stubfields generates the missing plain-data fields of Go structs from the interface-gap list.
parity/internal/gitsnapshot
Package gitsnapshot resolves and validates immutable Git tree identities for parity evidence.
Package gitsnapshot resolves and validates immutable Git tree identities for parity evidence.
parity/internal/ledgertarget
Package ledgertarget pins the platform the interface ledger is derived for.
Package ledgertarget pins the platform the interface ledger is derived for.
parity/knowngaps
Package knowngaps loads test/parity/known-gaps.toml, the one ledger of parity gaps that gates tolerate against the pinned Pi version.
Package knowngaps loads test/parity/known-gaps.toml, the one ledger of parity gaps that gates tolerate against the pinned Pi version.
parity/porter
Package porter exposes the single deterministic process contract used by the direct Porter adapter and the Pig Porter extension.
Package porter exposes the single deterministic process contract used by the direct Porter adapter and the Pig Porter extension.
parity/upstreampackages
Package upstreampackages is the one list of the upstream monorepo packages that the parity tools account for.
Package upstreampackages is the one list of the upstream monorepo packages that the parity tools account for.
perfgate
Package perfgate holds the whole-process count gates: a built pig runs the print, RPC and startup paths with PIG_PROFILE=metrics under GOMAXPROCS=1, and its exit record (allocations, bytes, GC cycles, live heap, peak RSS, goroutines, descriptors, child processes), plus the entries it left in its private TMPDIR, is checked against automation/perf/ratchet.toml.
Package perfgate holds the whole-process count gates: a built pig runs the print, RPC and startup paths with PIG_PROFILE=metrics under GOMAXPROCS=1, and its exit record (allocations, bytes, GC cycles, live heap, peak RSS, goroutines, descriptors, child processes), plus the entries it left in its private TMPDIR, is checked against automation/perf/ratchet.toml.
upstream-parity
Package parity parses upstream pi TypeScript declarations to drive parity tests.
Package parity parses upstream pi TypeScript declarations to drive parity tests.
third_party
awssdk/config
Package config provides utilities for loading configuration from multiple sources that can be used to configure the SDK's API clients, and utilities.
Package config provides utilities for loading configuration from multiple sources that can be used to configure the SDK's API clients, and utilities.
awssdk/config/internal/ini
Package ini implements parsing of the AWS shared config file.
Package ini implements parsing of the AWS shared config file.
awssdk/credentials
Package credentials provides types for retrieving credentials from credentials sources.
Package credentials provides types for retrieving credentials from credentials sources.
awssdk/credentials/logincreds
Package logincreds implements AWS credential provision for sessions created via an `aws login` command.
Package logincreds implements AWS credential provision for sessions created via an `aws login` command.
awssdk/credentials/ssocreds
Package ssocreds provides a credential provider for retrieving temporary AWS credentials using an SSO access token.
Package ssocreds provides a credential provider for retrieving temporary AWS credentials using an SSO access token.
awssdk/credentials/stscreds
Package stscreds are credential Providers to retrieve STS AWS credentials.
Package stscreds are credential Providers to retrieve STS AWS credentials.
awssdk/internal/auth/smithy
Package smithy adapts concrete AWS auth and signing types to the generic smithy versions.
Package smithy adapts concrete AWS auth and signing types to the generic smithy versions.
awssdk/internal/endpoints/awsrulesfn
Package awsrulesfn provides AWS focused endpoint rule functions for evaluating endpoint resolution rules.
Package awsrulesfn provides AWS focused endpoint rule functions for evaluating endpoint resolution rules.
awssdk/service/bedrockruntime
Package bedrockruntime provides the API client, operations, and parameter types for Amazon Bedrock Runtime.
Package bedrockruntime provides the API client, operations, and parameter types for Amazon Bedrock Runtime.
awssdk/service/bedrockruntime/document
Package document implements encoding and decoding of open-content that has a JSON-like data model.
Package document implements encoding and decoding of open-content that has a JSON-like data model.
awssdk/service/internal/accept-encoding
Package acceptencoding provides customizations associated with Accept Encoding Header.
Package acceptencoding provides customizations associated with Accept Encoding Header.
awssdk/service/internal/presigned-url
Package presignedurl provides the customizations for API clients to fill in presigned URLs into input parameters.
Package presignedurl provides the customizations for API clients to fill in presigned URLs into input parameters.
awssdk/service/signin
Package signin provides the API client, operations, and parameter types for AWS Sign-In Service.
Package signin provides the API client, operations, and parameter types for AWS Sign-In Service.
awssdk/service/sso
Package sso provides the API client, operations, and parameter types for AWS Single Sign-On.
Package sso provides the API client, operations, and parameter types for AWS Single Sign-On.
awssdk/service/ssooidc
Package ssooidc provides the API client, operations, and parameter types for AWS SSO OIDC.
Package ssooidc provides the API client, operations, and parameter types for AWS SSO OIDC.
awssdk/service/sts
Package sts provides the API client, operations, and parameter types for AWS Security Token Service.
Package sts provides the API client, operations, and parameter types for AWS Security Token Service.
goldmark/ast
Package ast defines AST nodes that represent markdown elements.
Package ast defines AST nodes that represent markdown elements.
goldmark/parser
Package parser contains stuff that are related to parsing a Markdown text.
Package parser contains stuff that are related to parsing a Markdown text.
goldmark/text
Package text provides functionalities to manipulate texts.
Package text provides functionalities to manipulate texts.
goldmark/util
Code generated by _tools; DO NOT EDIT.
Code generated by _tools; DO NOT EDIT.
semver
Package semver provides the ability to work with Semantic Versions (http://semver.org) in Go.
Package semver provides the ability to work with Semantic Versions (http://semver.org) in Go.
tui
Package tui provides Pi-compatible terminal rendering, input, components, keybindings, and screen lifecycle management.
Package tui provides Pi-compatible terminal rendering, input, components, keybindings, and screen lifecycle management.
widthx
Package widthx implements Pi's terminal width, grapheme and ANSI operations with JavaScript UTF-16 semantics.
Package widthx implements Pi's terminal width, grapheme and ANSI operations with JavaScript UTF-16 semantics.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL