# hf - HarborForge CLI

`hf` is the Go-based CLI for HarborForge. It manages users, projects, tasks, milestones, meetings, support tickets, proposals, and server monitoring.

## Quick Start

```bash
# See all available commands (including those you may not have permission for)
hf --help

# See only the commands you're permitted to use
hf --help-brief

# Check API health
hf health

# Show CLI version
hf version
```

## Configuration

```bash
# Set the HarborForge API URL
hf config --url https://your-harborforge.example.com

# View current config
hf config
```

## Usage Tips

- Use `hf --help-brief` to quickly see what you can do — it hides commands you don't have permission for.
- Use `hf <group> --help` for the full subcommand list of any group (e.g. `hf task --help`).
- Add `--json` to any command for machine-readable JSON output.
- Resources use **codes** (not numeric IDs) — e.g. `hf task get TASK-42`.

## Authentication

If `pass_mgr` is available (padded-cell mode), authentication is automatic — no flags needed.

Without `pass_mgr` (manual mode), pass `--token <token>` to authenticated commands.

## Command Groups

| Group       | Description                        |
|-------------|------------------------------------|
| `user`      | Manage user accounts               |
| `role`      | Manage roles and permissions       |
| `project`   | Manage projects and members        |
| `milestone` | Manage project milestones          |
| `task`      | Manage and track tasks             |
| `meeting`   | Manage meetings and attendance     |
| `support`   | Manage support tickets             |
| `propose`   | Manage proposals                   |
| `monitor`   | Monitor servers and API keys       |
| `config`    | CLI configuration                  |
| `health`    | API health check                   |
| `version`   | Show CLI version                   |