featuresflow-track

Track features, bugs, and tasks in FeaturesFlow from any project — via CLI or Claude Code skill.

Quick Start

# 1. Run the setup wizard
npx featuresflow-track init

# 2. Track a feature
npx featuresflow-track add "SSO Google login [high] [feature]"

Setup

Generate an API Key

1. Open FeaturesFlow → Workspace Settings → API Keys
2. Click Generate Key and copy the pml_... key
3. Run npx featuresflow-track init and paste when prompted

The wizard creates:

• .claude/featuresflow-track.json — your API config (add to .gitignore)
• .claude/skills/track/ — Claude Code /track skill (optional)

Manual Config

Create .claude/featuresflow-track.json in your project root:

{
  "apiUrl": "https://zjlgfcmqpdcwqpmpmoxd.supabase.co/functions/v1/track",
  "apiKey": "pml_your_key_here"
}

CLI Usage

# Add a feature (defaults to backlog, medium priority)
featuresflow-track add "Add CSV export"

# Add with tags
featuresflow-track add "Fix login redirect [critical] [bug]"
featuresflow-track add "Refactor auth module [task] @venu"

# Add from JSON
featuresflow-track add --json '{"title": "SSO", "priority": "high", "labels": ["feature"]}'

Tag Syntax

Include tags in square brackets anywhere in the text:

| Tag | Options | |-----|---------| | Priority | [low] [medium] [high] [critical] | | Type | [feature] [bug] [task] [improvement] | | Status | [backlog] [in_progress] [in_review] [done] | | Assignee | @name |

Claude Code Skill

After running npx featuresflow-track init with skill installation, use in any Claude Code session:

/track Add dark mode toggle [high] [feature]
/track Fix broken pagination [critical] [bug]

Requirements

• Node.js 18+ (uses native fetch)
• FeaturesFlow account with API key

License

MIT