open-index/open-npm huggingface dataset:
npm package: @loopflowhq/agent-pack
Description: One-command installer/updater for LoopFlowHQ-managed agent files, plus a CLI for interacting with the LoopFlowHQ API.
Latest version: 0.11.0

# @loopflowhq/agent-pack

One-command installer/updater for LoopFlowHQ-managed agent files, plus a CLI for interacting with the LoopFlowHQ API.

## Setup

```bash
# Install (or update) agent playbooks into the current repo
npx @loopflowhq/agent-pack@latest install

# Authenticate
npx @loopflowhq/agent-pack@latest auth login
npx @loopflowhq/agent-pack@latest auth status
```

## Commands

```bash
# Projects
npx @loopflowhq/agent-pack@latest projects

# Tickets — list
npx @loopflowhq/agent-pack@latest tickets
npx @loopflowhq/agent-pack@latest tickets --project LOOPF --status in_progress

# Ticket — read
npx @loopflowhq/agent-pack@latest ticket LOOPF-42
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 context
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 messages --limit 20
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 subtasks

# Ticket — create / update
npx @loopflowhq/agent-pack@latest ticket create --project LOOPF --title "Fix login bug" --type bug
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 update --status in_progress --phase implement --phase-state in_progress
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 set-status review --phase implement --phase-state done
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 message "Implementation complete. PR is up."

# Subtasks (structured JSON required)
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 subtasks update \
  --data '[{"title":"Write tests","status":"done"},{"title":"Update docs","status":"in_progress"}]'

# Questions for human review
npx @loopflowhq/agent-pack@latest ticket LOOPF-42 questions \
  --data '[{"question":"Should this be a breaking change?","proposed_answers":["Yes","No"]}]'

# Workflow
npx @loopflowhq/agent-pack@latest next
npx @loopflowhq/agent-pack@latest next --project LOOPF
npx @loopflowhq/agent-pack@latest next child-story LOOPF-10
```

## Global flags

All commands accept:

- `--api-key <key>` (or env: `LOOPFLOWHQ_API_KEY`, `LFHQ_API_KEY`)
- `--base-url <url>` (or env: `LOOPFLOWHQ_BASE_URL`, `LFHQ_BASE_URL`)
- `--json` for raw JSON output

## Advanced (raw API)

```bash
# Call any action directly with a JSON body
npx @loopflowhq/agent-pack@latest run next_best_action --data '{"project_id":"LOOPF"}'

# List all available actions
npx @loopflowhq/agent-pack@latest actions
```

## What `install` writes

- `.cursor/commands/lfq*.md`
- `AGENTS.md`
- `.loopflowhq/` (agent playbooks)
- `.loopflowhq/version.json`

All installed files are marked as LoopFlowHQ-managed and can be updated by rerunning the installer.