bootspring_assist | Bootspring Docs

The primary natural language assistant tool that provides intelligent help with recommendations based on your project context.

Overview#

bootspring_assist is the main entry point for getting help from Bootspring. It analyzes your request, considers your project context, and provides tailored assistance with relevant recommendations for agents, skills, and workflows.

Parameters#

Parameter	Type	Required	Description
`query`	string	Yes	Your question or request
`context`	string	No	Additional context to consider
`includeRecommendations`	boolean	No	Include agent/skill recommendations (default: true)
`format`	string	No	Response format: "detailed", "concise", "code-only"
`mode`	string	No	Mode: "suggest" (default), "explain", "execute"

Usage Examples#

Basic Usage#

Use the bootspring_assist tool to help me understand how to structure my API routes.

With Additional Context#

Use bootspring_assist with query="How should I handle errors?" and
context="I'm building a REST API with Express and want consistent error responses"

Code-Only Response#

Use bootspring_assist with query="Create a rate limiter middleware" and format="code-only"

With Error Context#

Use bootspring_assist with query="This is failing" and
context="Error: PrismaClientKnownRequestError: Foreign key constraint failed"

Response Format#

High Confidence Response#

Loading code block...

Low Confidence Response#

When the request is ambiguous:

Loading code block...

Confidence Tiers#

Tier	Confidence	Behavior
High	80%+	Direct suggestion with specific tool call
Medium	50-80%	Multiple options offered
Low	30-50%	Asks for clarification, provides suggestions
Very Low	<30%	Shows capabilities and asks for more detail

Examples#

Getting Architecture Advice#

Request:

Use bootspring_assist to help me decide between server components
and client components for my dashboard.

Response:

Loading code block...

Error Inference#

When an error is provided, assist automatically recommends the right agent:

Error Contains	Suggested Agent
prisma, sql, database	database-expert
auth, token, permission	security-expert
react, component, render	frontend-expert
api, fetch, request	backend-expert
test, jest, vitest	testing-expert
deploy, build, ci	devops-expert

Project-Specific Help#

Request:

Use bootspring_assist to explain what changes I need to make
to add user roles to my application.

Response:

Loading code block...

Configuration#

Customize Recommendations#

Loading code block...

Context Preferences#

Loading code block...

Tips#

Be Specific#

Instead of:

Use bootspring_assist to help with the form

Try:

Use bootspring_assist to help me create a multi-step registration
form with email verification and progress indicator

Provide Context#

Include relevant details:

Use bootspring_assist with context="Using React Hook Form and Zod,
need to handle file uploads and validate image dimensions"

Request Specific Format#

For implementation:

Use bootspring_assist with format="code-only" to create an error boundary

For understanding:

Use bootspring_assist with format="detailed" to explain server actions

Error Handling#

Error	Cause	Solution
`CONTEXT_NOT_FOUND`	No CLAUDE.md file	Run `bootspring generate`
`QUERY_TOO_LONG`	Query exceeds limit	Shorten your query
`QUERY_REQUIRED`	No query provided	Include query parameter
`RATE_LIMITED`	Too many requests	Wait and retry

bootspring_agent - For specialized expert guidance
bootspring_skill - For code patterns
bootspring_context - For context queries
bootspring_orchestrator - For workflow automation