CLI Referenceaerostack ai / index

aerostack ai / index

AI-powered commands that use your project’s knowledge graph to provide context-aware assistance.

aerostack index

Build the Project Knowledge Graph (PKG) for your project. This indexes your codebase’s symbols, routes, schemas, and relationships so the AI agent understands your specific setup.

aerostack index

Run this before using aerostack ai or aerostack auth doctor.


aerostack ai

Ask the AI agent a question with full project context.

aerostack ai [prompt] [flags]
FlagDescription
--debugEnable debug logging
# Ask a question
aerostack ai "Why is my auth route returning 401?"
 
# Debug mode
aerostack ai "Trace the request flow for POST /api/users" --debug

The agent uses your PKG to understand your project structure, so answers are specific to your codebase — not generic documentation responses.

💡

Run aerostack index first. Without it, the agent lacks project context.


aerostack auth doctor

Analyze your authentication configuration and diagnose issues.

aerostack auth doctor

Checks:

  • Auth route configuration
  • OTP and magic link setup
  • JWT secret and expiry settings
  • Email provider configuration

Typical workflow

# 1. Index your project (do this after major changes)
aerostack index
 
# 2. Ask the agent
aerostack ai "How do I add rate limiting to my auth routes?"
 
# 3. If auth issues arise
aerostack auth doctor