Journey Ai
Handles the AI configuration stage of the Butterbase journey by setting up your AI gateway defaults and optional bring-your-own-key setup. It reads your plan from 02-plan.md, delegates the actual work to the ai skill, then smoke-tests the gateway with a quick chat call to make sure everything responds. Gets skipped entirely if your project doesn't use LLMs or embeddings. The flow is pretty rigid,it wants confirmation before proceeding, ticks boxes in state files, and logs to 04-build-log.md,so it's really meant to be called by the journey orchestrator rather than invoked directly. One nice touch: it won't let you pick a model that isn't in the manage_ai list.
- GitHub stars
- 532
- last updated
- Jun 11, 2026
Install
$ npx -y skills add butterbase-ai/butterbase-skills --skill journey-ai --agent claude-codeInstalls into .claude/skills of the current project.
Files
Journey: AI
Stage 3f of the guided journey. Configure AI gateway defaults (model, BYOK).
When to use
- Dispatched by
journeywhencurrent_stage: ai. - Directly via
/butterbase-skills:journey-ai. - Skipped (annotated
(n/a)) if the plan has no AI section.
Preflight
If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.
Inputs
docs/butterbase/02-plan.md— the AI section.docs/butterbase/00-state.md— forapp_id.
Procedure
- Refresh docs. Call
butterbase_docswithtopic: "ai". For BYOK and model lists, also WebFetchhttps://docs.butterbase.ai/ai. Skip if cache is fresh.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/butterbase-ai/butterbase-skills
- Categories
- DevOps & CI/CD, AI & Agent Building, Productivity & Planning
- License
- MIT
- First seen
- Jun 11, 2026
More from butterbase-ai/butterbase-skills
All 39- Journey Auth
- Journey Deploy
- Journey Docs
- Journey Durable
- Journey Frontend
- Journey Functions
- Journey Idea
- Journey Plan
- Journey Preflight
- Journey Rag
- Journey Realtime
- Journey Rls
- Journey Schema
- Journey Storage
- Journey Submit
- Journey Substrate
- Journey Templates
- Migrations
- Payments
- Rag Dev
- Realtime
- Schema Design
- Storage
- Substrate
Recommended
More DevOps & CI/CD
journey-authbutterbase-ai/butterbase-skillsUse as the auth build stage of the Butterbase journey, after journey-schema (and rls if separate). Implements the Auth section of 02-plan.md by delegating to au0skills.sh installsjourney-docsbutterbase-ai/butterbase-skillsUse as the docs-priming stage of the Butterbase journey, immediately after journey-preflight and before the first build stage. Reads the plan to discover which 0skills.sh installsjourney-ragbutterbase-ai/butterbase-skillsUse as the RAG build stage of the Butterbase journey. Implements the RAG section of 02-plan.md by delegating to rag-dev. Calls manage_rag_content (create_collec0skills.sh installsjourney-realtimebutterbase-ai/butterbase-skillsUse as the realtime build stage of the Butterbase journey. Implements the Realtime section of 02-plan.md by delegating to the realtime skill. Calls manage_realt0skills.sh installsjourney-schemabutterbase-ai/butterbase-skillsUse as the schema build stage of the Butterbase journey, after journey-plan and journey-preflight. Implements the Tables section of 02-plan.md by delegating to 0skills.sh installsjourney-storagebutterbase-ai/butterbase-skillsUse as the storage build stage of the Butterbase journey. Implements the Storage section of 02-plan.md by delegating to the storage skill. Calls manage_storage 0skills.sh installs