Skip to content

Getting Started

Prerequisites

Installation

1. Clone the Repository

git clone https://github.com/ElectricJack/agent-queue.git
cd agent-queue

2. Run the Setup Wizard

The interactive setup wizard will walk you through configuration:

./setup.sh

This creates a configuration file at ~/.agent-queue/config.yaml with your Discord bot token, guild ID, and project settings.

3. Start the Daemon

./run.sh start

Other useful commands:

./run.sh status   # check if the daemon is running
./run.sh logs     # tail the daemon log
./run.sh stop     # stop the daemon
./run.sh restart  # restart the daemon

Configuration

Agent Queue uses a YAML configuration file. The setup wizard creates this for you, but you can also edit it manually. See the Configuration Spec for full details.

Key configuration sections:

  • discord — Bot token, guild ID, channel names
  • agents_default — Heartbeat intervals, timeouts
  • scheduling — Rolling window, token budgets
  • projects — Your project definitions with workspace paths and repo settings

First Steps

Once the daemon is running and connected to Discord:

  1. Add a project — Tell the bot about your project in the Discord channel
  2. Create a task — Describe what you want done in natural language
  3. Watch it work — The bot creates a thread and streams agent progress
  4. Review the PR — When the task completes, review the generated pull request

For a complete reference of all available commands, see the Discord Commands Guide.