Skip to main content

willow-bot

GitHub App webhook receiver + orchestrator-feeding steward for the Willow fleet. Propose-only: the App may comment and deposit draft CI outcomes; it cannot commit.

Install: pip install willow-bot
Docs: INSTALL.md · docs/MOVE-STAY-BORROW.md

willow-bot              # webhook (uvicorn)
willow-bot-steward tick    # PR watch one-shot
willow-bot-steward status  # read-only surface: version, tick, inbox depth, cursors
willow-bot-steward status --brief  # one line per section
willow-bot-steward app-grant  # does the App have the permissions and events the code needs?
willow-bot-steward contributions --days 30  # who contributed: outsiders, first-timers, per repo
willow-bot-steward contributions --backfill  # fill the ledger from GitHub history (core_repos, 90 days)
willow-bot-contribute [--user LOGIN]   # anyone: your projects, what waits on you, openings (your GITHUB_TOKEN or gh login, never the App's)
willow-bot-steward heartbeat  # curated willow-mcp tools when WILLOW_BOT_MCP=1
willow-bot-deterministic serve   # host loopback runner (Unix socket for Kart)
willow-bot-deterministic client --fixtures /path/to/S-growth-*.json dir

Home: willow-memory/willow-bot
Anyone can run it as their own GitHub App. Who you are, which orgs and repos it looks after, and where the voice speaks live in your install's operator profile ($WILLOW_HOME/willow-bot/operator.json; see deploy/operator.example.json), never in code. With no profile it discovers what it can and otherwise does nothing. Match actors by user.type == Bot, never login.

Metadata

Release files for willow-bot 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for willow-bot 1.2.2
File Size Uploaded
willow_bot-1.2.2.tar.gz 572.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for willow-bot 1.2.2
File Interpreter ABI Platform
willow_bot-1.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 771.2 kB

Release files / willow_bot-1.2.2.tar.gz

Download URL willow_bot-1.2.2.tar.gz
Size 572.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a96bccf404e25ebd2258df8dd915dc6a62bb5bbb0eb86d7db443d6db03727ead
BLAKE2b-256 checksum
How to use checksums
b9e52d2cc03f94eba34e149dfa133a8762b62c0c9eb04da3201aee616edba1ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log

Release files / willow_bot-1.2.2-py3-none-any.whl

Download URL willow_bot-1.2.2-py3-none-any.whl
Size 198.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
067419952519b1d50821f4572e5c3064e193010f130b5ec4725f37d1fcad6075
BLAKE2b-256 checksum
How to use checksums
dfc241757ba4ac494e15474178aae0a89aa6cfc5339ec07f50b9eb9709474a12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log

Release history Release notifications | RSS feed

1.11.0

2 release files

1.10.1

2 release files

1.10.0

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.5

2 release files

1.2.4

2 release files

1.2.3

2 release files

This release

1.2.2 This release

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.16.0

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.3

2 release files

0.11.2

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page