@loopflowhq/agent-pack

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

Setup

# 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

# 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)

# 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.