Cli Commands

Complete reference for all Agentastic command-line interface commands.

Service Management

Start/Stop Service

# Start the Agentastic daemon
agentastic service start

# Start in unmanaged mode (foreground)
agentastic service start --unmanaged

# Stop the daemon
agentastic service stop

# Check service status
agentastic service status

# Restart the service
agentastic service restart

Task Scheduler Commands

Schedule Management

Add Tasks

# Add a one-time task
agentastic schedule add --prompt "Your prompt" --title "Task Name" --at "time"

# Add a recurring task with cron
agentastic schedule add --prompt "Your prompt" --title "Task Name" --cron "0 9 * * *"

# Examples
agentastic schedule add --prompt "Check emails" --title "Email Check" --at "5pm tomorrow"
agentastic schedule add --prompt "Daily standup" --title "Standup" --cron "0 9 * * MON-FRI"

List Tasks

# List all scheduled tasks
agentastic schedule list

# Output includes:
# - Task ID
# - Title
# - Next execution time
# - Status (active/disabled)

Task Status

# Get detailed status of a specific task
agentastic schedule status <task-id>

# Shows:
# - Full task configuration
# - Execution history
# - Next scheduled time

Enable/Disable Tasks

# Temporarily disable a task
agentastic schedule disable <task-id>

# Re-enable a disabled task
agentastic schedule enable <task-id>

Remove Tasks

# Permanently delete a task
agentastic schedule remove <task-id>

Run Tasks Immediately

# Run an existing scheduled task immediately (for testing)
agentastic schedule run <task-id>

# Run a one-off task without scheduling
agentastic schedule run --prompt "Your prompt" --title "Task Name"

# Short form
agentastic schedule run -p "Quick test prompt" -t "Test"

# Examples
agentastic schedule run abc-123-task-id
agentastic schedule run -p "Check my emails" -t "Email Check"
agentastic schedule run --prompt "Test: $(date)" --title "Time Test"

Configuration Commands

Path Information

# Show configuration directory
agentastic path config

# Show log file location
agentastic path logs

# Show all paths
agentastic path

Configuration Management

# Test configuration
agentastic test

# Reset to default configuration
agentastic reset --config

# Edit configuration
agentastic config edit

Logging and Debugging

View Logs

# Show live log output
agentastic log

# Follow log output (tail -f)
agentastic log --follow

# Show last N lines
agentastic log --lines 100

# Filter logs
agentastic log | grep "scheduler"

Debug Mode

# Run with debug output
DEBUG=true agentastic service start

# Verbose logging
agentastic --verbose service start

Launcher Commands

Open Launcher

# Open the AI launcher overlay
agentastic launcher

# Open with specific prompt
agentastic launcher --prompt "Your initial prompt"

# Open minimized
agentastic launcher --minimized

System Information

Version and Info

# Show version
agentastic --version

# Show detailed system information
agentastic info

# Check for updates
agentastic update --check

Import/Export

Backup Configuration

# Export all settings
agentastic export --output backup.yaml

# Export specific components
agentastic export --templates --output templates.yaml
agentastic export --memory --output memory.yaml

Restore Configuration

# Import settings
agentastic import backup.yaml

# Import with merge
agentastic import --merge templates.yaml

Advanced Options

Global Flags

# Specify config file
agentastic --config /path/to/config.yaml <command>

# Quiet mode (suppress output)
agentastic --quiet <command>

# JSON output format
agentastic --json <command>

Environment Variables

# Set custom config directory
AGENTASTIC_CONFIG_DIR=/custom/path agentastic service start

# Enable debug mode
DEBUG=true agentastic service start

# Set log level
LOG_LEVEL=debug agentastic service start

Task Scheduler Time Formats

Natural Language Examples

• "in 30 minutes"
• "tomorrow at 5pm"
• "next Monday at 9am"
• "December 25 at noon"
• "every weekday at 8am"

ISO 8601 Format

• "2024-12-25T10:00:00"
• "2024-12-25 10:00"

Cron Expression Format

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12 or JAN-DEC)
│ │ │ │ ┌───────────── day of week (0-7 or SUN-SAT)
│ │ │ │ │
* * * * *

Examples:

• 0 9 * * * - Daily at 9 AM
• */15 * * * * - Every 15 minutes
• 0 9 * * MON-FRI - Weekdays at 9 AM
• 0 0 1 * * - First of month at midnight

Exit Codes

Command Aliases

Some commands have shorter aliases:

# Service aliases
agentastic start    # Same as: service start
agentastic stop     # Same as: service stop
agentastic restart  # Same as: service restart

# Schedule aliases  
agentastic sched    # Same as: schedule

Platform-Specific Notes

macOS

• Service managed by launchd
• Logs in ~/Library/Logs/agentastic/
• Config in ~/Library/Application Support/agentastic/

Linux

• Service managed by systemd (if available)
• Logs in ~/.cache/agentastic/
• Config in ~/.config/agentastic/

Windows

• Service managed by Windows Service Manager
• Logs in %LOCALAPPDATA%\agentastic\logs\
• Config in %APPDATA%\agentastic\

Getting Help

# General help
agentastic --help

# Command-specific help
agentastic schedule --help
agentastic schedule add --help
agentastic service --help

# Show manual page (if available)
man agentastic