npx minionsai

npm install -g minionsai

minions

# Start the server
minions

# Check version
minions --version

# Compare with latest NPM version
npm view minionsai version

// Task metadata structure
interface Task {
  id: string;
  title: string;
  description: string;
  status: 'in_progress' | 'in_review' | 'done';
  sessionId: string; // Hermes session ID
  model?: string; // Override default model
  reasoningEffort?: number; // Override reasoning effort
  createdAt: string;
  updatedAt: string;
}

// Example: Task state transitions
// 1. User creates task → status: 'in_progress'
// 2. Agent completes work → status: 'in_review'
// 3. Human verifies → status: 'done'

// The completion judge runs after each agent turn
interface CompletionCheck {
  isComplete: boolean;
  reasoning: string;
  confidence: number;
}

# Start Minions
npx minionsai

# In the web UI:
# 1. Create new task: "Research top 10 AI tools launched this month"
# 2. Walk away - agent executes autonomously
# 3. Return later to review in "In Review" column
# 4. Verify and move to "Done"

// Each task is independent:
// - Separate Hermes session
// - Independent model/effort settings
// - Parallel execution supported

// Example workflow:
// Task 1: "Write blog post about TypeScript 5.4 features"
// Task 2: "Analyze competitor pricing pages"
// Task 3: "Generate test data for user onboarding flow"
// All run concurrently, visible on one board

# Set up daily routine:
# "Check GitHub stars and create summary report"

# Minions will:
# 1. Execute on schedule
# 2. Store execution history
# 3. Make output reviewable
# 4. Alert if intervention needed (roadmap feature)

// Minions doesn't replace Hermes CLI usage
// It complements it by providing:
// - Visual task organization
// - Persistent session management
// - Completion detection
// - Human review workflow

// You can still use Hermes directly:
hermes chat "quick question"

// Or use Minions for longer work:
// Create task in UI → Minions manages Hermes session

# Default port is 6969
# If occupied, check for existing Minions process:
lsof -i :6969
kill -9 <PID>

# Then restart
npx minionsai

# Database location
ls -la ~/.minions/

# Reset database (WARNING: deletes all tasks)
rm -rf ~/.minions/
npx minionsai  # Creates fresh database

# Verify Hermes installation
which hermes
hermes --version

# Check Hermes can start sessions
hermes chat "test"