Skip to content

Releases: carmandale/agent-os

v2.2.0 - Background Task Management

10 Aug 23:42

Choose a tag to compare

🚀 Background Task Management Release

This release implements Claude Code's new background execution capabilities, enabling non-blocking development workflows in Agent OS.

✨ Key Features

Background Task Management

  • aos-background tool for managing long-running processes
  • Task registry with JSON storage for persistent tracking
  • Process monitoring with PID tracking and automatic cleanup
  • Log management system with search and tail capabilities
  • Debug helper for troubleshooting failed tasks

Unified CLI (aos v4)

  • Single aos command for all Agent OS operations
  • Integrated background task commands (aos run, aos tasks, aos monitor)
  • Background task status in comprehensive reports
  • Maintains all v3 features and improvements

📚 Documentation

  • Complete background task specification document
  • Planning for enhanced hooks and async workflows
  • Updated workflow modules for non-blocking operations

🔧 Usage Examples

# Run dev server in background
aos run 'npm run dev'

# List all running tasks
aos tasks

# Monitor task output
aos monitor task-20250110-143022-a1b2c3

# View task logs
aos logs task-20250110-143022-a1b2c3

# Stop a task
aos stop task-20250110-143022-a1b2c3

# Debug failed tasks
aos debug

🎯 Benefits

  • Non-blocking development: Keep working while builds/tests run
  • Better visibility: Monitor all running processes from one place
  • Faster iteration: Immediate feedback from background tasks
  • Automatic debugging: Detect and troubleshoot errors in logs

📝 Full Changelog

See CHANGELOG.md for complete details.

Agent OS v2.1.0 - Enhanced Project Validation

10 Aug 23:02

Choose a tag to compare

🎯 Highlights

The aos alias now provides comprehensive validation of both your global Agent OS installation AND project-specific setup, making it easier to identify and fix issues.

📦 What's New

aos v3 Improvements

  • Separate Status Tracking: Distinguishes between global installation and project setup
  • Outdated Component Detection: Identifies when Claude commands, Cursor rules, or hooks need updating
  • Actionable Reports: Shows exactly what needs fixing with specific commands
  • Smart Validation: Checks hook versions, command counts, and file freshness

🔄 Update Instructions

# Update Agent OS
curl -sSL https://raw.githubusercontent.com/carmandale/agent-os/main/setup.sh | bash

# Reinstall aos alias for v3 features
curl -sSL https://raw.githubusercontent.com/carmandale/agent-os/main/tools/install-aos-alias.sh | bash
source ~/.zshrc  # or ~/.bashrc

# Check comprehensive status
aos status

Example Output

The new aos status command shows:

  • ✅ Global installation status and version
  • ✅ Project setup validation
  • ⚠️ Specific issues that need attention
  • ⚡ Quick actions to fix any problems

See CHANGELOG.md for complete details.

Agent OS v2.0.0 - Major Workflow Improvements

10 Aug 14:49

Choose a tag to compare

🎯 Highlights

This major release brings significant improvements to workflow enforcement, update management, and overall user experience.

📦 What's New

  • Workflow Enforcement Hooks v2 & v3: Smarter handling of compound commands
  • Smart aos Alias v2: Streamlined setup with intelligent updates
  • Version Tracking: Proper semantic versioning
  • Documentation: Update guides and release process

🔄 Update Instructions

For Existing Users

curl -sSL https://raw.githubusercontent.com/carmandale/agent-os/main/setup.sh | bash
# Or: aos update

For New Users

curl -sSL https://raw.githubusercontent.com/carmandale/agent-os/main/setup.sh | bash

See CHANGELOG.md for complete details.