Agent Commands

Invoke and manage specialized AI agents from the command line.

Synopsis#

bootspring agent <command> [options]

Commands#

CommandDescription
listList available agents
invoke <name>Invoke an agent with a task
info <name>Get agent details

bootspring agent list#

List all available agents.

Usage#

bootspring agent list [options]

Options#

OptionDescription
--tier <tier>Filter by tier (free, pro, team)
--category <cat>Filter by category
--jsonOutput as JSON

Examples#

# List all agents bootspring agent list

Output:

Technical Agents (12) ├── frontend-expert React, Next.js, CSS, accessibility ├── backend-expert Node.js, APIs, server logic ├── database-expert SQL, Prisma, schema design ├── api-expert REST, GraphQL, OpenAPI ├── testing-expert Vitest, Jest, Playwright ├── security-expert OWASP, auth, encryption ├── performance-expert Caching, optimization ├── devops-expert CI/CD, Docker, Kubernetes ├── ui-ux-expert Design systems, a11y ├── architecture-expert System design, patterns ├── code-review-expert Best practices, quality └── vercel-expert Vercel, Edge functions Platform Agents (9) ├── auth-expert Clerk, NextAuth, Auth0 ├── payment-expert Stripe, subscriptions ├── email-expert Resend, templates └── ... (6 more) Business Agents (12) [Pro] ├── business-strategy-expert ├── growth-expert └── ... (10 more) Enterprise Agents (3) [Team] ├── investor-relations-expert ├── partnerships-expert └── private-equity-expert
1# List only free tier agents 2bootspring agent list --tier free 3 4# List technical agents only 5bootspring agent list --category technical 6 7# Output as JSON 8bootspring agent list --json

bootspring agent invoke#

Invoke an agent with a specific task.

Usage#

bootspring agent invoke <name> "<task>" [options]

Options#

OptionDescription
--context <text>Additional context
--output <format>Output format: guidance, code, review, plan
--verboseShow detailed response
--jsonOutput as JSON
--file <path>Read task from file

Examples#

# Basic invocation bootspring agent invoke frontend-expert "Create a responsive sidebar"

Output:

Frontend Expert Response ═══════════════════════════════════════════════════════════════════ Summary ─────── Here's how to create a responsive sidebar with proper accessibility and mobile support. Implementation ────────────── Step 1: Create the Sidebar component ```tsx // components/Sidebar.tsx 'use client'; import { useState } from 'react'; import { cn } from '@/lib/utils'; interface SidebarProps { children: React.ReactNode; } export function Sidebar({ children }: SidebarProps) { const [isOpen, setIsOpen] = useState(false); return ( <> {/* Mobile toggle */} <button onClick={() => setIsOpen(!isOpen)} className="lg:hidden fixed top-4 left-4 z-50" aria-label="Toggle sidebar" > <MenuIcon /> </button> {/* Sidebar */} <aside className={cn( "fixed inset-y-0 left-0 z-40 w-64 bg-white border-r", "transform transition-transform duration-200 ease-in-out", "lg:translate-x-0", isOpen ? "translate-x-0" : "-translate-x-full" )} > {children} </aside> {/* Overlay */} {isOpen && ( <div className="fixed inset-0 bg-black/50 lg:hidden z-30" onClick={() => setIsOpen(false)} /> )} </> ); }

Considerations ────────────── • Accessibility: Include ARIA labels for toggle button • Performance: Use CSS transitions over JS animations • Mobile: Consider swipe gestures for touch devices

```bash # With additional context bootspring agent invoke database-expert "Optimize this query" \ --context "Query takes 3 seconds for 1000 users" # Get code-only output bootspring agent invoke backend-expert "Create rate limiter" --output code # Get a review bootspring agent invoke security-expert "Review auth flow" --output review # Read task from file bootspring agent invoke architecture-expert --file requirements.md

bootspring agent info#

Get detailed information about an agent.

Usage#

bootspring agent info <name>

Example#

bootspring agent info frontend-expert

Output:

Frontend Expert ═══════════════════════════════════════════════════════════════════ Description ─────────── Expert in frontend development with deep knowledge of React, Next.js, CSS/Tailwind, and accessibility. Provides guidance on component design, styling, state management, and performance optimization. Expertise ───────── • React & Next.js (App Router, Server Components) • TypeScript • CSS & Tailwind CSS • Accessibility (WCAG 2.1) • Performance optimization • Component architecture • State management Best For ──────── • Building UI components • Styling and responsive design • Form handling and validation • Client-side state management • Accessibility improvements • Performance optimization Tier: Free Category: Technical Output Formats ────────────── • guidance - Explanations with code examples • code - Primarily code with comments • review - Structured assessment • plan - Step-by-step implementation plan Related Agents ────────────── • ui-ux-expert - Design systems and UX • testing-expert - Component testing • performance-expert - Performance tuning

Configuration#

Custom Agent Instructions#

Add project-specific instructions in bootspring.config.js:

1module.exports = { 2 agents: { 3 customInstructions: { 4 'frontend-expert': ` 5 - Always use TypeScript strict mode 6 - Prefer server components in Next.js 7 - Use Tailwind CSS, never inline styles 8 - Include proper ARIA attributes 9 `, 10 'database-expert': ` 11 - Use Prisma as the ORM 12 - Include indexes for foreign keys 13 - Use soft deletes for user data 14 `, 15 }, 16 }, 17};

Enable/Disable Agents#

1module.exports = { 2 agents: { 3 // Only enable specific agents 4 enabled: ['frontend-expert', 'backend-expert', 'database-expert'], 5 6 // Or disable specific ones 7 // disabled: ['mobile-expert'], 8 }, 9};

Tips#

Be Specific#

# Less effective bootspring agent invoke frontend-expert "Help with the form" # More effective bootspring agent invoke frontend-expert "Create a multi-step checkout form with React Hook Form, Zod validation, and proper error states"

Provide Context#

bootspring agent invoke database-expert "Design user schema" \ --context "Multi-tenant SaaS, users belong to organizations, need SSO support"

Chain Agents#

For complex tasks, use multiple agents:

1# 1. Plan the architecture 2bootspring agent invoke architecture-expert "Plan auth system" 3 4# 2. Design the database 5bootspring agent invoke database-expert "Design user and session schema" 6 7# 3. Implement 8bootspring agent invoke backend-expert "Implement auth endpoints" 9bootspring agent invoke frontend-expert "Build login form" 10 11# 4. Review 12bootspring agent invoke security-expert "Review auth implementation"