Download the PHP package jtsternberg/buddy-cli without Composer
On this page you can find all versions of the php package jtsternberg/buddy-cli. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jtsternberg/buddy-cli
More information about jtsternberg/buddy-cli
Files in jtsternberg/buddy-cli
Package buddy-cli
Short Description CLI tool for interacting with Buddy.works CI/CD pipelines
License MIT
Homepage https://github.com/jtsternberg/buddy-cli
Informations about the package buddy-cli
The (Un)official Buddy Works CLI
A PHP CLI tool for managing Buddy.works CI/CD pipelines from the command line. Run pipelines, inspect executions, view logs, manage variables, and export/import pipeline configurations as YAML—all without leaving your terminal.
Works great with LLM assistants for iterative debugging workflows. See Debugging Pipeline Executions for a real-world example.
[!NOTE] The official buddy-works/buddy-cli has been abandoned. This project provides a maintained alternative.
Installation
As a Project Dependency
The buddy command is available via vendor/bin/buddy.
Global Installation
Ensure ~/.composer/vendor/bin is in your PATH, then run buddy from anywhere.
From Source
This creates a symlink in ~/.local/bin/buddy (or similar) for pathless execution.
Shell Completion
Enable tab-completion for commands, options, and arguments. Supports bash, zsh, and fish.
Bash (~/.bashrc):
Zsh (~/.zshrc):
First generate the completion file:
Then add to ~/.zshrc (before compinit if you call it manually):
Fish (~/.config/fish/config.fish):
Authentication
Personal Access Token (Recommended)
Set the BUDDY_TOKEN environment variable, or run:
OAuth Login
1. Create OAuth Application
Create an OAuth app at buddy.works/api/apps.
For the callback URL, run buddy login --test to start the callback server and verify it works:
2. Configure Credentials & Login
Provide your OAuth client ID and secret via one of:
Then login:
Or pass directly to login command:
This opens your browser to authenticate with Buddy and saves your token automatically.
Configuration
Configuration can be set via environment variables, config files, or command-line flags.
Environment Variables
Config Files
- User config:
~/.config/buddy-cli/config.json - Project config:
.buddy-cli.json(in project root)
Precedence
- Command-line flags (
--workspace,--project) - Environment variables
- Project config (
.buddy-cli.json) - User config (
~/.config/buddy-cli/config.json)
Commands
[!TIP] Run
buddy <command> --helpfor detailed documentation including all options, supported fields, and examples.
Pipelines
Executions
Actions
Projects
Variables
Configuration
Documentation
- Ask questions in NotebookLM - Interactive Q&A about buddy-cli
- Debugging Pipeline Executions - Real-world walkthrough of diagnosing and fixing a failed pipeline run
Options
All commands support:
--workspace,-w- Workspace name--project,-p- Project name--json- Output as JSON
Claude Code Plugin
This repository includes a Claude Code plugin for AI-assisted CI/CD management. Control deployments and debug pipelines using natural language.
Quick Example
Installation
In Claude Code:
Or point to your existing copy of the buddy-cli repository:
Features
- Skills: Auto-invoked when discussing pipelines, deployments, or build failures
- Commands:
/buddy-cli:deploy,/buddy-cli:status,/buddy-cli:logs - Agent: CI/CD specialist for complex multi-step workflows
See claude-plugin/.claude-plugin/README.md for full documentation.
Development
This repository uses Beads for issue tracking—an AI-native system that stores issues directly in the repo. See .beads/README.md for details.
License
MIT
All versions of buddy-cli with dependencies
buddy-works/buddy-works-php-api Version ^1.4
symfony/console Version ^6.0|^7.0
symfony/yaml Version ^7.4
vlucas/phpdotenv Version ^5.6