act — Template Management

The act command helps you discover, manage, and use the 200+ expert prompt templates that make AI responses more specialized and effective. Templates work globally across all profiles and can be customized to fit your specific needs.

Basic Usage

rawi act [options]

Quick Commands

# Browse all templates (interactive)
rawi act --list

# Browse only built-in templates
rawi act --built-in

# Browse only custom templates
rawi act --custom

# Show details of a specific template
rawi act --show code-reviewer

# Create a new custom template
rawi act --create

# Edit an existing custom template
rawi act --edit my-template

# Delete a custom template
rawi act --delete my-template

# Use a template with ask command (works with any profile)
rawi ask --act ethereum-developer "explain smart contracts"

Options

Option	Alias	Description
--list	-l	List all available act templates
--built-in	-b	List only built-in act templates
--custom	-c	List only custom act templates
--show <template>	-s	Show details of a specific act template
--create		Create a new custom act template
--edit <template>		Edit an existing custom act template
--delete <template>		Delete a custom act template

Template Management

Rawi now supports creating, editing, and managing your own custom templates alongside the 200+ built-in templates.

Creating Custom Templates

Create your own specialized templates for repeated tasks:

# Start interactive template creation
rawi act --create

The interactive creator will guide you through:

• Template ID: Unique identifier (e.g., my-code-reviewer)
• Label: Display name (e.g., My Code Reviewer)
• Category: Organizational category (e.g., Development)
• Description: Brief description of the template’s purpose
• Content: The template prompt with {userInput} placeholder

Editing Templates

Modify your custom templates:

# Edit a custom template
rawi act --edit my-template

Deleting Templates

Remove custom templates you no longer need:

# Delete a custom template
rawi act --delete my-template

Template Types

• Built-in Templates: 200+ expert-crafted templates (cannot be modified)
• Custom Templates: Your own templates (can be created, edited, and deleted)

Global Templates

Important: All templates (both built-in and custom) work globally across all profiles. You don’t need to specify --profile when using templates - they’re accessible from any profile context.

Template Categories

Rawi includes 200+ templates organized into these categories:

🛠️ Technical Support

• Code Review — Code analysis and optimization
• DevOps — Infrastructure and deployment assistance
• Troubleshooting — System and application debugging
• Database — SQL optimization and database management

📝 Content Creation

• Technical Writing — Documentation and guides
• API Documentation — Endpoint documentation
• Marketing — Copy and content strategy
• Educational — Learning materials and tutorials

� Security & Analysis

• Security Expert — Vulnerability analysis and auditing
• Penetration Testing — Security testing guidance
• Code Security — Secure coding practices

💼 Business & Strategy

• Business Analysis — Strategic planning and analysis
• Project Management — Planning and coordination
• Consulting — Expert advice and recommendations

🎨 Creative & Design

• UX Design — User experience guidance
• Creative Direction — Design and branding
• Content Strategy — Creative content planning

🌍 Languages & Communication

• Translation — Language translation and improvement
• Communication — Writing and speaking assistance
• Cultural — Cross-cultural communication

Popular Templates

Development Templates

code-reviewer

Purpose: Comprehensive code analysis and optimization

rawi ask --act code-reviewer "Review this function for performance issues"

ethereum-developer

Purpose: Smart contract development and security

rawi ask --act ethereum-developer "Explain smart contract security best practices"

linux-terminal

Purpose: Linux command line simulation and guidance

rawi ask --act linux-terminal "list files in home directory with details"

database-admin

Purpose: Database optimization and management

rawi ask --act database-admin "Optimize this SQL query for performance"

Security Templates

security-expert

Purpose: Security analysis and vulnerability assessment

rawi ask --act security-expert "Analyze this authentication code for vulnerabilities"

penetration-tester

Purpose: Security testing and assessment guidance

rawi ask --act penetration-tester "Assess web application security"

Documentation Templates

tech-writer

Purpose: Technical documentation creation

rawi ask --act tech-writer "Create documentation for this API endpoint"

api-documenter

Purpose: API documentation and examples

rawi ask --act api-documenter "Document these REST endpoints"

Analysis Templates

data-analyst

Purpose: Data analysis and insights

rawi ask --act data-analyst "Analyze trends in this sales data"

business-analyst

Purpose: Business analysis and strategy

rawi ask --act business-analyst "Analyze market opportunity for this product"

Using Templates

With the ask Command

The primary way to use templates is with the ask command:

# Basic template usage
rawi ask --act <template-id> "your question"

# Examples
rawi ask --act code-reviewer "Review this Python function"
rawi ask --act security-expert "Audit this authentication system"
rawi ask --act tech-writer "Document this API"

With File Input

Combine templates with file input for powerful analysis:

# Code review
cat server.js | rawi ask --act code-reviewer "Review for security and performance"

# API documentation
cat api-spec.json | rawi ask --act api-documenter "Create comprehensive docs"

# Security audit
cat auth.py | rawi ask --act security-expert "Analyze for vulnerabilities"

# Database optimization
cat queries.sql | rawi ask --act database-admin "Optimize these queries"

Global Templates

Templates work automatically across all profiles:

# Templates work with any profile - no --profile needed
rawi ask --act code-reviewer "Analyze architecture"

# Use local AI with global templates
rawi ask --act linux-terminal "ls -la"

# Custom templates work everywhere
rawi ask --act my-custom-template "Process this data"

Advanced Usage

When you run rawi act --show <template>, you’ll see:

• Template ID — Unique identifier for the template
• Label — Human-readable name
• Category — Organizational grouping
• Description — What the template does
• Content — The actual prompt content
• Type — Built-in or custom template

Template Best Practices

1. Use descriptive questions with templates for better results
2. Combine with file input for context-aware analysis
3. Create custom templates for recurring specialized tasks
4. Test templates with different types of content
5. Share useful templates with your team

• Description — What the template does
• Expertise Areas — Specific skills and knowledge
• Common Use Cases — Popular scenarios
• Example Prompts — Sample questions to ask

Combining with Other Features

# Use template with specific profile
rawi ask --profile work --act code-reviewer "Analyze this code"

# Use template in a session
rawi ask --act software-engineer --new-session "I'm building a microservices architecture"

# Chain with shell commands
cat app.py | rawi ask --act code-reviewer "Review this Python code"

Creating Custom Workflows

Templates work great in scripts and automation:

#!/bin/bash
# Code review script
for file in src/*.py; do
    echo "Reviewing $file..."
    cat "$file" | rawi ask --act code-reviewer "Review this code file"
done

Popular Template Combinations

Full Development Workflow

# Architecture planning
rawi ask --act software-engineer "Design a scalable user authentication system"

# Code review
rawi ask --act code-reviewer "Review this implementation"

# Documentation
rawi ask --act technical-writer "Document this API endpoint"

# Testing strategy
rawi ask --act qa-engineer "Create test cases for this feature"

Content Creation Pipeline

# Research
rawi ask --act researcher "Research best practices for REST API design"

# Writing
rawi ask --act technical-writer "Write a tutorial on JWT authentication"

# Review and polish
rawi ask --act proofreader "Improve the clarity of this documentation"

Tips

1. Explore Categories — Use --category to find templates for your field
2. Read Descriptions — Use --show to understand what each template offers
3. Experiment — Try different templates for the same question to get varied perspectives
4. Combine Expertise — Use multiple templates in sequence for comprehensive analysis
5. Save Favorites — Create aliases for your most-used templates