Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ploeg-mcp
command
Command ploeg-mcp serves Ploeg's operator API as MCP tools.
|
Command ploeg-mcp serves Ploeg's operator API as MCP tools. |
|
ploeg-okf
command
Command ploeg-okf works with the OKF bundles Ploeg briefs Runs from:
|
Command ploeg-okf works with the OKF bundles Ploeg briefs Runs from: |
|
ploeg-worker
command
ploeg-worker runs as the main container of an executor-spawned Job (docs/contracts/executor.md): it claims one work item from ploegd, drives a headless harness run via the adapter selected by PLOEG_HARNESS (design §5), and reports an OutcomeReport before exit.
|
ploeg-worker runs as the main container of an executor-spawned Job (docs/contracts/executor.md): it claims one work item from ploegd, drives a headless harness run via the adapter selected by PLOEG_HARNESS (design §5), and reports an OutcomeReport before exit. |
|
ploegd
command
ploegd is Ploeg's single daemon: webhook ingest, provider SPI host, lease manager, outcome ingestion.
|
ploegd is Ploeg's single daemon: webhook ingest, provider SPI host, lease manager, outcome ingestion. |
|
internal
|
|
|
ledger
Package ledger holds the consistency gate for the ADR corpus in docs/adrs/ (ADR 0001).
|
Package ledger holds the consistency gate for the ADR corpus in docs/adrs/ (ADR 0001). |
|
pkg
|
|
|
activework
Package activework tells a Run which other active Shifts work in its repository and which paths they share with it (ADR-0123).
|
Package activework tells a Run which other active Shifts work in its repository and which paths they share with it (ADR-0123). |
|
claudesession
Package claudesession verifies the session token Anthropic gives every Claude Code session in a self-hosted environment (CLAUDE_CODE_SESSION_ACCESS_TOKEN), so ploegd can trust a request that comes from a runner's session hook (ADR-0084).
|
Package claudesession verifies the session token Anthropic gives every Claude Code session in a self-hosted environment (CLAUDE_CODE_SESSION_ACCESS_TOKEN), so ploegd can trust a request that comes from a runner's session hook (ADR-0084). |
|
config
Package config loads ploegd's routing and roster configuration from a FILE rather than from environment variables.
|
Package config loads ploegd's routing and roster configuration from a FILE rather than from environment variables. |
|
contextbundle
Package contextbundle checks and unpacks the files a person attaches to a Work Item (proposed, context bundles proof of concept).
|
Package contextbundle checks and unpacks the files a person attaches to a Work Item (proposed, context bundles proof of concept). |
|
diffmeasure
Package diffmeasure takes raw per-file measurements from a unified diff, so Ploeg can keep them as delivery facts without keeping the diff (ADR-0079).
|
Package diffmeasure takes raw per-file measurements from a unified diff, so Ploeg can keep them as delivery facts without keeping the diff (ADR-0079). |
|
findings
Package findings derives the findings ledger of a Work Item (ADR-0121): which reviewer findings were raised by id, how each writer answered them, which questions Runs asked and who answered, and where a shadow reviewer's verdict differed from the acting reviewers'.
|
Package findings derives the findings ledger of a Work Item (ADR-0121): which reviewer findings were raised by id, how each writer answered them, which questions Runs asked and who answered, and where a shadow reviewer's verdict differed from the acting reviewers'. |
|
followup
Package followup decides what happens to the Work Items a Run proposes (Product R12, ADR-0031): which are stored, for which Team, in which state, with how much budget, and why any are rejected.
|
Package followup decides what happens to the Work Items a Run proposes (Product R12, ADR-0031): which are stored, for which Team, in which state, with how much budget, and why any are rejected. |
|
forgebroker
Package forgebroker is the credential seam between Ploeg and a git forge: mint a repo-scoped, write-scoped token for one writing Run, hand it over, and revoke it when the Run settles or its Lease lapses.
|
Package forgebroker is the credential seam between Ploeg and a git forge: mint a repo-scoped, write-scoped token for one writing Run, hand it over, and revoke it when the Run settles or its Lease lapses. |
|
forgefacts
Package forgefacts turns what a forge reported about a pull request into the facts pkg/store keeps (ADR-0045, ADR-0046).
|
Package forgefacts turns what a forge reported about a pull request into the facts pkg/store keeps (ADR-0045, ADR-0046). |
|
gate
Package gate maps tracker statuses to the delivery gates a Work Item passes, and reads the reason a Work Item bounced back (ADR-0051).
|
Package gate maps tracker statuses to the delivery gates a Work Item passes, and reads the reason a Work Item bounced back (ADR-0051). |
|
githubapi
Package githubapi holds what every GitHub caller in Ploeg shares: where the REST API lives for a GitHub web root, a client that waits out GitHub's primary and secondary rate limits, and Link-header pagination (ADR-0086).
|
Package githubapi holds what every GitHub caller in Ploeg shares: where the REST API lives for a GitHub web root, a client that waits out GitHub's primary and secondary rate limits, and Link-header pagination (ADR-0086). |
|
githubapp
Package githubapp mints repository-scoped GitHub App installation tokens.
|
Package githubapp mints repository-scoped GitHub App installation tokens. |
|
harness
Package harness defines the contract between Ploeg and an agent harness: TaskSpec in, OutcomeReport out.
|
Package harness defines the contract between Ploeg and an agent harness: TaskSpec in, OutcomeReport out. |
|
harness/adapters/acp
Package acp adapts any agent speaking the Agent Client Protocol (ACP wire version 1) to Ploeg's harness seam — opencode, Gemini CLI, Goose and OpenHands natively, plus Codex and Claude Code through npm adapter processes.
|
Package acp adapts any agent speaking the Agent Client Protocol (ACP wire version 1) to Ploeg's harness seam — opencode, Gemini CLI, Goose and OpenHands natively, plus Codex and Claude Code through npm adapter processes. |
|
harness/adapters/claudecode
Package claudecode adapts the Claude Code CLI (backlog #62): a headless `claude -p` run with a JSON result envelope mapped into OutcomeReport usage (cost, tokens, session id).
|
Package claudecode adapts the Claude Code CLI (backlog #62): a headless `claude -p` run with a JSON result envelope mapped into OutcomeReport usage (cost, tokens, session id). |
|
harness/adapters/claudeenv
Package claudeenv runs a Run as a Claude Code session in a Team's self-hosted Claude environment (ADR-0084).
|
Package claudeenv runs a Run as a Claude Code session in a Team's self-hosted Claude environment (ADR-0084). |
|
harness/adapters/execbin
Package execbin is the generic escape-hatch adapter: run any binary against the published task contract.
|
Package execbin is the generic escape-hatch adapter: run any binary against the published task contract. |
|
harness/adapters/openhands
Package openhands adapts the OpenHands agent-runner image: the prompt is written to a task file and the image's baked entrypoint runs it headless.
|
Package openhands adapts the OpenHands agent-runner image: the prompt is written to a task file and the image's baked entrypoint runs it headless. |
|
harness/harnesstest
Package harnesstest is the adapter conformance kernel (backlog #69): every adapter must satisfy these properties regardless of which harness it wraps.
|
Package harnesstest is the adapter conformance kernel (backlog #69): every adapter must satisfy these properties regardless of which harness it wraps. |
|
harness/skills
Package skills holds the Agent Skills Ploeg mounts into every Run.
|
Package skills holds the Agent Skills Ploeg mounts into every Run. |
|
httpapi
Package httpapi exposes ploegd's two surfaces: webhook ingest (tracker → queued work) and the run API an agent container uses (claim, renew, checkpoint, outcome) per the worker-claims-at-startup convention (backlog #48).
|
Package httpapi exposes ploegd's two surfaces: webhook ingest (tracker → queued work) and the run API an agent container uses (claim, renew, checkpoint, outcome) per the worker-claims-at-startup convention (backlog #48). |
|
knowledge
Package knowledge selects the part of one or more OKF bundles that bears on a Work Item and writes it as a knowledge pack: an OKF bundle of its own that a Run reads from disk, with an index that says why each concept is there.
|
Package knowledge selects the part of one or more OKF bundles that bears on a Work Item and writes it as a knowledge pack: an OKF bundle of its own that a Run reads from disk, with an index that says why each concept is there. |
|
knowledgegraph
Package knowledgegraph reads and writes a Tenant's knowledge graphs through the stored queries of the tenant-knowledge and tenant-notes schemas (ADR-0087, ADR-0088, both proposed).
|
Package knowledgegraph reads and writes a Tenant's knowledge graphs through the stored queries of the tenant-knowledge and tenant-notes schemas (ADR-0087, ADR-0088, both proposed). |
|
litellm
Package litellm wraps the LiteLLM proxy admin API for per-run key lifecycle (mint + revoke, list + batch delete).
|
Package litellm wraps the LiteLLM proxy admin API for per-run key lifecycle (mint + revoke, list + batch delete). |
|
llmbroker
Package llmbroker is the credential seam between Ploeg and an LLM gateway: mint a budgeted per-run credential before the harness starts, revoke it on every return path, and reconcile leaks from ploegd's sweeps.
|
Package llmbroker is the credential seam between Ploeg and an LLM gateway: mint a budgeted per-run credential before the harness starts, revoke it on every return path, and reconcile leaks from ploegd's sweeps. |
|
mcpauth
Package mcpauth makes an MCP server an OAuth 2.1 resource server for an OpenID Connect issuer such as Authentik.
|
Package mcpauth makes an MCP server an OAuth 2.1 resource server for an OpenID Connect issuer such as Authentik. |
|
okf
Package okf reads and writes Open Knowledge Format (OKF) v0.1 bundles: a directory of markdown files, one concept per file, each opening with YAML frontmatter whose only required field is type.
|
Package okf reads and writes Open Knowledge Format (OKF) v0.1 bundles: a directory of markdown files, one concept per file, each opening with YAML frontmatter whose only required field is type. |
|
omnigraph
Package omnigraph is a minimal client for an Omnigraph server's stored queries: ploegd invokes the queries a deployment's bundle declares and never sends query text of its own.
|
Package omnigraph is a minimal client for an Omnigraph server's stored queries: ploegd invokes the queries a deployment's bundle declares and never sends query text of its own. |
|
omnigraph/omnigraphtest
Package omnigraphtest fakes an Omnigraph server's notes graph over HTTP, answering the tenant-notes stored queries the way Omnigraph 0.11 does.
|
Package omnigraphtest fakes an Omnigraph server's notes graph over HTTP, answering the tenant-notes stored queries the way Omnigraph 0.11 does. |
|
operatorclient
Package operatorclient is a Go client for Ploeg's operator API (docs/contracts/operator-api.v1.schema.json).
|
Package operatorclient is a Go client for Ploeg's operator API (docs/contracts/operator-api.v1.schema.json). |
|
plan
Package plan parses and validates Team plans: the ordered list of Rounds a Shift works through, each naming Roles with their writes flag and per-Run spending cap (run-multi-agent-shifts design.md D5).
|
Package plan parses and validates Team plans: the ordered list of Rounds a Shift works through, each naming Roles with their writes flag and per-Run spending cap (run-multi-agent-shifts design.md D5). |
|
premise
Package premise is the premise check before a Work Item's writer (ADR-0123, deciding ADR-0036's T0): one classifier call on a gateway model that costs nothing per token says whether the Work Item can go to a writer as written, needs a person's answer first, or is too big for one pull request.
|
Package premise is the premise check before a Work Item's writer (ADR-0123, deciding ADR-0036's T0): one classifier call on a gateway model that costs nothing per token says whether the Work Item can go to a writer as written, needs a person's answer first, or is too big for one pull request. |
|
provider
Package provider defines Ploeg's SPI.
|
Package provider defines Ploeg's SPI. |
|
provider/clickup
Package clickup is a TrackerProvider for ClickUp, the sibling of pkg/provider/vikunja: webhook verification and parsing, plus the API write-backs that let a run reach a person (backlog #31).
|
Package clickup is a TrackerProvider for ClickUp, the sibling of pkg/provider/vikunja: webhook verification and parsing, plus the API write-backs that let a run reach a person (backlog #31). |
|
provider/forgejo
Package forgejo is the reference ForgeProvider (design §4): the first implementation of an interface that has been declared since the SPI was carved and had no caller until the blackboard needed one (ADR-0011).
|
Package forgejo is the reference ForgeProvider (design §4): the first implementation of an interface that has been declared since the SPI was carved and had no caller until the blackboard needed one (ADR-0011). |
|
provider/github
Package github is the ForgeProvider for GitHub (github.com and GitHub Enterprise Server), the sibling of pkg/provider/forgejo and pkg/provider/gitlab (ADR-0086).
|
Package github is the ForgeProvider for GitHub (github.com and GitHub Enterprise Server), the sibling of pkg/provider/forgejo and pkg/provider/gitlab (ADR-0086). |
|
provider/githubissues
Package githubissues is a TrackerProvider for GitHub Issues: webhook verification and parsing, authenticated issue reads, and the comment and close write-backs that let a Run reach a person (ADR-0085).
|
Package githubissues is a TrackerProvider for GitHub Issues: webhook verification and parsing, authenticated issue reads, and the comment and close write-backs that let a Run reach a person (ADR-0085). |
|
provider/gitlab
Package gitlab is a ForgeProvider for GitLab (self-managed or gitlab.com), the sibling of pkg/provider/forgejo.
|
Package gitlab is a ForgeProvider for GitLab (self-managed or gitlab.com), the sibling of pkg/provider/forgejo. |
|
provider/vikunja
Package vikunja is the reference TrackerProvider (design §4): webhook verification and parsing, plus the API write-backs that let a run reach a person (backlog #31).
|
Package vikunja is the reference TrackerProvider (design §4): webhook verification and parsing, plus the API write-backs that let a run reach a person (backlog #31). |
|
sandboxlaunch
Package sandboxlaunch starts one Run on kubernetes-sigs/agent-sandbox: it creates a single cold SandboxClaim for the launcher's Job and waits for it to finish (docs/contracts/executor.md, the agent-sandbox executor).
|
Package sandboxlaunch starts one Run on kubernetes-sigs/agent-sandbox: it creates a single cold SandboxClaim for the launcher's Job and waits for it to finish (docs/contracts/executor.md, the agent-sandbox executor). |
|
shiftengine
Package shiftengine owns the Shift lifecycle: when a Shift opens, how a Round advances, when a Shift closes, and what happens when either is left half-done (run-multi-agent-shifts, shift-orchestration spec).
|
Package shiftengine owns the Shift lifecycle: when a Shift opens, how a Round advances, when a Shift closes, and what happens when either is left half-done (run-multi-agent-shifts, shift-orchestration spec). |
|
store
Package store is Ploeg's Postgres data layer: work items, leases, checkpoints, runs, and the audit log.
|
Package store is Ploeg's Postgres data layer: work items, leases, checkpoints, runs, and the audit log. |
|
svgsafe
Package svgsafe decides whether an SVG an operator consumer hands Ploeg is safe to store on a forge and embed in a pull request comment (ADR-0079).
|
Package svgsafe decides whether an SVG an operator consumer hands Ploeg is safe to store on a forge and embed in a pull request comment (ADR-0079). |
|
target
Package target resolves where a Work Item's changes land.
|
Package target resolves where a Work Item's changes land. |
|
transcript
Package transcript records what an agent did during a Run as ordered, typed entries and ships them to ploegd in batches (ADR-0090).
|
Package transcript records what an agent did during a Run as ordered, typed entries and ships them to ploegd in batches (ADR-0090). |
|
work
Package work defines Ploeg's core semantics: work items, leases, checkpoints, and outcomes.
|
Package work defines Ploeg's core semantics: work items, leases, checkpoints, and outcomes. |
|
worker
Package worker is the run orchestrator that executes one claimed work item: claim → clone → compose prompt → mint credential → harness adapter run → forge-poll outcome resolution → outcome report.
|
Package worker is the run orchestrator that executes one claimed work item: claim → clone → compose prompt → mint credential → harness adapter run → forge-poll outcome resolution → outcome report. |
Click to show internal directories.
Click to hide internal directories.