Phabfive Documentation

Phabfive is a command line tool to interact with Phabricator/Phorge, providing a fast and efficient way to work with your Phabricator instance from the terminal.

Features

Phabfive currently supports the following Phabricator/Phorge applications:

  • Passphrase - Search, list, and retrieve secrets (passwords, tokens, SSH keys, notes)
  • Diffusion - List and show repositories, their branches and tags, clone URIs, add repositories, manage URIs and policies
  • Paste - List, get, and add code pastes
  • User - Get information about the logged-in user
  • Maniphest - Add comments, show task details, create tasks from templates, and search with advanced project filtering and transition filtering
  • Edit - Unified editing interface with auto-detection, batch operations, and smart column/priority navigation

Getting Started

Quick Installation

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

# Install phabfive
uv tool install phabfive

With mise instead:

# From pypi.org, needs a Python toolchain
mise use --global --pin pipx:phabfive

# Or the standalone executable, which bundles its own Python
mise use --global github:dynamist/phabfive

See the README for the standalone executables and the container image.

Basic Usage

# Get a secret from Passphrase (monogram shortcut)
phabfive K123

# Search and filter credentials
phabfive passphrase search "deploy"
phabfive passphrase search --type=password

# Show multiple secrets at once
phabfive passphrase show K1 K2 K3

# Pull one secret out of a structured record
phabfive --format=json passphrase show K4 | jq -r '.Credential.Secret'

# Search pastes
phabfive paste search "deploy"

# Search Maniphest tasks
phabfive maniphest search myproject

For detailed setup instructions, see the README.

Documentation Sections

CLI Reference

  • Edit CLI - Unified editing with auto-detection, batch operations, and smart navigation
  • Maniphest CLI - Complete guide to task management, including advanced transition filtering
  • Diffusion URIs - How a repository's URIs work: origin, I/O, display and disabled
  • Policies - Who can see, edit, push to or comment on repositories and tasks

Development

  • Development Guide - Set up your development environment, run tests, and contribute to phabfive
  • Phorge Setup - Instructions for setting up a local Phorge/Phabricator instance for testing

Releasing

Command Reference

For the complete CLI command reference and API documentation, explore the sections in the navigation menu.

Contributing

We welcome contributions! See the Development Guide for instructions on:

  • Setting up your development environment
  • Running tests
  • Code style and linting guidelines
  • Working with a local Phorge instance

Support

For bug reports and feature requests, please open an issue on GitHub.