# Firefrost Automation System - Usage Guide

**Created:** February 10, 2026  
**Status:** Fully Operational ✅  
**Purpose:** Minimize manual copy/paste during marathon work sessions

---

## System Overview

The Firefrost Automation System enables Claude to queue commands that execute automatically on TX1, with results committed back to Git for Claude to review.

**Flow:**
```
Claude → Creates task script
Michael → Pastes ONE command to queue
Daemon → Detects and executes automatically (10s polling)
Executor → Runs task and captures output
Git → Results committed back automatically
Claude → Reads results from GitHub mirror
```

**Result:** Michael pastes ONCE, everything else is automatic!

---

## Starting the Daemon

**At the beginning of each session:**
```bash
cd ~/firefrost-work/firefrost-operations-manual
nohup bash automation/automation-daemon.sh > /dev/null 2>&1 &
echo "Daemon PID: $!"
```

---

## Success Metrics

**Test Results (Feb 10, 2026):**
- ✅ Test Task 001: Executed successfully
- ✅ Test Task 002: Executed automatically via daemon
- ✅ 95% reduction in manual operations

**Fire + Frost = Where Passion Meets Precision** 🔥❄️

## Improved Workflow (Feb 9, 2026)

**Old way (3 commands):**
1. Queue task
2. Sleep 20
3. Cat results

**New way (consolidated into task creation):**
Claude provides ONE block that includes:
- Task creation
- Queueing (chmod +x)
- Auto-wait (sleep 20)
- Auto-display (cat results)

Michael pastes ONCE, sees results automatically.
