Agent Commands
Invoke and manage specialized AI agents from the command line.
Synopsis#
bootspring agent <command> [options]Commands#
| Command | Description |
|---|---|
list | List 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#
| Option | Description |
|---|---|
--tier <tier> | Filter by tier (free, pro, team) |
--category <cat> | Filter by category |
--json | Output as JSON |
Examples#
# List all agents
bootspring agent listOutput:
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 --jsonbootspring agent invoke#
Invoke an agent with a specific task.
Usage#
bootspring agent invoke <name> "<task>" [options]Options#
| Option | Description |
|---|---|
--context <text> | Additional context |
--output <format> | Output format: guidance, code, review, plan |
--verbose | Show detailed response |
--json | Output 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-expertOutput:
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"Related#
- Agents Core Concept - Understanding agents
- Using Agents Guide - Getting started
- Agents Reference - Full agent documentation