claude-q

Topic-based FIFO task queue for Claude Code. Queue work with `q put`, dequeue when context allows – nothing gets forgotten between sessions.

Introduction

Core concepts

Command-line usage

Hook installation

Hook behaviour

Configuration

Source

Source material

Contents

Introduction
- Introduction
Core concepts
- Core concepts
Command-line usage
- Command-line usage
Hook installation
Hook behaviour
- Hook behaviour
Configuration
- Configuration

Configuration

Updated Jan 30, 2026

The queue storage directory defaults to:

$Q_DIR when set
$XDG_STATE_HOME/q when set
~/.local/state/q otherwise

The --dir flag overrides the base directory for a single command.