All notable changes to build-with-ai will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Discord Bot Workflow: Added comprehensive 12-step guided template (
templates/discord-bot.json). - History Inspection Command: Added
build-with-ai history [stepNumber]to inspect recorded step markdown files with ISO timestamps. - Status Metrics Dashboard: Enriched
build-with-ai statuswith Time Elapsed, Last Updated age, Decisions Count, and Export Readiness. - Export Enhancements: Added
--out-dir/-ocustom output directory support and--dry-runnon-destructive preview mode. - Template Discovery: Added
build-with-ai list --search <query>andlist --json. - Clipboard Controls: Added
--no-copyopt-out and non-interactivenext --raw/next --json.
- Atomic Persistence: Upgraded state and context persistence in
lib/state.jsto use atomic temp-file write and rename (writeJsonAtomic). - CI Reliability: Enhanced test runner to strictly exit with non-zero status code on E2E assertion failures.
- License: Updated project licensing to Apache License 2.0.
- Standardized project licensing under Apache License 2.0.
- Redesigned documentation and repository URLs to align with PicadoLabs ecosystem.
- Normalized repository line endings via
.gitattributes. - Verified and updated documentation assets for open-source registry readiness.
- New CLI Commands:
build-with-ai context [key]: Inspect all recorded decisions or look up a specific dot-notation key.build-with-ai set <key> <value>: Modify any decision directly incontext.jsonon the fly.build-with-ai jump [stepNumber]: Jump directly to any step number with an interactive step picker fallback.build-with-ai next --raw: Output only the prompt string for piping directly into other CLI utilities or scripts.build-with-ai next --json: Output structured JSON data of the active step.
- Enhanced Step Banners:
- Added
PHASE,RECOMMENDED AI, andTARGET FILESfields to step displays for clearer developer guidance.
- Added
- Custom Template Loading:
- Added
--template <path-or-url>flag toinitcommand, supporting local.jsonfiles and remote HTTPS URLs.
- Added
- 5 New Workflow Templates:
saas-mvp.json(15 steps): Modern SaaS with Next.js 14, Supabase, Stripe, and Resend.mobile-app.json(15 steps): Cross-platform mobile development with React Native, Expo Router, and EAS Build.flutter-app.json(16 steps): Cross-platform mobile development with Flutter, Dart, and Supabase/Firebase.chrome-extension.json(12 steps): Browser extensions using Manifest V3, Vite, and React.ai-agent.json(14 steps): AI Agent & RAG Pipeline with LangChain, vector databases, and FastAPI/Express.
- Open Source Governance:
- Added GitHub Actions CI multi-OS testing matrix (
ubuntu,macos,windows). - Added issue templates, PR template, Dependabot, Code of Conduct, and Security policy.
- Added GitHub Actions CI multi-OS testing matrix (
- Upgraded root interactive menu to include
contextandjumpquick actions. - Enriched
web-app.json(23 steps) andrest-api.json(10 steps) withtargetFilesandrecommendedAImetadata.
- Packaging and documentation polish for npm publication readiness.
- Fixed clipboard fallback handler to support both ESM and CommonJS exports.
- Stripped extraneous logging and emojis for cleaner terminal display.
- Initial release of
build-with-ai. - Zero-API, local-first workflow engine.
- 10 core commands:
init,next,done,back,status,resume,export,list,reset, and root interactive launcher. - Automatic context injection with dot-notation placeholders (
{{decisions.database}}). - Full-Stack Web App (
web-app.json) and Backend REST API (rest-api.json) templates. - Markdown documentation generator (
exportforREADME.md,BUILD_LOG.md,CONTEXT.md).