lp-api

A command-line tool written in Go for interacting with the Launchpad API at https://api.launchpad.net/devel.html

This project includes an Agent Skill that enables AI coding agents to work with Canonical's Launchpad platform for Ubuntu/Debian development, bug tracking, and build management.

Quick Examples

Query resources:

• lp-api get people/+me - Get your own account on Launchpad
• lp-api get bugs/1 - Get bug #1 on Launchpad
• lp-api get ubuntu ws.op==searchTasks tags==focal tags==jammy tags_combinator==All ws.show==total_size - Get the bug count for ubuntu project with both focal and jammy tags

Modify resources:

• lp-api patch bugs/123456 tags:='["focal","jammy"]' - Update bug tags
• lp-api patch bugs/123456 description:='"Updated description"' - Modify bug description

Add comments:

• lp-api post bugs/123456 ws.op=newMessage subject="Update" content="Status update" - Add comment to bug
• lp-api post ~owner/project/+git/repo/+merge/123 ws.op=createComment subject="Review feedback" content="Detailed review comments..." - Add comment to merge proposal

File uploads:

• lp-api post bugs/123456 ws.op=addAttachment attachment=@error.log comment="Production error log" - Attach log file to bug (comment is required)
• lp-api post bugs/123456 ws.op=addAttachment attachment=@screenshot.png comment="UI bug" description="Screenshot showing the issue" - Attach image with description
• lp-api post bugs/123456 ws.op=addAttachment attachment=@fix.patch comment="Proposed fix" is_patch=true - Attach patch file

Download builds:

• BUILD=$(lp-api get ~ubuntu-cdimage/+livefs/ubuntu/jammy/ubuntu | lp-api .builds_collection_link | jq -r '.entries | .[0] | .web_link'); echo $BUILD - Get the latest build for Ubuntu jammy
• while read -r LINK; do lp-api download "$LINK"; done < <(lp-api get "~${BUILD//*~/}" ws.op==getFileUrls | jq -r .[]) - Download all artifacts from the latest build

Install

Download the prebuilt binary for your platform from the GitHub releases page and place it in your PATH.

Alternatively, you can install using Go:

go install github.com/fourdollars/lp-api@latest

Documentation

For End Users

• See the Quick Examples above for common use cases
• Run lp-api -help for command-line options

For AI Coding Agents

This repository includes a comprehensive Agent Skill at launchpad/SKILL.md that provides:

• Detailed API usage patterns and workflows
• Authentication setup and troubleshooting
• Helper functions for common Launchpad operations
• Best practices for bug tracking, package management, and build automation

The skill enables AI agents to work effectively with Canonical's Launchpad platform for Ubuntu/Debian development tasks.

Using the skill:

• Compatible with OpenCode, Claude Desktop, Cline, and other skills-compatible AI agents
• See the full documentation in launchpad/SKILL.md