HarborForge.OpenclawPlugin/skills/hf/SKILL.md

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

# 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

# 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