phabfive

CLI for Phabricator and Phorge - built for humans and AI agents.

Features

A summary of the currently supported features:

• Passphrase - Get specified secret
• Diffusion - List repositories, get branches, clone URIs, add repositories, manage URIs
• Paste - List, get, and add pastes
• User - Get information about the logged-in user
• Maniphest - Add comments, show task details, create tasks from templates

For complete documentation, see Read the Docs.

Installation

uv is a fast Python package installer (10-100x faster than pip):

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install from pypi.org
uv tool install phabfive

# Install from Github to get unreleased features and fixes
uv tool install git+https://github.com/dynamist/phabfive@master

If you prefer mise-en-place the polyglot tool version manager:

# Install mise if you haven't already
curl https://mise.run | sh

# Install from pypi.org
mise use --global --pin pipx:phabfive

Quick Start

phabfive user setup

The interactive setup wizard will guide you through connecting to your Phabricator/Phorge instance.

Then start using phabfive:

phabfive passphrase K123
phabfive paste list
phabfive maniphest search "migration tasks" --tag myproject
phabfive maniphest search --tag myproject --updated-after=1w

Shell Completion

Enable tab completion for bash, zsh, or fish:

phabfive --install-completion bash
phabfive --install-completion zsh
phabfive --install-completion fish

After installation, restart your shell or source your profile.

Manual configuration (advanced)

Environment variables:

export PHAB_TOKEN=cli-ABC123
export PHAB_URL=https://yourserver.com/api/

Or configuration file at ~/.config/phabfive.yaml:

PHAB_TOKEN: cli-ABC123
PHAB_URL: https://yourserver.com/api/

Other config file locations: ~/Library/Application Support/phabfive.yaml (macOS) or %LOCALAPPDATA%\phabfive\phabfive.yaml (Windows).

Windows SSL certificates: If you encounter certificate errors, install pip-system-certs to use the Windows certificate store: pip install pip-system-certs

Documentation

• Full CLI Reference - Complete command documentation
• Development Guide - Set up dev environment, run tests, local Phorge/Phabricator setup
• Release Process - How to build and publish releases

Contributing

See docs/development.md for instructions on setting up your development environment.

License

Copyright (c) 2017-2026 Dynamist AB

See the LICENSE file provided with the source distribution for full details.