Write your spec
Define features and scenarios in BDD.md using plain Gherkin syntax. This is the only file you edit.
poppins
You write the spec. The agent writes the code.
What is poppins?
Section titled “What is poppins?”poppins is a meta-framework — not a library you install, but a pattern you adopt. You bring your spec; poppins brings the agent, the loop, and the rules that keep it honest.
Agent builds it
An AI agent reads your spec, writes tests first, then writes the minimum code to make them pass.
Runs on autopilot
A GitHub Actions cron fires every 8 hours. The agent picks up uncovered scenarios and implements them.
Works with any language
TypeScript, Python, Rust, Go, Java — configure your toolchain in the BDD.md frontmatter.
Supported Providers
Section titled “Supported Providers”poppins auto-detects your AI provider from environment variables. Set one API key and run — no config needed.
| Provider | Environment Variable | Default Model |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY | claude-sonnet-4-5 |
| OpenAI | OPENAI_API_KEY | gpt-4o |
| Groq | GROQ_API_KEY | llama-3.3-70b-versatile |
| Alibaba / Qwen | DASHSCOPE_API_KEY | qwen-max |
| Moonshot / Kimi | MOONSHOT_API_KEY | moonshot-v1-8k |
| Ollama | OLLAMA_HOST | (pass --model) |