Metadata-Version: 2.4
Name: phabfive
Version: 0.9.0
Summary: CLI for Phabricator and Phorge - built for humans and AI agents
Project-URL: Homepage, https://github.com/dynamist/phabfive
Project-URL: Download, https://github.com/dynamist/phabfive/releases
Author-email: Rickard Eriksson <rickard@dynamist.se>
License: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: anyconfig>=0.10.0
Requires-Dist: appdirs
Requires-Dist: inquirerpy>=0.3.4
Requires-Dist: jinja2
Requires-Dist: mkdocs>=1.6.1
Requires-Dist: phabricator
Requires-Dist: pyyaml
Requires-Dist: rich>=13.0.0
Requires-Dist: ruamel-yaml>=0.18.16
Requires-Dist: typer[all]>=0.12.0
Provides-Extra: docs
Requires-Dist: mkdocs; extra == 'docs'
Provides-Extra: repl
Requires-Dist: ptpython; extra == 'repl'
Provides-Extra: test
Requires-Dist: coverage; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: ruff; extra == 'test'
Description-Content-Type: text/markdown

# phabfive

CLI for [Phabricator](https://www.phacility.com/phabricator/) and [Phorge](https://we.phorge.it/) - built for humans and AI agents.

![phabfive maniphest show](docs/maniphest-show.png)

## 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
- **Edit** - Unified editing with auto-detection, batch operations, and smart column/priority navigation

For complete documentation, see [Read the Docs](https://phabfive.readthedocs.io/).

## Installation

[uv](https://docs.astral.sh/uv/) is a fast Python package installer (10-100x faster than pip):

```bash
# 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](https://mise.jdx.dev/) the polyglot tool version manager:

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

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

## Quick Start

```bash
phabfive user setup
```

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

Then start using phabfive:

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

# Edit tasks with smart navigation
phabfive edit T123 --priority=raise --status=resolved
phabfive maniphest search --assigned=@me | phabfive edit --column=Done
```

## Shell Completion

Enable tab completion for bash, zsh, or fish:

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

After installation, restart your shell or source your profile.

<details>
<summary>Manual configuration (advanced)</summary>

**Environment variables:**

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

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

```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](https://pypi.org/project/pip-system-certs/) to use the Windows certificate store: `pip install pip-system-certs`

</details>

## Documentation

- **[Full CLI Reference](https://phabfive.readthedocs.io)** - Complete command documentation
- **[Development Guide](docs/development.md)** - Set up dev environment, run tests, local Phorge/Phabricator setup
- **[Release Process](docs/releasing.md)** - How to build and publish releases

## Contributing

See [docs/development.md](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.
