v0.1.4

Breaking Changes

• CLI renamed from atq to tq - The atq command conflicted with the Unix at(1) job scheduler. Update any scripts or aliases that used atq to use tq instead.

New Features

• tq run command - Execute commands through the same FIFO queue that AI agents use. This prevents resource contention when humans and agents run builds simultaneously.

  tq ./gradlew assembleDebug          # Run a build through the queue
  tq -q android ./gradlew test        # Use a specific queue
  tq -t 600 npm test                  # Custom timeout (seconds)
  tq -C /path/to/project make         # Set working directory

• Implicit run - tq echo hello works the same as tq run echo hello

• Rich terminal output - Passthrough mode preserves progress bars, colors, and interactive output from build tools

Improvements

• Database recovery - Automatically detects and recovers from corrupted SQLite databases
• Log rotation - Metrics log file rotates when exceeding 5MB to prevent unbounded disk growth
• Zombie cleanup metrics - Logs zombie_cleared events when cleaning up dead or stale tasks
• Graceful Ctrl+C handling - Clean process group termination without tracebacks

Testing

• Added comprehensive test suite for tq CLI (25 new tests)

v0.1.3

What's New

New Features

• atq CLI - Inspect the task queue from the command line
  • atq list - Show current queue status
  • atq logs - View recent task activity
  • atq clear - Clear stuck tasks

Documentation

• Improved agent configuration docs with compatibility table
• Added setup guides for Claude Code in examples/
• Clarified Bash allowed rules warning for Claude Code users

Install

uv tool install agent-task-queue

Or run one-off:

uvx --from agent-task-queue atq list

v0.1.2

---

Documentation improvements for timeout behavior.

Changes

• Clarify that timeout_seconds applies to execution time only, queue wait time does not count against the timeout
• Update tool docstring so agents understand this behavior

---

v0.1.1

---

Fixes uvx agent-task-queue installation.

Changes

• Add CLI entry point so uvx agent-task-queue works correctly
• Add author and license metadata to package

Installation

uvx agent-task-queue

---

v0.1.0

---

Initial Release

Agent Task Queue is an MCP server that prevents multiple AI agents from running expensive build operations concurrently.

Features

• FIFO task queuing - Serializes builds across all connected agents
• Multiple queue support - Isolate workloads with named queues
• No timeouts - MCP keeps connections alive indefinitely
• Zombie protection - Detects dead processes and clears stale locks
• Environment variables - Pass build-specific config via env_vars
• Configurable - CLI options for data directory, log rotation, timeouts

Installation

uvx agent-task-queue

Supported Agents

Works with any MCP-compatible tool: Claude Code, Claude Desktop, Cursor, VS Code/Copilot, Windsurf, Amp, Cline, Firebender, and others.

---