aide

aide CLI - AI Agent Tools

A unified command-line tool designed for AI coding agents (like Claude Code) to interact with Jira, Azure DevOps, and GitHub APIs.

Installation

Option 1: Quick Install (Recommended)

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/rlcurrall/aide/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/rlcurrall/aide/main/install.ps1 | iex

Windows (Git Bash):

curl -fsSL https://raw.githubusercontent.com/rlcurrall/aide/main/install.sh | bash

The installation scripts will:

• Download the latest release for your platform
• Install to ~/.local/bin (Linux/macOS) or %LOCALAPPDATA%\Programs\aide (Windows)
• Add the installation directory to your PATH (Windows only)

Option 2: Manual Download

Download the pre-built binary for your platform from the releases page:

Linux:

curl -fsSL https://github.com/rlcurrall/aide/releases/latest/download/aide-linux -o aide
chmod +x aide
sudo mv aide /usr/local/bin/

macOS:

curl -fsSL https://github.com/rlcurrall/aide/releases/latest/download/aide-mac -o aide
chmod +x aide
sudo mv aide /usr/local/bin/

Windows (PowerShell):

Invoke-WebRequest -Uri "https://github.com/rlcurrall/aide/releases/latest/download/aide.exe" -OutFile "aide.exe"
# Move aide.exe to a directory in your PATH

Option 3: Build from Source

git clone https://github.com/rlcurrall/aide.git
cd aide
bun install
bun run build       # Current platform
# or
bun run build:win   # Windows
bun run build:linux # Linux
bun run build:mac   # macOS ARM
bun run build:all   # All platforms

Binaries are output to the dist/ directory.

Option 4: Run with Bun (Development)

bun run dev <command>

Quick Start

# Set up credentials (stores in OS keyring)
aide login jira     # prompts for Jira URL, email, API token
aide login ado      # prompts for Azure DevOps org URL and PAT
aide whoami         # show what's configured and where it came from

# Get help
aide --help
aide jira --help
aide pr --help

# Search Jira tickets
aide jira search "assignee = currentUser()"
aide jira view PROJ-123

# List pull requests
aide pr list --status active
aide pr comments --pr 24094 --latest 5

Command Structure

aide <service> <action> [options]

Services

Service	Description
jira	Jira ticket management
pr	Pull request management
plugin	Claude Code plugin manager
prime	Output aide context
upgrade	Upgrade aide to latest
login	Save credentials to keyring
logout	Remove stored credentials
whoami	Show credential sources

Jira Commands

Command	Description
aide jira search <jql>	Search tickets using JQL
aide jira view <key>	Get ticket details
aide jira create -p PROJ -t Task -s "..."	Create a ticket
aide jira update <key>	Update ticket fields
aide jira transition <key> <status>	Change workflow status
aide jira comment <key> <text>	Add comment to ticket
aide jira comments <key>	Get ticket comments
aide jira delete-comment <key> <id>	Delete a comment
aide jira edit-comment <key> <id> <text>	Edit a comment
aide jira attach <key>	Manage attachments
aide jira fields <project>	Discover available fields
aide jira boards <project>	List boards for a project
aide jira sprint <board-id>	Get sprint info for a board

Pull Request Commands

Command	Description
aide pr list	List pull requests
aide pr view [--pr ID]	View pull request details
aide pr diff [--pr ID]	View PR diff and changed files
aide pr create	Create a pull request
aide pr update [--pr ID]	Update a pull request
aide pr comments [--pr ID]	Get PR comments
aide pr comment <text> [--pr ID]	Post a comment on a PR
aide pr reply <thread> <text> [--pr ID]	Reply to a comment thread

Note: --pr flag is optional - aide auto-detects from current branch if omitted.