Documentation Index
Fetch the complete documentation index at: https://nikcli.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Agent Commands
NikCLI provides powerful AI agent management capabilities for autonomous task execution. These commands allow you to list, configure, and execute tasks with specialized AI agents.
Core Agent Commands
/agents
List all available AI agents with their capabilities and status.
Syntax:
Output includes:
- Agent name and type
- Specialization areas
- Current status (available/busy)
- Performance metrics
- Last used timestamp
Example:
Sample Output:
🤖 Available AI Agents:
┌─────────────────┬──────────────┬────────────┬─────────────┐
│ Agent │ Type │ Status │ Specializes │
├─────────────────┼──────────────┼────────────┼─────────────┤
│ backend-expert │ Specialized │ Available │ APIs, DBs │
│ frontend-expert │ Specialized │ Available │ React, UI │
│ devops-expert │ Specialized │ Busy │ CI/CD, K8s │
│ universal-agent │ Universal │ Available │ General │
│ autonomous-coder│ Autonomous │ Available │ Full-stack │
└─────────────────┴──────────────┴────────────┴─────────────┘
/agent [name] [task]
Execute a specific task using a named agent.
Syntax:
/agent <agent-name> "<task-description>"
agent-name - Name of the agent to usetask-description - Detailed description of the task
Available Agents:
backend-expert - Backend development, APIs, databasesfrontend-expert - Frontend development, React, UI/UXdevops-expert - DevOps, CI/CD, containerizationcode-review - Code review and quality analysissystem-admin - System administration and configurationuniversal-agent - General-purpose agentautonomous-coder - Fully autonomous coding
Examples:
# Backend development
/agent backend-expert "Create a REST API for user authentication with JWT tokens"
# Frontend development
/agent frontend-expert "Build a responsive dashboard with charts using React and Tailwind"
# DevOps tasks
/agent devops-expert "Set up CI/CD pipeline with GitHub Actions and Docker"
# Code review
/agent code-review "Review the authentication module for security issues"
# System administration
/agent system-admin "Configure nginx reverse proxy with SSL certificates"
# General tasks
/agent universal-agent "Analyze this codebase and suggest improvements"
/auto [task]
Execute a task with full autonomous mode - the system selects the best agent and approach.
Syntax:
/auto "<task-description>"
- Automatic agent selection
- Multi-step task breakdown
- Progress monitoring
- Error recovery
- Resource optimization
Examples:
# Full application development
/auto "Build a todo app with React frontend and Node.js backend"
# Complex refactoring
/auto "Migrate this Express app to use TypeScript with proper types"
# Infrastructure setup
/auto "Deploy this application to AWS with proper monitoring and scaling"
# Bug investigation
/auto "Find and fix the memory leak in the user service"
# Performance optimization
/auto "Optimize this React app for better performance and SEO"
/parallel [tasks]
Execute multiple tasks in parallel using different agents.
Syntax:
/parallel "<task1>" "<task2>" "<task3>"
- Concurrent execution
- Resource management
- Progress tracking
- Dependency handling
- Result aggregation
Examples:
# Development workflow
/parallel "Run tests" "Build production bundle" "Update documentation"
# Code quality
/parallel "Run linter" "Check security vulnerabilities" "Analyze performance"
# Deployment tasks
/parallel "Build Docker image" "Update Kubernetes manifests" "Run integration tests"
# Multi-service development
/parallel "Update user service API" "Update frontend components" "Update database schema"
Agent Factory Commands
/factory
Show the agent factory status and available agent templates.
Syntax:
Output includes:
- Available agent templates
- Custom agent definitions
- Factory configuration
- Resource usage
- Creation history
/create-agent [specification]
Create a custom agent with specific capabilities.
Syntax:
/create-agent <agent-spec>
frontend - Frontend-focused agentbackend - Backend-focused agentfullstack - Full-stack development agentmobile - Mobile development agentdata - Data analysis and ML agentsecurity - Security-focused agentcustom - Interactive custom agent creation
Examples:
# Create frontend specialist
/create-agent frontend
# Create backend specialist
/create-agent backend
# Create custom agent interactively
/create-agent custom
- Agent name and description
- Specialization areas
- Tool access permissions
- Resource limits
- Behavioral parameters
/launch-agent [name]
Launch a previously created custom agent.
Syntax:
/launch-agent <agent-name>
# Launch custom agent
/launch-agent my-react-expert
# Launch with specific task
/launch-agent my-backend-agent "optimize database queries"
Advanced Agent Features
Agent Streaming
Real-time output streaming from agent execution:
# Enable streaming for agent commands
/stream enable
# Execute with streaming
/agent backend-expert "create API endpoints"
# Output streams in real-time as agent works
Agent Context
Agents maintain context across interactions:
# Set context for subsequent agent calls
/context set "working on e-commerce project with React and Node.js"
# Agent calls will use this context
/agent frontend-expert "add shopping cart functionality"
Agent Memory
Agents can remember information across sessions:
# Agent learns from interactions
/agent backend-expert "create user model with validation"
# Later, agent remembers previous work
/agent backend-expert "add authentication to the user model"
Agent Configuration
Model Selection
Configure which AI model agents use:
# Set model for all agents
/model claude-3-5-sonnet
# Set model for specific agent type
/router set backend-expert gpt-4
# View current model configuration
/router status
Agent Permissions
Configure what agents can access:
# Security settings
/security agent-permissions
# Enable/disable specific capabilities
/dev-mode enable # Allows broader access
/safe-mode # Restricts agent capabilities
Resource Limits
Set limits on agent resource usage:
# Configure in system settings
/system agent-limits
# View current limits
/stats agents
Agent Workflows
Development Workflow
# 1. Plan the work
/plan "implement user authentication system"
# 2. Execute with appropriate agent
/agent backend-expert "create JWT authentication middleware"
# 3. Test and validate
/agent code-review "review authentication implementation"
# 4. Deploy
/agent devops-expert "deploy authentication service"
Code Review Workflow
# 1. Analyze current code
/agent code-review "analyze codebase for issues"
# 2. Get specific recommendations
/agent code-review "suggest performance improvements"
# 3. Implement fixes
/auto "implement the suggested performance improvements"
# 4. Validate changes
/agent code-review "verify performance improvements"
Multi-Agent Collaboration
# 1. Parallel development
/parallel "backend API development" "frontend component creation" "database schema design"
# 2. Integration
/agent universal-agent "integrate frontend with backend API"
# 3. Testing
/parallel "unit tests" "integration tests" "e2e tests"
# 4. Deployment
/agent devops-expert "deploy integrated application"
Agent Troubleshooting
Common Issues
Agent not responding:
# Check agent status
/agents
# Restart agent system
/factory reset
# Check system resources
/debug agents
# Check model configuration
/model
# Verify API keys
/config
# Check resource limits
/system limits
# View detailed logs
/debug agent-logs
# Check permissions
/security status
# Verify tool access
/tools status
Debug Commands
# Show agent debug information
/debug agents
# Show agent execution logs
/debug agent-logs [agent-name]
# Show agent performance metrics
/stats agents
# Test agent connectivity
/diagnostic agents
Best Practices
Task Description
Write clear, specific task descriptions:
# ✅ Good: Specific and actionable
/agent backend-expert "Create a REST API endpoint for user registration that validates email format, checks for duplicate emails, hashes passwords with bcrypt, and returns JWT tokens"
# ❌ Bad: Vague and unclear
/agent backend-expert "make user stuff work"
Agent Selection
Choose the right agent for the task:
# ✅ Use specialized agents for their expertise
/agent frontend-expert "optimize React component rendering"
/agent devops-expert "configure Kubernetes ingress"
/agent security-expert "audit authentication flow"
# ✅ Use universal agent for general tasks
/agent universal-agent "analyze project structure"
# ✅ Use autonomous mode for complex multi-step tasks
/auto "build complete user management system"
Resource Management
Monitor and manage agent resource usage:
# Check current usage
/stats agents
# Set appropriate limits
/system agent-limits
# Use parallel execution efficiently
/parallel "quick task 1" "quick task 2" # Good
# Avoid: /parallel "long task 1" "long task 2" "long task 3" # May overwhelm system
Error Handling
Handle agent errors gracefully:
# If agent fails, try different approach
/agent backend-expert "create API" # If this fails
/auto "create API" # Try autonomous mode
/agent universal-agent "create API" # Or use universal agent
Integration Examples
CI/CD Integration
# In CI pipeline
/agent code-review "analyze pull request changes"
/parallel "run tests" "check security" "validate performance"
/agent devops-expert "deploy if all checks pass"
Development Environment
# Daily development workflow
/agent universal-agent "analyze today's tasks from project board"
/auto "implement highest priority feature"
/agent code-review "review completed work"
/agent devops-expert "deploy to staging environment"
Code Maintenance
# Regular maintenance
/agent code-review "identify technical debt"
/agent backend-expert "optimize database queries"
/agent frontend-expert "update dependencies and fix deprecations"
/parallel "update documentation" "run security audit" "performance testing"
