EXTENSIONS
Built by operatives — models, drivers, vaults, and reports, the parts that plug into Swamp.
Filter by what you need and pull what fits.
Github
Query GitHub data using the gh CLI for repository, PR, issue, release, and workflow visibility.
Gitlab
Read and write GitLab data via GraphQL (REST fallback for branches and
Forgejo
Careful administration of a Forgejo (or Gitea) server over its /api/v1 REST API, authenticated with a scoped access token. Find-or-create organizations and repositories and converge their settings, run GitHub pull-mirrors (create via /repos/migrate, reconcile interval/visibility, queue immediate syncs), audit every mirror's sync health, drive pull requests (open, inspect with mergeability and head CI state, merge), and audit or repoint repository webhooks so a stale CI target is visible rather than silently undelivered. Mutations are find-or-create or reversible (archive/unarchive) apart from the guarded pr_merge; there are no delete methods — a failed migration's empty shell repo is detected and reported, never auto-deleted. Secrets are never emitted: mirror source credentials are write-only, and webhook operations neither read nor write the shared hook secret.
Git
Git repository operations for swamp workflows. Wraps the git CLI
Change Packet
Forge-neutral immutable change packets for reviewed repository delivery. Records exact Git base/head identity, validation evidence, requested draft submission metadata, a canonical SHA-256 digest, and derived readiness. Performs no network, Git, forge, approval, merge, or release operation.
Git Workspace
Local git operations model — clone, branch, read, commit, push, rebase. Designed for agent-driven development workflows where code changes are authored locally and pushed to a remote forge. Supports a configurable workspace layout (default: $HOME/{host}/{group}/{project}) and commit message format enforcement.
Graphite Draft Submit
Submit an already-validated Git commit as a draft GitHub pull request using the Graphite CLI, then independently verify with the GitHub CLI that the pull request points at the validated SHA, branch and base and is a draft.
Git Compare
Structured git comparison — produces per-file diffs between refs and auto-discovers structural patterns to flag deviations in new code. Two methods: diff (structured breakdown) and check (pattern-based review with ready-to-post markdown comments).
Forgejo Code
Code-reading methods for @shrug/forgejo — map a repository's file tree, read individual files, and snapshot every matching text file into one reviewable data blob. Turns a metadata-only forge node into a source for code review and IaC analysis.
Graphite Stack
Composition lifecycle for a Graphite (gt) multi-PR stack — validate a declared linear plan, finalize one-commit units, cascade restacks, pin a composed head, and submit gated, idempotent, ordered draft PRs.
Test Evidence Validator
Validates a caller-supplied parsed test result for internal consistency and a recognized multi-language test-runner command, then commit-pins the evidence to an immutable Git commit and branch, returning a single pass/fail verdict.
Github
List GitHub pull requests via the gh CLI from swamp workflows.
Forgejo
Query [Forgejo](https://forgejo.org/) and [Gitea](https://gitea.io/) instances
Repo Indexer
Clones a GitLab repository, chunks all text files, embeds them via an OpenAI-compatible API, and writes a SQLite database supporting hybrid search (FTS5 keyword + vector cosine with RRF reranking). Methods: index, index_batch, search, reindex, status, discover, list-indexed, list-searches.
Github
GitHub management — create repositories, releases, and pull requests via the GitHub REST API (Octokit). Read-only sync plus idempotent ensureRepo / ensureRelease / openPr, each dryRun by default.