Bunnyshell integration

Bunnyshell is an Environments-as-a-Service (EaaS) platform: it builds and runs ephemeral, full-stack environments from your repository (containers, dependencies, URLs) so you get a real deployment of your app for a branch or PR—not a single mocked process.

TestChimp can integrate with Bunnyshell so automated QA and agents target fresh environments that match what you are about to merge, instead of only a long-lived staging slot.

Why ephemeral environments per PR

• Isolation: Each change set gets its own URL and data plane, reducing “someone else broke staging” noise.
• Shift-left: Run SmartTests and /testchimp test against a stack built from the current branch before merge—failures map to this PR’s diff.
• Fidelity: Exercise real services, migrations, and config together; catch integration issues that local mocks miss.
• Cost control: Environments are created when needed and torn down when the agent or CI workflow finishes (policy depends on your Bunnyshell and TestChimp configuration).

How TestChimp integrates

In TestChimp → Project settings → Integrations, configure Bunnyshell (credentials and the environment definition / blueprint Bunnyshell should use for this product). TestChimp stores enough context to request and track environments on behalf of your project.

Once configured, TestChimp’s backend talks to Bunnyshell’s APIs to provision, poll status, surface logs/events when things go wrong, and destroy environments when workflows complete—so agents do not need direct Bunnyshell dashboard access to get a working URL.

How Claude + the TestChimp skill use it (MCP)

When a developer runs /testchimp test (or the agent chooses an ephemeral strategy from plans/knowledge/ai-test-instructions.md), the Claude host calls TestChimp through @testchimp/cli (MCP tools), not by inventing URLs:

1. The skill reads your environment strategy (local vs staging vs EaaS / Bunnyshell).
2. If Bunnyshell is configured for the project, the agent uses MCP tools such as provision_ephemeral_environment / provision_ephemeral_environment_and_wait, get_ephemeral_environment_status, and destroy_ephemeral_environment so TestChimp requests the environment from Bunnyshell and waits until it is ready.
3. TestChimp returns the environment URL (and related metadata) so the agent can set BASE_URL / BACKEND_URL (per your repo conventions) and run Playwright against that stack.
4. If something fails, MCP helpers like list_bunnyshell_environment_events and get_bunnyshell_workflow_job_logs support debugging provisioning from the agent session.

If Bunnyshell is not configured, those MCP paths are unavailable for automatic provisioning; the skill falls back to whatever strategy you recorded (for example persistent staging or branch preview URLs).

Practical notes

• Branch / commit: Ephemeral builds usually track Git state; ensure seed endpoints, migrations, and feature flags you expect are on the branch Bunnyshell builds from (the skill’s init docs call this out for backend changes).
• Secrets: API keys for TestChimp and for your app under test should follow your normal CI and MCP hygiene—see /testchimp init.

See also

• /testchimp init — Persisting environment provision strategy in ai-test-instructions.md.
• /testchimp test — Provision in Setup, destroy in Cleanup.
• Git integration — Repo + two-folder mapping required before environments and sync behave consistently.

External reference: Bunnyshell (vendor site).