workerflow-cli

JSON-based task visualization CLI tool with local web view.

한국어

Installation

npm install -g workerflow-cli

Or from source:

git clone <repo-url>
cd workerflow-cli
npm install
npm run build

Usage

# Read from file
workerflow-cli view --input <json-file>

# Read from stdin
cat <json-file> | workerflow-cli view --stdin

# Custom port
workerflow-cli view --input <json-file> --port 8080

Watch Mode

# Watch file changes and auto-reload
workerflow-cli view --input sample.json --watch
# or
workerflow-cli view -i sample.json -w

# With auto-refresh in browser (no manual reload needed)

JSON Format

{
  "title": "Project Name",
  "tasks": [
    {
      "id": "1",
      "title": "Task Title",
      "status": "TODO|IN_PROGRESS|REVIEW|BLOCKED|DONE",
      "description": "Task description",
      "createdAt": "2026-04-16T10:00:00Z",
      "updatedAt": "2026-04-16T12:00:00Z"
    }
  ]
}

Extended JSON Format

{
  "title": "Project Name",
  "summary": {
    "total": 10,
    "completed": 3,
    "inProgress": 2,
    "blocked": 1
  },
  "tasks": [
    {
      "id": "1",
      "title": "Task Title",
      "status": "TODO",
      "description": "Task description",
      "agent": "@username",
      "priority": "high",
      "tags": ["frontend", "bug"],
      "createdAt": "2026-04-16T10:00:00Z",
      "updatedAt": "2026-04-16T12:00:00Z"
    }
  ]
}

License

MIT