bot-bottle/examples/bottles/dev.md at 480269b116b49e9cb8df8f5bb5e7973afdb3a132

didericis/bot-bottle

Fork 0

Files

T

didericis c07ebca867

lint / lint (push) Successful in 1m54s

Details

test / unit (pull_request) Successful in 58s

Details

test / integration (pull_request) Successful in 18s

Details

test / coverage (pull_request) Failing after 1m3s

Details

feat(backend): remove smolmachines; firecracker is the Linux default

Delete the smolmachines backend (the whole bot_bottle/backend/smolmachines
package and its tests). It had fatal Linux issues (TSI networking under
sustained use, exec-channel contention, no SIGWINCH) and is superseded by
the Firecracker backend (issue #342).

Backend selection now:
- default is macos-container on macOS, firecracker on KVM-capable Linux
  hosts, and docker as the last resort (was smolmachines).
- firecracker is selected on a KVM host even when the `firecracker`
  binary isn't installed, so start routes through its preflight and
  prints an install pointer (same UX as require_container), instead of
  silently falling back. Split is_host_capable() (Linux + KVM) out of
  is_available() (adds the binary check) to drive this.

Retarget the cross-backend tests (parity, print-parity, prepare,
workspace, freezer, selection) from smolmachines to firecracker rather
than dropping the coverage. Remove docker.util.image_id/save, which only
smolmachines used. Update README/AGENTS/example bottles and stale
comments; historical docs/prds are left as a point-in-time record.

BREAKING: BOT_BOTTLE_BACKEND=smolmachines now errors as unknown.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WBMWTEtQdJ4W5UrWuLHCck

2026-07-11 13:24:47 -04:00

457 B

Raw Blame History

extends, env

extends

env

claude

GIT_AUTHOR_NAME	NODE_ENV
Eric Diderich	development

The dev bottle — backs a generic development workflow.

Inherits the Claude provider boundary from claude. Drop this file into ~/.bot-bottle/bottles/dev.md and any agent referencing bottle: dev will launch against this infrastructure. By default, bot-bottle runs this bottle on the host's default backend (Firecracker on KVM Linux, Apple Container on macOS).

457 B Raw Blame History

457 B

Raw Blame History