pig

package module
v0.3.0 Latest Latest
Warning

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

Go to latest
Published: Sep 29, 2026 License: MIT Imports: 1 Imported by: 0

README

PiG

CI CodeQL OpenSSF Scorecard OpenSSF Best Practices REUSE status Go Reference Minimum Go version Latest release Pi pin 0.87.1 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 0.87.1 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 or Linux:

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 release is 0.87.1 at commit f07218c4d4bbc12bef056a7058c3dd49dfe41abe. 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: internal/coding/pigversion/pigversion.go
  • 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.2.0+0.87.1 (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) 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.1.

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.1
  • Git
  • macOS 13 or later for native macOS builds
  • Node.js 24.19.0 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 lockfile-pinned Pi package. It retrieves the exact tagged Pi source and verifies its commit against internal/coding/pigversion/pigversion.go.

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

View Source
var Changelog string

Changelog is the bundled CHANGELOG.md, embedded at build time. Read by internal/codingagent's `/changelog` slash handler. Empty when the file is missing at build time (which would fail the embed and the build).

Functions

This section is empty.

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.
harness
Ports packages/agent/src/harness/prompt-templates.ts.
Ports packages/agent/src/harness/prompt-templates.ts.
harness/agentharness
Package agentharness holds the public durable AgentHarness data contracts of packages/agent/src/harness/agent-harness.ts, the passive HarnessEventBus of harness/events.ts and the ordered HookRegistry of harness/hooks.ts.
Package agentharness holds the public durable AgentHarness data contracts of packages/agent/src/harness/agent-harness.ts, the passive HarnessEventBus of harness/events.ts and the ordered HookRegistry of harness/hooks.ts.
harness/compaction
Package compaction prepares and summarizes durable harness entries with an embedded retained tail.
Package compaction prepares and summarizes durable harness entries with an embedded retained tail.
harness/env
Package env provides NodeExecutionEnv, the host-OS filesystem and shell implementation of the harness execution environment.
Package env provides NodeExecutionEnv, the host-OS filesystem and shell implementation of the harness execution environment.
harness/execution
Package execution provides effect admission for the durable agent harness.
Package execution provides effect admission for the durable agent harness.
harness/pico3
Package pico3 is the experimental Pico3 agent kernel: durable records, commit-granular documents, a single-writer Session line, a task scheduler, the built-in turn kinds, and the watch view protocol.
Package pico3 is the experimental Pico3 agent kernel: durable records, commit-granular documents, a single-writer Session line, a task scheduler, the built-in turn kinds, and the watch view protocol.
harness/runtime
Package runtime owns the durable AgentHarness runtime: lane control projections, serialized commands, and installed drive passes with their effect gates.
Package runtime owns the durable AgentHarness runtime: lane control projections, serialized commands, and installed drive passes with their effect gates.
harness/session
Package session implements the durable harness session: the write-once entry tree, bound values and lists, the usage ledger, the storage contract, the Session mutation line, Branch capabilities, forks, and the in-memory backend.
Package session implements the durable harness session: the write-once entry tree, bound values and lists, the usage ledger, the storage contract, the Session mutation line, Branch capabilities, forks, and the in-memory backend.
harness/session/testing
Package sessiontesting holds runner-independent session test fixtures and storage decorators shared by every backend's conformance and benchmarks.
Package sessiontesting holds runner-independent session test fixtures and storage decorators shared by every backend's conformance and benchmarks.
harness/session/testing/benchmark
Package benchmark holds the deterministic session workloads shared by every backend's storage and repository benchmarks.
Package benchmark holds the deterministic session workloads shared by every backend's storage and repository benchmarks.
harness/session/testing/conformance
Package conformance holds the runner-independent Storage and SessionRepo conformance suites every session backend must pass.
Package conformance holds the runner-independent Storage and SessionRepo conformance suites every session backend must pass.
harness/tools
Package tools provides the execution-environment-backed tools of the agent harness.
Package tools provides the execution-environment-backed tools of the agent harness.
harness/utils
Package utils holds the harness usage arithmetic, adaptive publication, and bounded shell-output capture helpers.
Package utils holds the harness usage arithmetic, adaptive publication, and bounded shell-output capture helpers.
search
Package search defines the session and entry search contracts exported by the agent package.
Package search defines the session and entry search contracts exported by the agent package.
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/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/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.
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/set-version command
Set-version synchronizes repository release pins without publishing anything.
Set-version synchronizes repository release pins without publishing anything.
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-image-models command
Command gen-image-models imports a published Pi image catalog or a strict OpenRouter response and emits ai/image_models_generated.go.
Command gen-image-models imports a published Pi image catalog or a strict OpenRouter response and emits ai/image_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.
pig command
Command pig provides the PiG coding agent CLI.
Command pig provides the PiG coding agent CLI.
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.
extension
Package extension defines the contract every pig extension speaks.
Package extension defines the contract every pig extension speaks.
extension/extensiontest
Package extensiontest provides test doubles for the extension.API surface.
Package extensiontest provides test doubles for the extension.API surface.
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/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/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.
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.
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/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.
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.
examples
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.
buildprogress
Package buildprogress reports product-neutral diagnostics for explicit builds.
Package buildprogress reports product-neutral diagnostics for explicit builds.
chord
Package chord is the local Go runtime for the subset of Pi 0.87.1's packages/chord that the experimental service graph consumes: replicated state, the remote service provider and its endpoint, the operation-stream replica binding, and JSON-copy transports.
Package chord is the local Go runtime for the subset of Pi 0.87.1's packages/chord that the experimental service graph consumes: replicated state, the remote service provider and its endpoint, the operation-stream replica binding, and JSON-copy transports.
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/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
Ports packages/coding-agent/src/utils/frontmatter.ts.
Ports packages/coding-agent/src/utils/frontmatter.ts.
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/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).
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).
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.
ecmascript
Package ecmascript preserves JavaScript JSON and string semantics at native boundaries.
Package ecmascript preserves JavaScript JSON and string semantics at native boundaries.
experimental
Ports packages/coding-agent/src/experimental/client-tui.ts.
Ports packages/coding-agent/src/experimental/client-tui.ts.
experimental/client
Package client implements the experimental Pi client over ordered byte transports.
Package client implements the experimental Pi client over ordered byte transports.
experimental/mini/shared
Package shared implements mini's local service protocol and transports.
Package shared implements mini's local service protocol and transports.
experimental/protocol
Package protocol implements the framed experimental Pi wire contract.
Package protocol implements the framed experimental Pi wire contract.
experimental/routing
Package routing hosts contract-agnostic experimental server and client routing.
Package routing hosts contract-agnostic experimental server and client routing.
experimental/services
Package services contains the opt-in experimental presentation service contracts.
Package services contains the opt-in experimental presentation service contracts.
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).
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.
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.
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.
nativeplatform
Package nativeplatform provides operating-system queries and native clipboard transfers.
Package nativeplatform provides operating-system queries and native clipboard transfers.
nodeerrno
Package nodeerrno maps operating-system errors to the error codes and descriptions Node reports for them.
Package nodeerrno maps operating-system errors to the error codes and descriptions Node reports for them.
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.
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.
pigdocs
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root (`~/.pig/docs` by default).
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root (`~/.pig/docs` by default).
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.
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.
profiling
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
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.
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.
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.
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.
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.
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.
wordsegmenter
Package wordsegmenter implements word segments used by the terminal editor.
Package wordsegmenter implements word segments used by the terminal editor.
Package telemetry provides backend-neutral span carriers and in-memory recording.
Package telemetry provides backend-neutral span carriers and in-memory recording.
test
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/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.
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.
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/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/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/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/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/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.
upstream-parity
Package parity parses upstream pi TypeScript declarations to drive parity tests.
Package parity parses upstream pi TypeScript declarations to drive parity tests.
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